Skip to content
23 changes: 16 additions & 7 deletions interface/settings/3d.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -55,17 +55,26 @@ The light settings in this section are used to set the default lighting settings
Change the background color, which can also be adjusted in the canvas.
![Initial Background Color vs Modified](/images/interface/setting/3d/background_color.jpg)

### Initial Preview Visibility
- **Function**: Controls whether the preview screen is displayed by default when creating new 3D components. This default setting can still be toggled individually for each component after creation
- **Default Value**: true (enabled)

![Preview vs hide preview](/images/interface/setting/3d/hide_preview.jpg)


### Initial Grid Visibility
- **Function**: Controls whether the grid is displayed by default when creating new 3D components. This default setting can still be toggled individually for each component after creation
- **Default Value**: true (enabled)

Hide or show the grid on initialization

![Show grid vs hide grid](/images/interface/setting/3d/hide_grid.jpg)


## 3D Viewer

### Enable 3D Viewer (Beta)
- **Setting ID**: `Comfy.Load3D.3DViewerEnable`
- **Type**: boolean
- **Default Value**: false (disabled)
- **Function**: Controls whether the 3D Viewer (Beta) is enabled. When enabled, a button will appear on 3D component nodes that can be clicked to open a full-size 3D viewer

### PLY Engine
- **Setting ID**: `Comfy.Load3D.PLYEngine`
- **Type**: combo
- **Options**: `threejs`, `fastply`, `sparkjs`
- **Default Value**: `threejs`
- **Function**: Selects the engine used to load PLY files. `threejs` uses the native Three.js PLYLoader (best for mesh PLY files), `fastply` uses a loader optimized for ASCII point cloud PLY files, and `sparkjs` uses Spark.js to load 3D Gaussian Splatting PLY files
47 changes: 41 additions & 6 deletions interface/settings/about.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,20 @@ The About page is an information display panel in the ComfyUI settings system, u

The About page displays the following core version information:

- **ComfyUI Version**: Shows the backend ComfyUI version number, linked to the official GitHub repository
- **ComfyUI Version**: Shows the backend ComfyUI version. The format depends on the distribution:
- **OSS (Open Source)**: Displays `ComfyUI <commit hash>`, linked to the main [GitHub repository](https://github.com/Comfy-Org/ComfyUI)
- **Desktop**: Displays `ComfyUI v<version>`, linked to the same GitHub repository
- **Cloud**: Displays `ComfyUI <commit hash>`, linked to [comfy.org](https://www.comfy.org) with a cloud icon
- **ComfyUI_frontend Version**: Shows the frontend interface version number, linked to the frontend GitHub repository
- **Templates Version**: If `systemStats.system.installed_templates_version` is available, a Templates badge is displayed:
- Label: `Templates v<version>`
- Link: [https://pypi.org/project/comfyui-workflow-templates/](https://pypi.org/project/comfyui-workflow-templates/)
- Icon: `pi pi-book`
- If the installed version differs from the required version, the badge appears with a **danger** severity level (red)
- **Discord Community**: Provides a link to the ComfyOrg Discord server
- **Official Website**: Links to the ComfyOrg official website
- **ComfyOrg**: Links to the ComfyOrg official website

The badges are displayed in the following order: ComfyUI → Frontend → Templates (if installed) → Discord → ComfyOrg.

<Tip>
Since the version information here mainly corresponds to stable version information, if you are using the nightly version, the corresponding commit hash will not be displayed here. If you are using the nightly version, you can use the `git log` command in the corresponding ComfyUI main directory to view the corresponding commit hash and other information.
Expand All @@ -33,10 +43,35 @@ If custom nodes are installed, the About page will also display additional badge

### System Info

The bottom of the page displays detailed system statistics, including:
- Hardware configuration information
- Software environment information
- System performance data
The bottom of the page displays detailed system statistics, which vary depending on the distribution:

**OSS / General Version:**
- **OS**: Operating system identifier
- **Python Version**: Installed Python version
- **Embedded Python**: Embedded Python details (if applicable)
- **Pytorch Version**: PyTorch framework version
- **Arguments (argv)**: Command-line arguments used to launch ComfyUI
- **RAM Total**: Total available system RAM
- **RAM Free**: Currently free system RAM
- **Templates Version**: Shown with danger styling if the installed version is outdated

**Cloud Version:**
- **Cloud Version**: Cloud platform version
- **ComfyUI Version**: Backend ComfyUI version
- **Frontend Version**: Frontend interface version
- **Templates Version**: Workflow templates version

**Devices** (displayed when compatible hardware is detected):
- Device name and type (e.g. GPU model)
- **VRAM Total / VRAM Free**: Graphics memory statistics
- **Torch VRAM Total / Torch VRAM Free**: PyTorch-managed VRAM statistics
- Multiple devices are presented in a **TabView**, one tab per device

A **Copy System Info** button is provided at the bottom, which copies all system information in a formatted text block to the clipboard for easy sharing when reporting issues.

### Version Update Notifications

The `ShowVersionUpdates` setting (found under Comfy → Notification Preferences) controls whether version update notifications are shown on the About page and elsewhere in the interface.

## Extension Developer Guide

Expand Down
83 changes: 65 additions & 18 deletions interface/settings/comfy-desktop.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Comfy Desktop General Settings"
description: "Detailed description of ComfyUI Desktop general setting options"
description: "Detailed description of ComfyUI Desktop specific setting options"
icon: "desktop"
sidebarTitle: "Comfy Desktop"
---
Expand All @@ -9,31 +9,78 @@ import SettingsMenuContext from "/snippets/interface/settings-menu-context.mdx"

<SettingsMenuContext />

The Comfy Desktop settings section contains settings that are specific to the ComfyUI Desktop application (Electron-based). These settings are registered by the `Comfy.ElectronAdapter` extension and only appear when running ComfyUI Desktop. Changes to several of these settings require restarting the application to take effect.

## General

### Window Style
**Function**: Controls the title bar style of the application window
- **Setting ID**: `Comfy-Desktop.WindowStyle`
- **Type**: combo
- **Options**: `default`, `custom`
- **Default Value**: `default`
- **Experimental**: Yes
- **Function**: Controls the title bar style of the application window. The `custom` option replaces the system title bar with ComfyUI's built-in Top menu.

### Automatically check for updates
**Function**: Automatically checks for ComfyUI Desktop updates and will remind you to update when updates are available

- **Setting ID**: `Comfy-Desktop.AutoUpdate`
- **Type**: boolean
- **Default Value**: true (enabled)
- **Function**: Automatically checks for ComfyUI Desktop updates and will notify you when updates are available. Changes require a restart to take effect.

### Send anonymous usage metrics
**Function**: Sends anonymous usage statistics to help improve the software. Changes to this setting require a restart to take effect
- **Setting ID**: `Comfy-Desktop.SendStatistics`
- **Type**: boolean
- **Default Value**: true (enabled)
- **Function**: Sends anonymous usage statistics to help improve the software. Changes require a restart to take effect.

## UV (Mirror Settings)

## UV
The UV section provides mirror configuration for users in China and other regions where default download sources may be slow or inaccessible. Use this section to configure alternative download mirrors for Python distributions, pip packages, and PyTorch packages.

All UV settings are of type `url` and support:
- HTTP/HTTPS URLs for remote mirrors
- `file://` URLs for local directory distribution packages
- Automatic reachability validation

This section is mainly for users in China, because many of the original mirrors used by Desktop are outside of China, so access may not be friendly for domestic users. You can set your own mirror sources here to improve access speed and ensure that corresponding packages can be accessed and downloaded normally.

### Python Install Mirror
**Function**:
- Managed Python installation packages are downloaded from the Astral python-build-standalone project
- Can set mirror URL to use different Python installation sources
- The provided URL will replace the default GitHub download address
- Supports using file:// protocol to read distribution packages from local directories
**Validation**: Automatically checks mirror reachability

- **Setting ID**: `Comfy-Desktop.UV.PythonInstallMirror`
- **Type**: url
- **Default Value**: empty string (uses default GitHub source)
- **Tooltip**: Managed Python installations are downloaded from the Astral python-build-standalone project. This variable can be set to a mirror URL to use a different source for Python installations. The provided URL will replace `https://github.com/astral-sh/python-build-standalone/releases/download` in distribution URLs. Distributions can be read from a local directory by using the `file://` URL scheme.
- **Validation**: Automatically checks mirror reachability with a ping suffix

### Pypi Install Mirror
**Function**: Default pip package installation mirror source

- **Setting ID**: `Comfy-Desktop.UV.PypiInstallMirror`
- **Type**: url
- **Default Value**: empty string (uses default pip source)
- **Function**: Default pip package installation mirror source
- **Tooltip**: Default pip install mirror
- **Validation**: Automatically checks mirror reachability

### Torch Install Mirror
**Function**: PyTorch-specific pip installation mirror source
- **Setting ID**: `Comfy-Desktop.UV.TorchInstallMirror`
- **Type**: url
- **Default Value**: empty string (uses default PyTorch source)
- **Function**: PyTorch-specific pip installation mirror source
- **Tooltip**: Pip install mirror for pytorch
- **Validation**: Automatically checks mirror reachability

## Available Commands

In addition to settings, Desktop users have access to the following commands (accessible from the Help menu):

### Open Folders
- **Open Logs Folder** — Opens the ComfyUI Desktop logs folder
- **Open Models Folder** — Opens the models directory
- **Open Outputs Folder** — Opens the outputs directory
- **Open Inputs Folder** — Opens the inputs directory
- **Open Custom Nodes Folder** — Opens the custom nodes directory
- **Open extra_model_paths.yaml** — Opens the model configuration file

### Application Commands
- **Check for Updates** — Manually check for ComfyUI Desktop updates
- **Reinstall** — Reinstall ComfyUI Desktop
- **Restart** — Restart the application
- **Quit** — Quit the application
- **Open DevTools** — Open Chrome Developer Tools
- **Desktop User Guide** — Open the Desktop user guide in a browser
Loading
Loading