Desktop docs drift vs Comfy-Desktop 1.0.38 (copy + screenshots)

[comfyui-wiki]

Summary

Comfy Desktop is currently 1.0.38 (Comfy-Org/Comfy-Desktop). The Mintlify pages under installation/desktop/ still describe an older UI. Several recent user-facing features are missing, some copy is wrong, and most screenshots need a recapture.

Source of truth: Comfy-Org/Comfy-Desktop at tag v1.0.38 (and a few commits after, through 2026-08-14).

Already in progress (do not duplicate): PR #1258 rewrites the startup-logs FAQ, fixes macOS log path (~/Library/Logs/Comfy Desktop), and renames Manage Console → Terminal in copy. Screenshots on those pages are still stale.

---

1. Settings (installation/desktop/usage/settings.mdx)

Preferences copy and screenshot (comfy_desktop_settings_01_preferences.png) are behind current locales/en.json:

• Auto-launch on startup is now a picker (None (show dashboard) / Last used instance), not the toggle Auto-restart last instance on launch.
• Missing: Confirm before closing a window.
• Missing: Warn before running multiple instances (Comfy-Desktop#1394).
• Settings overview card still mentions theme. Theme is forced dark (Comfy-Desktop#1240); drop theme from docs unless the control comes back.

Advanced screenshot (comfy_desktop_settings_04_advanced.png) has no Diagnostics → Open logs folder row. Copy for that is landing in #1258; the screenshot still needs a recapture.

---

2. Manage panel (installation/desktop/usage/manage.mdx)

High-impact missing features (none of these appear in docs or screenshots):

Feature	Source	Docs today
Change PyTorch (official stacks: CUDA / ROCm / XPU / CPU / MPS, nightlies, driver warnings)	Comfy-Desktop#1248, About tab	About tab only lists a static PyTorch version
Manager Security Level + Manager Network Mode on Startup Args	Comfy-Desktop#1041	Not mentioned
Launch Mode options	launchModeWindow / launchModeConsole	Docs say App window or Browser tab. Actual second option is Console only
Instance Storage: split input vs output, per-install extra model dirs	Comfy-Desktop#1376	Still Use Shared Input/Output Folders as one toggle
Terminal tab	comfyUISettings.tabTerminal = Terminal; interactive PTY, not a log viewer	Copy in #1258; screenshots still say Console

Related: installation/desktop/usage/migrate.mdx still says Console in some locales until #1258 lands.

---

3. Dashboard, Cloud, login, templates

• Dashboard screenshots (01-homepage.png, interface_desktop_dashboard.png) have no TRY FREE cloud pill (Comfy-Desktop#1336, relabel Comfy-Desktop#1363).
• Log in moved into the File menu (Comfy-Desktop#1385). Desktop login-code flow (Comfy-Desktop#1303) is undocumented. account/login.mdx covers website login, not Desktop.
• First-use Cloud recommendation for low-GPU hardware (Comfy-Desktop#1299) is undocumented.
• Install-picker API-node starter templates (Comfy-Desktop#1341) are undocumented. Template screenshot (new_install_03_interface_template.png) is likely stale (video-first / Seedance 2.5 / MiniMax H3).
• FAQ still says click Add Installation; Chooser copy is New Install / + New Instance.

---

4. Linux, data locations, uninstall paths

These pages contradict each other and the app:

• installation/desktop/linux.mdx: Linux is not officially supported, build from source.
• installation/desktop/overview.mdx: runs on Debian-based Linux.
• snippets/install/install-link.mdx: no Linux prebuilds, plus it still links Comfy-Org/desktop (legacy repo).
• Comfy-Desktop README documents .deb and AppImage install from the ToDesktop download link.

Need a product call on “official vs community”, then one consistent story.

Windows large-data root (src/main/lib/paths.ts): new installs use %LOCALAPPDATA%\Comfy-Desktop (and a Comfy-Desktop folder on a non-system install drive). Uninstall tables still only list %USERPROFILE%\ComfyUI-Installs and %USERPROFILE%\ComfyUI-Shared. Legacy home-root users keep the old layout.

Linux XDG config uses package name comfyui-desktop-2 (~/.config/comfyui-desktop-2), not ~/.config/Comfy Desktop. Electron app.getPath('logs') still uses productName Comfy Desktop. Data Locations should not treat those as the same folder.

macOS uninstall table (installation/desktop/macos.mdx) still lumps logs into ~/Library/Application Support/Comfy Desktop. App logs live in ~/Library/Logs/Comfy Desktop.

Stale extra-models path (snippets/install/external-models-desktop.mdx) still uses Legacy Desktop ComfyUI app-data paths (AppData\Roaming\ComfyUI, Application Support/ComfyUI).

---

5. License and GitHub links

• Relicensed MIT → AGPL-3.0-or-later + commercial (Comfy-Desktop#1343). Overview/FAQ still say “fully open source” with no license note.
• Many pages still point at the legacy repo github.com/Comfy-Org/desktop:
  • snippets/install/install-link.mdx
  • snippets/install/troubleshooting-feedback.mdx
  • support/contact-support.mdx
  • troubleshooting/overview.mdx
  • troubleshooting/custom-node-issues.mdx
  • (and ja/zh/ko counterparts)

Current issues tracker is Comfy-Org/Comfy-Desktop.

---

6. Screenshot recapture list

Recapture against a current 1.0.38+ build. Prefer generic paths (avoid a real username in the frame). After recapture, update alt text / numbered callouts if the chrome changed (Log in in File menu, Terminal tab, TRY FREE pill).

Must recapture (UI no longer matches)

File	Why
images/desktop/usage/comfy_desktop_settings_01_preferences.png	Auto-launch picker; missing close-confirm and multi-instance warning
images/desktop/usage/comfy_desktop_settings_04_advanced.png	Missing Diagnostics / Open logs folder
images/desktop/usage/instance_settings_02_startup_args.png	Missing Manager Security Level + Network Mode; tab still labeled Console
images/desktop/usage/instance_settings_04_storage.png	Split input/output toggles + per-install model dirs; banner/copy changed
images/desktop/usage/instance_settings_05_console.png	Tab renamed Terminal; still an interactive PTY
images/desktop/usage/instance_settings_05_about.png	Missing Change PyTorch; still shows Console tab
images/desktop/usage/instance_settings_01_update.png	Tab strip still says Console; version badge is old (v0.24.1)
images/desktop/usage/instance_settings_00.png / 03_snapshots.png	Same tab-strip rename
images/desktop/usage/01-homepage.png	Missing TRY FREE / login chrome
images/desktop/interface/interface_desktop_dashboard.png	Same; numbered callouts may need a redraw
images/desktop/usage/new_install_03_interface_template.png	API-node / video-first starters
images/desktop/usage/comfy_desktop_settings_03_storage.png and 03-2_storage.png	Recapture if Storage tab chrome changed with #1376

Likely leftover Legacy Desktop shots (wrong product UI)

These show the old in-app Settings → Comfy-Desktop panel (Window Style, UV mirrors), not Comfy Desktop 2.x:

• images/desktop/comfyui-desktop-update-setting.jpg
• images/desktop/desktop_check_for_updates.jpg
• images/desktop/comfyui-interface.jpg
• images/desktop/desktop_terminal.png (if still referenced)
• images/desktop/extra_model_paths.png (Legacy ComfyUI paths)

Grep for remaining references and replace or delete.

Recapture if chrome drifted

• images/desktop/usage/comfy_desktop_settings_00_menu.png (File menu now includes Log in)
• images/desktop/interface/interface_instance_menu.png / images/desktop/installation/interface_instance_menu.png
• images/desktop/usage/new_install_01_settings_{windows,mac}.png
• Snapshot / track-existing / uninstall shots if the ⋮ menu or tab strip is visible

---

Suggested page-by-page PRs

Work these as separate docs PRs so review stays small:

1. Settings copy + Preferences/Advanced screenshots
2. Manage: PyTorch switch, Manager security/network, Launch Mode, Storage split, Terminal screenshots
3. Dashboard / Cloud / login / templates + homepage screenshots
4. Linux story + Windows/macOS data locations + uninstall tables
5. License note + replace Comfy-Org/desktop links (include snippets/install/install-link.mdx, which is also wrong on Linux prebuilds and “Beta”)

English first, then pnpm translate for ja/zh/ko.