mirror of
https://github.com/Comfy-Org/desktop.git
synced 2026-11-04 23:47:43 +00:00
[GH-ISSUE #1731] [i18n] Entire Electron shell has no translation — tray menu, dialogs, installation wizard, error boxes hardcoded in English #528
Labels
No labels
area: desktop-app
Bounty
bug
bug-cop:answered
bug-cop:response-received
component: installer
component: preload
custom node
dependencies
Design
documentation
duplicate
enhancement
expected
frontend
good first issue
installation
Low-Priority
performance
Planned
platform: cross-platform
platform: windows
Potential Bug
Potential Bug
pull-request
question
refactor
Release
stale
User Support
V1
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
Comfy-Org/desktop#528
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @ghost on GitHub (Jun 4, 2026).
Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1731
Description
The ComfyUI Desktop app has no internationalization (i18n) system at all. Zero files import or use any translation library. Every user-facing string across the entire Electron shell is hardcoded in English. All 15 source files that display UI text need to be migrated.
Below is a comprehensive audit organized by UI area, with exact file paths and line numbers.
1. Tray Icon / System Menu (左上角托盘菜单)
File:
src/main-process/appWindow.ts"Show Comfy Window""Quit Comfy""Hide""About ComfyUI"These appear in the tray icon right-click menu and the native application menu.
2. About Dialog
File:
src/main-process/appWindow.ts"About"(dialog title)"ComfyUI v${version}"(message)"Created by Comfy Org\nCopyright © 2024"(detail)"OK"(button)"ComfyUI"(BrowserWindow title)"ComfyUI"(tray tooltip)"Help"(fallback help menu label)3. Error Dialogs
Multiple files use
dialog.showErrorBox()with hardcoded English:File:
src/main-process/appWindow.ts"User Data","Unknown error whilst writing to user data folder:${path}""Invalid Environment","Unknown error whilst attempting to determine user data folder."File:
src/store/desktopConfig.ts"Invalid configuration file", format error message,"&Reset desktop configuration","Show the &file (and quit)","&Quit""Confirm reset settings", confirmation message,"Show the &file (and quit)","&Yes, delete all settings","&Quit""Delete Failed","Unknown error whilst attempting to delete config file:${path}""User Data","Unknown error whilst attempting to determine user data folder."File:
src/desktopApp.ts"Startup failed","Unknown error whilst loading start screen.${error}""Unhandled exception", full error description"Python Environment Issue","Missing Python Module","Reset Virtual Environment","Ignore""Startup failed","Fatal error occurred during app pre-startup.""Critical error", reinstall messageFile:
src/services/sentry.ts"Send Crash Report","An error occurred: ${type}", error details,"Send Report","Do not send crash report"File:
src/handlers/pathHandlers.ts"Error Opening File","Could not open file: ${path}. Error: ${error}""Invalid ComfyUI source path"File:
src/main.ts"User Data","Unknown error loading app config on startup."4. Installation Wizard Dialogs
File:
src/install/installationManager.ts"Download git","We were unable to find git on this device.","Open git downloads page","Skip""Python Environment Issue","Would you like to remove your .venv directory?","Reinstall venv","Ignore""Virtual Environment Creation Failed","Failed to create virtual environment","View Documentation","Exit""Failed to migrate custom nodes"(notification title + body)"Update NVIDIA Driver", driver version warnings,"OK""Critical Error"File:
src/handlers/AppHandlers.ts"Yes","No","Restart ComfyUI", restart detail,"OK"5. Second Instance / Setup Mode Dialogs
File:
src/main-process/comfyServer.ts"ComfyUI server is already running""Python server failed to start within timeout.""Timeout: Python server did not exit within 10 seconds""Failed to initiate kill signal for python server"File:
src/main-process/comfyDesktopApp.ts"ComfyUI server is already running"6. Virtual Environment / Installation Progress Messages
File:
src/virtualEnvironment.ts"We were unable to verify the state of your Python virtual environment.""Installing PyTorch"(stage message)"Installing ComfyUI requirements"(stage message)"Installing ComfyUI Manager requirements"(stage message)throw new Error(...)with English messages7. Settings / Configuration Labels
File:
src/constants.ts"User Files","Settings and user-created workflows""Models","Reference model files from existing ComfyUI installations.""Custom Nodes","Reinstall custom nodes from existing ComfyUI installations."8. Download Manager Errors
File:
src/models/DownloadManager.ts"Save path is not in models directory""Invalid file type: must be a .safetensors file""Invalid URL format: ${error}"9. Config/Store Errors
File:
src/config/comfySettings.ts"Cannot access ComfySettings before initialization.""Settings are locked and cannot be modified"File:
src/store/desktopConfig.ts"Cannot access store before initialization."Root Cause
The desktop app is an Electron shell with no i18n infrastructure. Unlike the web frontend (which has vue-i18n with 12 languages), the desktop shell was never internationalized. Every dialog, menu, tray tooltip, notification, and error message is hardcoded in English.
Suggested Fix
There is no
i18n.tsequivalent in this codebase — one needs to be created. The Electrondialog.showErrorBox(),Menu.buildFromTemplate(),Tray.setContextMenu(), andNotificationAPIs accept only plain strings, so an Electron-compatible i18n system would need to:src/locales/{lang}/app.jsondialog,Menu,Tray,Notificationcalls with translation function callsSteps to reproduce
constants.tslabels are English)Plugins
N/A
ComfyUI Desktop Version
main
Operating System
Windows (also macOS, Linux)
Terminal
N/A