frontengine 1.0.51__tar.gz → 1.0.52__tar.gz

{frontengine-1.0.51 → frontengine-1.0.52}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.51
+Version: 1.0.52
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine
@@ -185,6 +185,16 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
+## Languages
+
+Seven: English, 繁體中文, 简体中文, Deutsch, Русский, Français, Italiano.
+
+Pick one from the **Language** menu and the interface changes **immediately** —
+no restart. Whatever you had open stays open: overlays keep running, and the
+settings on every page are left exactly as they were.
+
+---
+
 ## Signage, whiteboard and lip-sync
 
 - **Signage mode** (Settings) — rotate through a list of presets on a timer and

{frontengine-1.0.51 → frontengine-1.0.52}/README.md

@@ -161,6 +161,16 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
+## Languages
+
+Seven: English, 繁體中文, 简体中文, Deutsch, Русский, Français, Italiano.
+
+Pick one from the **Language** menu and the interface changes **immediately** —
+no restart. Whatever you had open stays open: overlays keep running, and the
+settings on every page are left exactly as they were.
+
+---
+
 ## Signage, whiteboard and lip-sync
 
 - **Signage mode** (Settings) — rotate through a list of presets on a timer and

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/app_profile_dialog.py

@@ -20,6 +20,7 @@ from frontengine.user_setting.user_setting_file import user_setting_dict, write_
 from frontengine.utils.app_profile.app_profile_service import normalize_profiles
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.smart_pause.pause_rules import normalize_app_name
 
 
@@ -50,13 +51,16 @@ class AppProfileDialog(QDialog):
         self.table.horizontalHeader().setStretchLastSection(True)
 
         self.add_button = QPushButton(_t("app_profile_add", "Add"))
+        retranslator.bind(self.add_button, "app_profile_add", "Add")
         self.add_button.clicked.connect(lambda: self.add_row("", ""))
         self.remove_button = QPushButton(_t("app_profile_remove", "Remove"))
+        retranslator.bind(self.remove_button, "app_profile_remove", "Remove")
         self.remove_button.clicked.connect(self.remove_selected_row)
         self.hint_label = QLabel(
             _t("app_profile_hint",
                "Presets are saved from the Presets menu. Without any saved preset "
                "there is nothing to apply."))
+        retranslator.bind(self.hint_label, "app_profile_hint", "Presets are saved from the Presets menu. Without any saved preset " "there is nothing to apply.")
         self.hint_label.setWordWrap(True)
 
         self.button_box = QDialogButtonBox(

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/clipboard_dialog.py

@@ -25,6 +25,7 @@ from frontengine.user_setting.user_setting_file import user_setting_dict, write_
 from frontengine.utils.clipboard.clipboard_history import ClipboardHistory, preview
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 
 _PIN_MARK = "📌 "
 
@@ -51,16 +52,21 @@ class ClipboardDialog(QDialog):
         self.entry_list.itemDoubleClicked.connect(lambda _item: self.copy_selected())
 
         self.copy_button = QPushButton(_t("clipboard_copy", "Copy"))
+        retranslator.bind(self.copy_button, "clipboard_copy", "Copy")
         self.copy_button.clicked.connect(self.copy_selected)
         self.pin_button = QPushButton(_t("clipboard_pin", "Pin / unpin"))
+        retranslator.bind(self.pin_button, "clipboard_pin", "Pin / unpin")
         self.pin_button.clicked.connect(self.toggle_pin_selected)
         self.remove_button = QPushButton(_t("clipboard_remove", "Remove"))
+        retranslator.bind(self.remove_button, "clipboard_remove", "Remove")
         self.remove_button.clicked.connect(self.remove_selected)
         self.clear_button = QPushButton(_t("clipboard_clear", "Clear (keep pinned)"))
+        retranslator.bind(self.clear_button, "clipboard_clear", "Clear (keep pinned)")
         self.clear_button.clicked.connect(self.clear_history)
 
         self.persist_checkbox = QCheckBox(
             _t("clipboard_persist", "Keep this history between sessions"))
+        retranslator.bind(self.persist_checkbox, "clipboard_persist", "Keep this history between sessions")
         self.persist_checkbox.setChecked(bool(user_setting_dict.get("clipboard_persist")))
         self.persist_checkbox.toggled.connect(self._store_persist)
         self.hint_label = QLabel(
@@ -68,6 +74,7 @@ class ClipboardDialog(QDialog):
                "History stays on this machine and is never sent anywhere. Unless you tick "
                "the box above it is kept in memory only, because clipboards often hold "
                "passwords."))
+        retranslator.bind(self.hint_label, "clipboard_hint", "History stays on this machine and is never sent anywhere. Unless you tick " "the box above it is kept in memory only, because clipboards often hold " "passwords.")
         self.hint_label.setWordWrap(True)
 
         self.button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Close)

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/reminder_dialog.py

@@ -19,6 +19,7 @@ from PySide6.QtWidgets import (
 from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.reminder.reminder_service import (
     KIND_AT, KIND_EVERY, normalize_reminder, normalize_reminders,
 )
@@ -55,13 +56,16 @@ class ReminderDialog(QDialog):
         self.table.horizontalHeader().setStretchLastSection(True)
 
         self.add_button = QPushButton(_t("reminder_add", "Add"))
+        retranslator.bind(self.add_button, "reminder_add", "Add")
         self.add_button.clicked.connect(lambda: self.add_row())
         self.remove_button = QPushButton(_t("reminder_remove", "Remove"))
+        retranslator.bind(self.remove_button, "reminder_remove", "Remove")
         self.remove_button.clicked.connect(self.remove_selected_row)
         self.hint_label = QLabel(
             _t("reminder_hint",
                "Tick a row to keep it active. \"Every\" takes minutes, \"At\" takes a "
                "24-hour time such as 14:30."))
+        retranslator.bind(self.hint_label, "reminder_hint", "Tick a row to keep it active. \"Every\" takes minutes, \"At\" takes a " "24-hour time such as 14:30.")
         self.hint_label.setWordWrap(True)
 
         self.button_box = QDialogButtonBox(

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/remote_control_dialog.py

@@ -24,6 +24,7 @@ from frontengine.user_setting.user_setting_file import user_setting_dict, write_
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.midi.midi_input import available as midi_available, list_devices
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.remote.remote_server import ALLOWED_ACTIONS
 
 MIDI_KEY = "midi_bindings"
@@ -60,6 +61,7 @@ class RemoteControlDialog(QDialog):
         self._learning = False
 
         self.remote_checkbox = QCheckBox(_t("remote_enable", "Let my phone control FrontEngine"))
+        retranslator.bind(self.remote_checkbox, "remote_enable", "Let my phone control FrontEngine")
         self.remote_checkbox.setChecked(remote_enabled())
         self.remote_checkbox.toggled.connect(self._toggle_remote)
         self.remote_url_label = QLabel(self.remote_status())
@@ -67,6 +69,7 @@ class RemoteControlDialog(QDialog):
         self.remote_url_label.setTextInteractionFlags(
             self.remote_url_label.textInteractionFlags().TextSelectableByMouse)
         self.remote_copy_button = QPushButton(_t("remote_copy", "Copy link"))
+        retranslator.bind(self.remote_copy_button, "remote_copy", "Copy link")
         self.remote_copy_button.clicked.connect(self.copy_link)
         self.remote_hint = QLabel(
             _t("remote_hint",
@@ -75,18 +78,22 @@ class RemoteControlDialog(QDialog):
                "page can be triggered - nothing else. It is plain HTTP, so treat it like any "
                "other device on your network: someone else on the same network could read the "
                "token and press the same buttons. Leave it off on networks you do not trust."))
+        retranslator.bind(self.remote_hint, "remote_hint", "This opens a port on this machine for your local network. The link carries a " "one-time token that changes every time it starts, and only the buttons on the " "page can be triggered - nothing else. It is plain HTTP, so treat it like any " "other device on your network: someone else on the same network could read the " "token and press the same buttons. Leave it off on networks you do not trust.")
         self.remote_hint.setWordWrap(True)
 
         self.midi_label = QLabel(_t("remote_midi_label", "MIDI controller"))
+        retranslator.bind(self.midi_label, "remote_midi_label", "MIDI controller")
         self.midi_combobox = QComboBox()
         for index, name in list_devices():
             self.midi_combobox.addItem(name, index)
         if self.midi_combobox.count() == 0:
             self.midi_combobox.addItem(_t("remote_midi_none", "No MIDI device found"), -1)
         self.learn_button = QPushButton(_t("remote_midi_learn", "Learn"))
+        retranslator.bind(self.learn_button, "remote_midi_learn", "Learn")
         self.learn_button.clicked.connect(self.start_learning)
         self.learn_button.setEnabled(midi_available())
         self.remove_button = QPushButton(_t("remote_midi_remove", "Remove"))
+        retranslator.bind(self.remove_button, "remote_midi_remove", "Remove")
         self.remove_button.clicked.connect(self.remove_selected)
 
         self.table = QTableWidget(0, 2)

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/screen_privacy_dialog.py

@@ -22,6 +22,7 @@ from PySide6.QtWidgets import (
 from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.screen_privacy import capture_affinity
 from frontengine.utils.screen_privacy.share_watch import DEFAULT_SHARING_APPS
 from frontengine.utils.smart_pause.pause_rules import parse_app_list
@@ -55,18 +56,25 @@ class ScreenPrivacyDialog(QDialog):
 
         self.enable_checkbox = QCheckBox(
             _t("screen_privacy_enable", "Hide overlays while one of these apps is open"))
+        retranslator.bind(self.enable_checkbox, "screen_privacy_enable", "Hide overlays while one of these apps is open")
         self.enable_checkbox.setChecked(bool(settings.get("enabled")))
         self.apps_label = QLabel(_t("screen_privacy_apps_label", "Meeting and capture apps:"))
+        retranslator.bind(self.apps_label, "screen_privacy_apps_label", "Meeting and capture apps:")
         self.apps_edit = QLineEdit(", ".join(settings.get("apps", [])))
         self.apps_edit.setPlaceholderText("zoom, teams, discord")
-        self.hint_label = QLabel(
-            _t("screen_privacy_hint",
-               "Matched against window titles, so a meeting held in a browser tab is caught "
-               "too. Your overlays stay on your own screen - only the capture is blank. "
-               "Masks stay visible, since covering something is what they are for.")
+        # 提示句取決於平台支不支援，登記的必須是實際選到的那個鍵
+        # The hint depends on whether the platform supports this, so register
+        # whichever key was actually chosen.
+        hint_key, hint_fallback = (
+            ("screen_privacy_hint",
+             "Matched against window titles, so a meeting held in a browser tab is caught "
+             "too. Your overlays stay on your own screen - only the capture is blank. "
+             "Masks stay visible, since covering something is what they are for.")
             if capture_affinity.available() else
-            _t("screen_privacy_unsupported",
-               "Hiding overlays from screen capture is Windows only."))
+            ("screen_privacy_unsupported",
+             "Hiding overlays from screen capture is Windows only."))
+        self.hint_label = QLabel(_t(hint_key, hint_fallback))
+        retranslator.bind(self.hint_label, hint_key, hint_fallback)
         self.hint_label.setWordWrap(True)
 
         self.button_box = QDialogButtonBox(

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/screen_text_dialog.py

@@ -24,6 +24,7 @@ from PySide6.QtWidgets import (
 from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.screen_text.screen_text_service import API_KEY_ENV, api_key
 
 CONSENT_KEY = "screen_text_consent"
@@ -78,9 +79,11 @@ class ScreenTextDialog(QDialog):
         self.text_edit = QPlainTextEdit(str(text))
         self.text_edit.setReadOnly(False)
         self.copy_button = QPushButton(_t("screen_text_copy", "Copy"))
+        retranslator.bind(self.copy_button, "screen_text_copy", "Copy")
         self.copy_button.clicked.connect(self.copy_text)
         self.consent_checkbox = QCheckBox(
             _t("screen_text_consent_toggle", "Allow sending captures to Anthropic"))
+        retranslator.bind(self.consent_checkbox, "screen_text_consent_toggle", "Allow sending captures to Anthropic")
         self.consent_checkbox.setChecked(has_consent())
         self.consent_checkbox.toggled.connect(set_consent)
         self.hint_label = QLabel(self.status_text())

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/signage_dialog.py

@@ -15,6 +15,7 @@ from PySide6.QtWidgets import (
 from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.signage.signage_service import (
     DEFAULT_INTERVAL_MINUTES, MAX_INTERVAL_MINUTES, MIN_INTERVAL_MINUTES, clamp_interval,
     normalize_playlist,
@@ -52,20 +53,25 @@ class SignageDialog(QDialog):
         settings = current_settings()
 
         self.enable_checkbox = QCheckBox(_t("signage_enable", "Rotate presets"))
+        retranslator.bind(self.enable_checkbox, "signage_enable", "Rotate presets")
         self.enable_checkbox.setChecked(bool(settings.get("enabled")))
         self.presets_label = QLabel(_t("signage_presets_label", "Presets, one per line:"))
+        retranslator.bind(self.presets_label, "signage_presets_label", "Presets, one per line:")
         self.presets_edit = QPlainTextEdit("\n".join(settings.get("presets", [])))
         self.interval_label = QLabel(_t("signage_interval_label", "Change every (minutes)"))
+        retranslator.bind(self.interval_label, "signage_interval_label", "Change every (minutes)")
         self.interval_spinbox = QSpinBox()
         self.interval_spinbox.setRange(MIN_INTERVAL_MINUTES, MAX_INTERVAL_MINUTES)
         self.interval_spinbox.setValue(settings.get("interval_minutes"))
         self.hide_checkbox = QCheckBox(
             _t("signage_hide_window", "Hide the main window while rotating"))
+        retranslator.bind(self.hide_checkbox, "signage_hide_window", "Hide the main window while rotating")
         self.hide_checkbox.setChecked(bool(settings.get("hide_window", True)))
         self.hint_label = QLabel(
             _t("signage_hint",
                "Presets are saved from the Presets menu. The rotation wraps at the end, so a "
                "machine left running keeps cycling."))
+        retranslator.bind(self.hint_label, "signage_hint", "Presets are saved from the Presets menu. The rotation wraps at the end, so a " "machine left running keeps cycling.")
         self.hint_label.setWordWrap(True)
 
         self.button_box = QDialogButtonBox(

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/smart_pause_dialog.py

@@ -16,6 +16,7 @@ from PySide6.QtWidgets import (
 from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.smart_pause.pause_rules import DEFAULT_RULES, parse_app_list
 
 
@@ -44,17 +45,21 @@ class SmartPauseDialog(QDialog):
 
         self.fullscreen_checkbox = QCheckBox(
             _t("smart_pause_fullscreen", "Pause while a fullscreen app is running"))
+        retranslator.bind(self.fullscreen_checkbox, "smart_pause_fullscreen", "Pause while a fullscreen app is running")
         self.fullscreen_checkbox.setChecked(bool(rules.get("fullscreen", True)))
         self.battery_checkbox = QCheckBox(
             _t("smart_pause_battery", "Pause while running on battery"))
+        retranslator.bind(self.battery_checkbox, "smart_pause_battery", "Pause while running on battery")
         self.battery_checkbox.setChecked(bool(rules.get("battery", False)))
         self.apps_label = QLabel(
             _t("smart_pause_apps_label", "Pause while these apps have focus:"))
+        retranslator.bind(self.apps_label, "smart_pause_apps_label", "Pause while these apps have focus:")
         self.apps_edit = QLineEdit(", ".join(rules.get("apps", [])))
         self.apps_edit.setPlaceholderText("photoshop, premiere, blender")
         self.hint_label = QLabel(
             _t("smart_pause_hint",
                "Names are matched without the folder or .exe, so \"photoshop\" is enough."))
+        retranslator.bind(self.hint_label, "smart_pause_hint", "Names are matched without the folder or .exe, so \"photoshop\" is enough.")
         self.hint_label.setWordWrap(True)
 
         self.button_box = QDialogButtonBox(

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/usage_report_dialog.py

@@ -20,6 +20,7 @@ from PySide6.QtWidgets import (
 
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.usage_tracking.usage_tracker import UsageTracker, format_duration
 
 
@@ -47,6 +48,7 @@ class UsageReportDialog(QDialog):
         self._on_clear = on_clear
 
         self.enable_checkbox = QCheckBox(_t("usage_enable", "Track which apps I use"))
+        retranslator.bind(self.enable_checkbox, "usage_enable", "Track which apps I use")
         self.enable_checkbox.setChecked(bool(enabled))
         self.enable_checkbox.toggled.connect(self._toggle)
 
@@ -64,13 +66,16 @@ class UsageReportDialog(QDialog):
         self.week_label = QLabel()
         self.week_label.setWordWrap(True)
         self.refresh_button = QPushButton(_t("usage_refresh", "Refresh"))
+        retranslator.bind(self.refresh_button, "usage_refresh", "Refresh")
         self.refresh_button.clicked.connect(self.reload_report)
         self.clear_button = QPushButton(_t("usage_clear", "Clear history"))
+        retranslator.bind(self.clear_button, "usage_clear", "Clear history")
         self.clear_button.clicked.connect(self.clear_history)
         self.hint_label = QLabel(
             _t("usage_hint",
                "This is stored on this machine only and is never sent anywhere. "
                "Clearing deletes the file itself."))
+        retranslator.bind(self.hint_label, "usage_hint", "This is stored on this machine only and is never sent anywhere. " "Clearing deletes the file itself.")
         self.hint_label.setWordWrap(True)
 
         self.button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Close)

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/dialog/window_pin_dialog.py

@@ -17,6 +17,7 @@ from PySide6.QtWidgets import (
 
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 from frontengine.utils.window_pin import window_pin
 
 
@@ -37,25 +38,31 @@ class WindowPinDialog(QDialog):
         self.window_list = QListWidget()
         self.window_list.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
         self.refresh_button = QPushButton(_t("window_pin_refresh", "Refresh"))
+        retranslator.bind(self.refresh_button, "window_pin_refresh", "Refresh")
         self.refresh_button.clicked.connect(self.reload_windows)
         self.pin_button = QPushButton(_t("window_pin_pin", "Keep on top"))
+        retranslator.bind(self.pin_button, "window_pin_pin", "Keep on top")
         self.pin_button.clicked.connect(lambda: self.apply_pin(True))
         self.unpin_button = QPushButton(_t("window_pin_unpin", "Release"))
+        retranslator.bind(self.unpin_button, "window_pin_unpin", "Release")
         self.unpin_button.clicked.connect(lambda: self.apply_pin(False))
 
         self.opacity_label = QLabel(_t("window_pin_opacity", "Opacity"))
+        retranslator.bind(self.opacity_label, "window_pin_opacity", "Opacity")
         self.opacity_slider = QSlider(Qt.Orientation.Horizontal)
         self.opacity_slider.setRange(window_pin.MIN_OPACITY_PERCENT,
                                      window_pin.MAX_OPACITY_PERCENT)
         self.opacity_slider.setValue(window_pin.MAX_OPACITY_PERCENT)
         self.opacity_slider.valueChanged.connect(self.apply_opacity)
 
-        self.hint_label = QLabel(
-            _t("window_pin_hint",
-               "Pinning changes how a window is stacked and how see-through it is. "
-               "Windows only - other systems do not allow it.")
+        hint_key, hint_fallback = (
+            ("window_pin_hint",
+             "Pinning changes how a window is stacked and how see-through it is. "
+             "Windows only - other systems do not allow it.")
             if window_pin.available() else
-            _t("window_pin_unsupported", "Pinning other windows is Windows only."))
+            ("window_pin_unsupported", "Pinning other windows is Windows only."))
+        self.hint_label = QLabel(_t(hint_key, hint_fallback))
+        retranslator.bind(self.hint_label, hint_key, hint_fallback)
         self.hint_label.setWordWrap(True)
 
         self.button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Close)

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/main_ui.py

@@ -46,6 +46,7 @@ from frontengine.utils.critical_exit.win32_vk import keyboard_keys_table
 from frontengine.utils.hotkey.hotkey_service import HotkeyService
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator, translate
 from frontengine.utils.plugins.plugin_loader import load_plugins
 from frontengine.utils.preset_schedule.preset_schedule_service import PresetScheduleService
 from frontengine.ui.dialog.remote_control_dialog import (
@@ -382,8 +383,11 @@ class FrontEngineMainUI(QMainWindow):
             (self.control_center_ui, "tab_control_center_text"),
         ]
 
-        for widget, lang_key in tabs:
-            self.tab_widget.addTab(widget, language_wrapper.language_word_dict.get(lang_key))
+        for index, (widget, lang_key) in enumerate(tabs):
+            self.tab_widget.addTab(widget, translate(lang_key))
+            # setTabText 需要索引，所以索引跟著這筆登記一起記下來
+            # setTabText needs the index, so it travels with the entry.
+            retranslator.bind(self.tab_widget, lang_key, "", "setTabText", index)
 
         # 加入外部擴充 Tab
         # Add external extension tabs
@@ -442,6 +446,18 @@ class FrontEngineMainUI(QMainWindow):
         except Exception as error:
             front_engine_logger.warning(f"[FrontEngineMainUI] save geometry failed: {error!r}")
 
+    def retranslate(self) -> int:
+        """
+        用目前語言把畫面上的文字重寫一遍，回傳重寫了幾條。
+        換語言不必重開程式，所以開著的覆蓋層與各分頁的設定都留在原地。
+        Rewrite the interface in the current language and return how many
+        strings were rewritten. Changing language needs no restart, so open
+        overlays and the settings on every page stay exactly where they are.
+        """
+        applied = retranslator.apply()
+        front_engine_logger.info(f"[FrontEngineMainUI] retranslate | {applied} strings")
+        return applied
+
     def set_style(self) -> None:
         """更新使用者選擇的主題 / Update user-selected theme"""
         user_setting_dict.update({"theme": self.sender().text()})

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/menu/help_menu.py

@@ -8,6 +8,7 @@ from PySide6.QtWidgets import QMessageBox
 from frontengine.utils.browser.browser import open_browser
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator, translate
 
 if TYPE_CHECKING:
     from frontengine.ui.main_ui import FrontEngineMainUI
@@ -20,31 +21,32 @@ def build_help_menu(ui_we_want_to_set: FrontEngineMainUI) -> None:
     """
     front_engine_logger.info(f"[HelpMenu] build_help_menu | ui={ui_we_want_to_set}")
 
-    help_menu = ui_we_want_to_set.menu_bar.addMenu(
-        language_wrapper.language_word_dict.get("help_menu_label")
-    )
+    help_menu = ui_we_want_to_set.menu_bar.addMenu(translate("help_menu_label", "Help menu"))
+    retranslator.bind(help_menu, "help_menu_label", "Help menu", "setTitle")
     ui_we_want_to_set.help_menu = help_menu
 
     # --- 建立動作 / Create actions ---
     _add_action(
         help_menu,
-        language_wrapper.language_word_dict.get("help_menu_open_issue"),
+        "help_menu_open_issue",
         lambda: open_browser("https://github.com/Integration-Automation/FrontEngine/issues")
     )
 
     _add_action(
         help_menu,
-        language_wrapper.language_word_dict.get("how_to_critical_exit_action"),
+        "how_to_critical_exit_action",
         lambda: how_to_critical_exit(ui_we_want_to_set)
     )
 
 
-def _add_action(menu, label: str, callback) -> QAction:
+def _add_action(menu, key: str, callback, fallback: str = "") -> QAction:
     """
-    建立 QAction 並加入選單
-    Create a QAction and add it to the menu
+    建立 QAction 並加入選單，同時記住它的文字來自哪個鍵，換語言時才跟得上。
+    Create a QAction, add it to the menu, and remember which key its text came
+    from so a language change reaches it.
     """
-    action = QAction(label, menu)
+    action = QAction(translate(key, fallback), menu)
+    retranslator.bind(action, key, fallback)
     action.triggered.connect(callback)
     menu.addAction(action)
     return action

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/menu/how_to_menu.py

@@ -6,7 +6,7 @@ from PySide6.QtGui import QAction
 
 from frontengine.utils.browser.browser import open_browser
 from frontengine.utils.logging.loggin_instance import front_engine_logger
-from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator, translate
 
 if TYPE_CHECKING:
     from frontengine.ui.main_ui import FrontEngineMainUI
@@ -20,25 +20,25 @@ def build_how_to_menu(ui_we_want_to_set: FrontEngineMainUI) -> None:
     front_engine_logger.info(f"[HowToMenu] build_how_to_menu | ui={ui_we_want_to_set}")
 
     # 建立選單 / Create menu
-    how_to_menu = ui_we_want_to_set.menu_bar.addMenu(
-        language_wrapper.language_word_dict.get("doc_menu_label")
-    )
+    how_to_menu = ui_we_want_to_set.menu_bar.addMenu(translate("doc_menu_label", "Doc menu"))
+    retranslator.bind(how_to_menu, "doc_menu_label", "Doc menu", "setTitle")
     ui_we_want_to_set.how_to_menu = how_to_menu
 
     # 建立「開啟文件」動作 / Create "Open Documentation" action
     _add_action(
         how_to_menu,
-        language_wrapper.language_word_dict.get("doc_menu_open_doc"),
+        "doc_menu_open_doc",
         lambda: open_browser("https://frontengine.readthedocs.io/en/latest/")
     )
 
 
-def _add_action(menu, label: str, callback) -> QAction:
+def _add_action(menu, key: str, callback, fallback: str = "") -> QAction:
     """
-    建立 QAction 並加入選單
-    Create a QAction and add it to the menu
+    建立 QAction 並加入選單，同時記住它的文字來自哪個鍵。
+    Create a QAction, add it to the menu, and remember the key behind its text.
     """
-    action = QAction(label, menu)
+    action = QAction(translate(key, fallback), menu)
+    retranslator.bind(action, key, fallback)
     action.triggered.connect(callback)
     menu.addAction(action)
     return action

frontengine-1.0.52/frontengine/ui/menu/language_menu.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Tuple
+
+from PySide6.QtGui import QAction
+
+from frontengine.user_setting.user_setting_file import user_setting_dict
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator, translate
+
+if TYPE_CHECKING:
+    from frontengine.ui.main_ui import FrontEngineMainUI
+
+# (顯示用的鍵, 語言代碼)。代碼必須是 language_wrapper 註冊過的名字——這裡原本寫
+# "French" / "Italian"，而註冊的是 "France" / "Italy"，reset_language() 找不到就
+# 默默 return，所以那兩個選項按下去完全沒有反應。
+# (label key, language code). The code must be a name language_wrapper
+# registered: this list used to say "French" / "Italian" while the registry
+# said "France" / "Italy", and reset_language() returns quietly on a name it
+# does not know - so those two entries did nothing at all.
+LANGUAGES: List[Tuple[str, str]] = [
+    ("language_menu_bar_english", "English"),
+    ("language_menu_bar_traditional_chinese", "Traditional_Chinese"),
+    ("language_menu_bar_simplified_chinese", "Simplified_Chinese"),
+    ("language_menu_bar_germany", "Deutsch"),
+    ("language_menu_bar_russian", "Russian"),
+    ("language_menu_bar_french", "France"),
+    ("language_menu_bar_italian", "Italy"),
+]
+
+
+def build_language_menu(ui_we_want_to_set: FrontEngineMainUI) -> None:
+    """
+    建立語言選單
+    Build the language menu for the main UI
+    """
+    front_engine_logger.info(f"[LanguageMenu] build_language_menu | ui={ui_we_want_to_set}")
+
+    language_menu = ui_we_want_to_set.menu_bar.addMenu(translate("menu_bar_language", "Language"))
+    retranslator.bind(language_menu, "menu_bar_language", "Language", "setTitle")
+    ui_we_want_to_set.language_menu = language_menu
+
+    for label_key, language_code in LANGUAGES:
+        action = QAction(translate(label_key, language_code), language_menu)
+        retranslator.bind(action, label_key, language_code)
+        action.triggered.connect(
+            lambda _, code=language_code: set_language(code, ui_we_want_to_set))
+        language_menu.addAction(action)
+
+
+def set_language(language: str, ui_we_want_to_set: FrontEngineMainUI) -> bool:
+    """
+    切換語言並立刻重寫畫面上的文字，不必重新啟動。
+    回傳是否真的換成功（語言代碼不認得就是 False）。
+    Switch language and rewrite the interface immediately - no restart needed.
+    Returns whether the switch actually happened; an unknown code gives False.
+    """
+    front_engine_logger.info(f"[LanguageMenu] set_language | language={language}")
+    if not language_wrapper.reset_language(language):
+        return False
+    user_setting_dict.update({"language": language})
+    ui_we_want_to_set.retranslate()
+    return True

{frontengine-1.0.51 → frontengine-1.0.52}/frontengine/ui/menu/preset_menu.py

@@ -13,6 +13,7 @@ from frontengine.utils.workshop.workshop_content import (
 from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.multi_language.retranslate import retranslator
 
 if TYPE_CHECKING:
     from frontengine.ui.main_ui import FrontEngineMainUI
@@ -365,6 +366,7 @@ def build_preset_menu(ui: "FrontEngineMainUI") -> None:
     """
     front_engine_logger.info(f"[PresetMenu] build_preset_menu | ui={ui}")
     menu = ui.menu_bar.addMenu(_t("menu_bar_presets", "Presets"))
+    retranslator.bind(menu, "menu_bar_presets", "Presets", "setTitle")
     ui.preset_menu = menu
 
     for label_key, fallback, callback_factory in (
@@ -380,5 +382,6 @@ def build_preset_menu(ui: "FrontEngineMainUI") -> None:
         ("workshop_menu_import", "Import Workshop content...", _workshop_action),
     ):
         action = QAction(_t(label_key, fallback), menu)
+        retranslator.bind(action, label_key, fallback)
         action.triggered.connect(callback_factory(ui))
         menu.addAction(action)