prkit 0.2.1__tar.gz → 0.3.0__tar.gz

{prkit-0.2.1 → prkit-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: prkit
-Version: 0.2.1
+Version: 0.3.0
 Summary: A cross-platform system-tray presentation toolkit
 Author: meebox
 Author-email: meebox <meebox@gmail.com>
@@ -36,14 +36,16 @@ Description-Content-Type: text/markdown
 
 | 平台 | 下載檔案 | 啟動方式 |
 | --- | --- | --- |
-| Windows x64 | `PRKit-0.2.1-windows-x64.exe` | 直接開啟執行 |
-| macOS Apple Silicon | `PRKit-0.2.1-macos-arm64.dmg` | 開啟 DMG，將 `PRKit.app` 拖到「Applications」捷徑後啟動 |
+| Windows x64 | `PRKit-0.3.0-windows-x64.exe` | 直接開啟執行 |
+| macOS Apple Silicon | `PRKit-0.3.0-macos-arm64.dmg` | 開啟 DMG，將 `PRKit.app` 拖到「Applications」捷徑後啟動 |
 
 Windows 為單一 EXE，已包含執行環境與游標復原 watchdog，不需額外下載檔案。macOS 目前僅提供 Apple Silicon 版。程式啟動後顯示在系統匣／選單列，不會開啟主視窗。
 
+系統匣選單中的「開機自動啟動」會在目前使用者登入時啟動程式，取消勾選即可移除。語言按鈕依序切換地球（隨系統）、「中」（中文）和「En」（英文）；切換會立即生效並保存。
+
 桌面版尚未使用 Windows 發行者憑證或 Apple Developer ID 簽署／公證；macOS 僅使用 ad-hoc 簽章。若系統阻擋你確認來源的下載檔案，請依系統安全提示允許開啟。macOS 按鍵顯示仍需在「輸入監控」允許 `PRKit`；輸入法狀態模式不需此權限。每個下載檔另提供 `.sha256` 校驗檔。
 
-版本標籤會自動觸發 GitHub 雲端打包與成品測試；手動建置可在 Actions 的 **Build desktop apps** 執行，成品在該次執行的 Artifacts。詳細操作見[發佈指南](docs/RELEASING.md)。
+版本標籤會自動觸發 GitHub 雲端桌面打包、成品測試與 PyPI 發佈；手動桌面建置可在 Actions 的 **Build desktop apps** 執行，成品在該次執行的 Artifacts。詳細操作見[發佈指南](docs/RELEASING.md)。
 
 ## 從 PyPI 安裝
 
@@ -68,7 +70,7 @@ uv tool install git+https://github.com/codemee/prkit.git@latest
 prkit
 ```
 
-若要固定特定版本，將 `latest` 改成版本標籤，例如 `v0.2.1`。
+若要固定特定版本，將 `latest` 改成版本標籤，例如 `v0.3.0`。
 
 若安裝後找不到 `prkit` 指令，執行 `uv tool update-shell`，再重新開啟終端機。移除工具可使用 `uv tool uninstall prkit`。
 

{prkit-0.2.1 → prkit-0.3.0}/README.md

@@ -19,14 +19,16 @@
 
 | 平台 | 下載檔案 | 啟動方式 |
 | --- | --- | --- |
-| Windows x64 | `PRKit-0.2.1-windows-x64.exe` | 直接開啟執行 |
-| macOS Apple Silicon | `PRKit-0.2.1-macos-arm64.dmg` | 開啟 DMG，將 `PRKit.app` 拖到「Applications」捷徑後啟動 |
+| Windows x64 | `PRKit-0.3.0-windows-x64.exe` | 直接開啟執行 |
+| macOS Apple Silicon | `PRKit-0.3.0-macos-arm64.dmg` | 開啟 DMG，將 `PRKit.app` 拖到「Applications」捷徑後啟動 |
 
 Windows 為單一 EXE，已包含執行環境與游標復原 watchdog，不需額外下載檔案。macOS 目前僅提供 Apple Silicon 版。程式啟動後顯示在系統匣／選單列，不會開啟主視窗。
 
+系統匣選單中的「開機自動啟動」會在目前使用者登入時啟動程式，取消勾選即可移除。語言按鈕依序切換地球（隨系統）、「中」（中文）和「En」（英文）；切換會立即生效並保存。
+
 桌面版尚未使用 Windows 發行者憑證或 Apple Developer ID 簽署／公證；macOS 僅使用 ad-hoc 簽章。若系統阻擋你確認來源的下載檔案，請依系統安全提示允許開啟。macOS 按鍵顯示仍需在「輸入監控」允許 `PRKit`；輸入法狀態模式不需此權限。每個下載檔另提供 `.sha256` 校驗檔。
 
-版本標籤會自動觸發 GitHub 雲端打包與成品測試；手動建置可在 Actions 的 **Build desktop apps** 執行，成品在該次執行的 Artifacts。詳細操作見[發佈指南](docs/RELEASING.md)。
+版本標籤會自動觸發 GitHub 雲端桌面打包、成品測試與 PyPI 發佈；手動桌面建置可在 Actions 的 **Build desktop apps** 執行，成品在該次執行的 Artifacts。詳細操作見[發佈指南](docs/RELEASING.md)。
 
 ## 從 PyPI 安裝
 
@@ -51,7 +53,7 @@ uv tool install git+https://github.com/codemee/prkit.git@latest
 prkit
 ```
 
-若要固定特定版本，將 `latest` 改成版本標籤，例如 `v0.2.1`。
+若要固定特定版本，將 `latest` 改成版本標籤，例如 `v0.3.0`。
 
 若安裝後找不到 `prkit` 指令，執行 `uv tool update-shell`，再重新開啟終端機。移除工具可使用 `uv tool uninstall prkit`。
 

{prkit-0.2.1 → prkit-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "prkit"
-version = "0.2.1"
+version = "0.3.0"
 description = "A cross-platform system-tray presentation toolkit"
 readme = "README.md"
 requires-python = ">=3.12"

{prkit-0.2.1 → prkit-0.3.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "prkit"
-version = "0.2.1"
+version = "0.3.0"
 description = "A cross-platform system-tray presentation toolkit"
 readme = "README.md"
 authors = [

{prkit-0.2.1 → prkit-0.3.0}/src/prkit/__init__.py

@@ -1,3 +1,3 @@
 """Presentation tools for the system tray."""
 
-__version__ = "0.2.1"
+__version__ = "0.3.0"

{prkit-0.2.1 → prkit-0.3.0}/src/prkit/app.py

@@ -7,9 +7,11 @@ from contextlib import suppress
 from PySide6.QtCore import QObject, QSignalBlocker, QTimer
 from PySide6.QtWidgets import QApplication, QMessageBox
 
+from prkit import autostart
 from prkit.capslock import CapsLockMonitor
 from prkit.input_source import InputSourceMonitor
 from prkit.keyboard import KeyboardMonitor
+from prkit.language import effective_language, tr
 from prkit.overlays import CapsLockOverlay, KeystrokeOverlay
 from prkit.settings import SettingsStore, SettingsStoreProtocol
 from prkit.spotlight import SpotlightBackend, create_spotlight
@@ -33,6 +35,9 @@ class AppController(QObject):
         self.spotlight = spotlight or create_spotlight(self.settings.spotlight)
         self.keystroke = KeystrokeOverlay(self.settings.keystroke)
         self.capslock = CapsLockOverlay(self.settings.capslock)
+        self.capslock.setToolTip(
+            tr("拖曳以移動狀態提示", effective_language(self.settings.language))
+        )
         self.capslock_monitor = capslock_monitor or CapsLockMonitor(self)
         self.input_source_monitor = input_source_monitor or InputSourceMonitor(self)
         if sys.platform != "darwin":
@@ -52,6 +57,9 @@ class AppController(QObject):
             keystroke_opacity=self.set_keystroke_opacity,
         )
         self.tray.exit_requested.connect(self.shutdown)
+        self.tray.autostart_changed.connect(self.set_autostart_enabled)
+        self.tray.language_changed.connect(self.set_language)
+        self.tray.menu.aboutToShow.connect(self.refresh_autostart)
         self.tray.panel.capslock_enabled_changed.connect(self.set_capslock_enabled)
         self.tray.panel.capslock_color_changed.connect(self.set_capslock_color)
         self.tray.panel.capslock_opacity_changed.connect(self.set_capslock_opacity)
@@ -70,6 +78,7 @@ class AppController(QObject):
         self._app.aboutToQuit.connect(self.cleanup)
 
     def start(self) -> None:
+        self.refresh_autostart()
         self.tray.show()
         self.spotlight.set_enabled(self.settings.spotlight.enabled)
         if self.settings.keystroke.enabled:
@@ -77,6 +86,31 @@ class AppController(QObject):
         if self.settings.capslock.enabled:
             self.set_capslock_enabled(True)
 
+    def refresh_autostart(self) -> None:
+        try:
+            self.tray.set_autostart_checked(autostart.is_enabled())
+        except OSError as error:
+            self.tray.notify_warning(self._text("無法設定開機自動啟動：{error}", error=error))
+
+    def set_autostart_enabled(self, enabled: bool) -> None:
+        try:
+            autostart.set_enabled(enabled)
+        except OSError as error:
+            self.tray.set_autostart_checked(not enabled)
+            self.refresh_autostart()
+            self.tray.notify_warning(self._text("無法設定開機自動啟動：{error}", error=error))
+
+    def set_language(self, preference: str) -> None:
+        if preference not in {"system", "zh", "en"}:
+            return
+        self.settings.language = preference
+        self.tray.set_language(preference)
+        self.capslock.setToolTip(self._text("拖曳以移動狀態提示"))
+        self._save()
+
+    def _text(self, source: str, **values: object) -> str:
+        return tr(source, effective_language(self.settings.language)).format(**values)
+
     def set_capslock_enabled(self, enabled: bool) -> None:
         self.settings.capslock.enabled = enabled
         self.capslock_monitor.stop()
@@ -106,7 +140,7 @@ class AppController(QObject):
 
     def _show_input_source(self, name: str) -> None:
         if self.settings.capslock.mode == "input_source":
-            self.capslock.show_input_source(name)
+            self.capslock.show_input_source(self._text(name))
 
     def set_capslock_color(self, color: str) -> None:
         self.settings.capslock.color = color
@@ -132,14 +166,14 @@ class AppController(QObject):
         self.set_capslock_enabled(False)
         with QSignalBlocker(self.tray.panel.capslock_enabled):
             self.tray.panel.capslock_enabled.setChecked(False)
-        self.tray.notify_warning(f"無法顯示鍵盤狀態：{message}")
+        self.tray.notify_warning(self._text("無法顯示鍵盤狀態：{message}", message=message))
 
     def set_spotlight_enabled(self, enabled: bool) -> None:
         try:
             self.spotlight.set_enabled(enabled)
         except Exception as error:
             self._disable_spotlight_ui()
-            self.tray.notify_warning(f"無法啟用聚光燈游標：{error}")
+            self.tray.notify_warning(self._text("無法啟用聚光燈游標：{error}", error=error))
             return
         self.settings.spotlight.enabled = enabled
         self._save()
@@ -162,7 +196,7 @@ class AppController(QObject):
             self.spotlight.set_appearance(value.color, value.opacity, value.size)
         except Exception as error:
             self._disable_spotlight_ui()
-            self.tray.notify_warning(f"無法更新聚光燈游標：{error}")
+            self.tray.notify_warning(self._text("無法更新聚光燈游標：{error}", error=error))
             return
         self._save()
 
@@ -194,7 +228,9 @@ class AppController(QObject):
         success, error = self.monitor.start()
         if not success:
             self._disable_keystroke_ui()
-            self.tray.notify_warning(f"無法啟用按鍵顯示：{error or '未知錯誤'}")
+            self.tray.notify_warning(
+                self._text("無法啟用按鍵顯示：{error}", error=error or self._text("未知錯誤"))
+            )
             return
         self.settings.keystroke.enabled = True
         self._save()
@@ -214,7 +250,7 @@ class AppController(QObject):
 
     def _keyboard_failed(self, message: str) -> None:
         self._disable_keystroke_ui()
-        self.tray.notify_warning(f"按鍵監聽已停止：{message}")
+        self.tray.notify_warning(self._text("按鍵監聽已停止：{message}", message=message))
 
     def _disable_keystroke_ui(self) -> None:
         self._keystroke_start_pending = False
@@ -248,8 +284,8 @@ class AppController(QObject):
 
 def create_application(arguments: Sequence[str] | None = None) -> QApplication:
     app = QApplication(list(arguments) if arguments is not None else sys.argv)
-    app.setApplicationName("簡報瑞士刀")
     app.setOrganizationName("prkit")
+    app.setApplicationName("簡報瑞士刀")
     app.setQuitOnLastWindowClosed(False)
     return app
 
@@ -257,7 +293,10 @@ def create_application(arguments: Sequence[str] | None = None) -> QApplication:
 def main() -> int:
     app = create_application()
     if not TrayController.is_available():
-        QMessageBox.critical(None, "簡報瑞士刀", "此桌面環境沒有可用的系統匣。")
+        language = effective_language(SettingsStore().load().language)
+        QMessageBox.critical(
+            None, tr("簡報瑞士刀", language), tr("此桌面環境沒有可用的系統匣。", language)
+        )
         return 1
     controller = AppController(app)
     controller.start()

prkit-0.3.0/src/prkit/autostart.py

@@ -0,0 +1,90 @@
+"""Manage per-user login startup without changing application settings."""
+
+from __future__ import annotations
+
+import os
+import plistlib
+import sys
+from contextlib import suppress
+from pathlib import Path
+
+
+def launch_command() -> list[str]:
+    executable = Path(sys.executable)
+    if getattr(sys, "frozen", False):
+        return [str(executable)]
+    if sys.platform == "win32":
+        windowless = executable.with_name("pythonw.exe")
+        if windowless.exists():
+            executable = windowless
+    return [str(executable), "-m", "prkit"]
+
+
+def is_enabled() -> bool:
+    if sys.platform == "win32":
+        import winreg
+
+        try:
+            with winreg.OpenKey(winreg.HKEY_CURRENT_USER, RUN_KEY) as key:
+                winreg.QueryValueEx(key, "PRKit")
+            return True
+        except FileNotFoundError:
+            return False
+    return _startup_path().exists()
+
+
+def set_enabled(enabled: bool) -> None:
+    if sys.platform == "win32":
+        _set_windows(enabled)
+    else:
+        path = _startup_path()
+        if not enabled:
+            path.unlink(missing_ok=True)
+        else:
+            path.parent.mkdir(parents=True, exist_ok=True)
+            if sys.platform == "darwin":
+                content = plistlib.dumps(
+                    {
+                        "Label": "com.codemee.prkit",
+                        "ProgramArguments": launch_command(),
+                        "RunAtLoad": True,
+                    }
+                )
+                path.write_bytes(content)
+            else:
+                command = " ".join(_desktop_quote(arg) for arg in launch_command())
+                path.write_text(
+                    "[Desktop Entry]\nType=Application\nName=PRKit\n"
+                    f"Exec={command}\nTerminal=false\nX-GNOME-Autostart-enabled=true\n",
+                    encoding="utf-8",
+                )
+
+
+RUN_KEY = r"Software\Microsoft\Windows\CurrentVersion\Run"
+
+
+def _set_windows(enabled: bool) -> None:
+    import subprocess
+    import winreg
+
+    with winreg.CreateKey(winreg.HKEY_CURRENT_USER, RUN_KEY) as key:
+        if enabled:
+            command = subprocess.list2cmdline(launch_command())
+            winreg.SetValueEx(key, "PRKit", 0, winreg.REG_SZ, command)
+        else:
+            with suppress(FileNotFoundError):
+                winreg.DeleteValue(key, "PRKit")
+
+
+def _startup_path() -> Path:
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "LaunchAgents" / "com.codemee.prkit.plist"
+    config = Path(os.environ.get("XDG_CONFIG_HOME", Path.home() / ".config"))
+    return config / "autostart" / "prkit.desktop"
+
+
+def _desktop_quote(argument: str) -> str:
+    # Desktop Entry Exec uses double quotes, rather than shell quoting.
+    escaped = argument.replace("\\", "\\\\")
+    escaped = escaped.replace('"', '\\"').replace("$", "\\$").replace("`", "\\`")
+    return f'"{escaped}"'

{prkit-0.2.1 → prkit-0.3.0}/src/prkit/icon.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from PySide6.QtCore import QByteArray
-from PySide6.QtGui import QIcon, QPainter, QPixmap
+from PySide6.QtGui import QColor, QFont, QIcon, QPainter, QPen, QPixmap
 from PySide6.QtSvg import QSvgRenderer
 
 TRAY_ICON_SVG = b"""<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
@@ -23,3 +23,24 @@ def tray_icon() -> QIcon:
         painter.end()
         icon.addPixmap(pixmap)
     return icon
+
+
+def language_icon(mode: str) -> QIcon:
+    pixmap = QPixmap(32, 32)
+    pixmap.fill("transparent")
+    painter = QPainter(pixmap)
+    painter.setRenderHint(QPainter.RenderHint.Antialiasing)
+    painter.setPen(QPen(QColor("#202124"), 2))
+    if mode == "system":
+        painter.drawEllipse(3, 3, 26, 26)
+        painter.drawEllipse(10, 3, 12, 26)
+        painter.drawLine(4, 16, 28, 16)
+        painter.drawLine(7, 9, 25, 9)
+        painter.drawLine(7, 23, 25, 23)
+    else:
+        font = QFont("Arial", 19 if mode == "zh" else 15)
+        font.setBold(True)
+        painter.setFont(font)
+        painter.drawText(pixmap.rect(), 0x84, "中" if mode == "zh" else "En")
+    painter.end()
+    return QIcon(pixmap)

prkit-0.3.0/src/prkit/language.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from PySide6.QtCore import QLocale
+
+ENGLISH = {
+    "簡報瑞士刀": "PRKit",
+    "選擇顏色": "Choose color",
+    "啟用聚光燈游標": "Enable spotlight cursor",
+    "聚光燈游標": "Spotlight cursor",
+    "顏色": "Color",
+    "透明度": "Opacity",
+    "圓圈大小": "Circle size",
+    "啟用按鍵顯示": "Enable keystroke display",
+    "按鍵顯示": "Keystroke display",
+    "Caps Lock／輸入法狀態": "Caps Lock / input source",
+    "啟用狀態顯示": "Enable status display",
+    " 秒": " sec",
+    "一直顯示": "Always show",
+    "狀態變化後的顯示時間；0 表示一直顯示": "Display time after a change; 0 means always show",
+    "Caps Lock 指示燈": "Caps Lock indicator",
+    "目前輸入法（中文／英文）": "Current input source (Chinese / English)",
+    "顯示內容": "Display content",
+    "背景顏色": "Background color",
+    "顯示時間": "Display time",
+    "顯示時可用滑鼠拖曳，位置會自動保存。": "Drag the indicator to move it. Its position is saved.",
+    "⚠ Wayland 不保證支援全域按鍵與覆蓋層": "⚠ Wayland may not support global keys or overlays",
+    "拖曳以移動狀態提示": "Drag to move the status indicator",
+    "開機自動啟動": "Start at login",
+    "語言": "Language",
+    "隨系統": "System default",
+    "中文": "Chinese",
+    "英文": "English",
+    "中文（注音）": "Chinese (Zhuyin)",
+    "結束": "Quit",
+    "無法設定開機自動啟動：{error}": "Could not change start at login: {error}",
+    "無法顯示鍵盤狀態：{message}": "Could not display keyboard status: {message}",
+    "無法啟用聚光燈游標：{error}": "Could not enable spotlight cursor: {error}",
+    "無法更新聚光燈游標：{error}": "Could not update spotlight cursor: {error}",
+    "無法啟用按鍵顯示：{error}": "Could not enable keystroke display: {error}",
+    "未知錯誤": "Unknown error",
+    "按鍵監聽已停止：{message}": "Keystroke monitoring stopped: {message}",
+    "此桌面環境沒有可用的系統匣。": "No system tray is available in this desktop environment.",
+}
+
+
+def effective_language(preference: str) -> str:
+    if preference == "system":
+        return "zh" if QLocale.system().language() == QLocale.Language.Chinese else "en"
+    return preference if preference in {"zh", "en"} else "zh"
+
+
+def tr(text: str, language: str) -> str:
+    return ENGLISH.get(text, text) if language == "en" else text

{prkit-0.2.1 → prkit-0.3.0}/src/prkit/settings.py

@@ -51,6 +51,7 @@ class AppSettings:
     spotlight: SpotlightSettings
     keystroke: KeystrokeSettings
     capslock: CapsLockSettings = field(default_factory=CapsLockSettings)
+    language: str = "system"
 
     @classmethod
     def defaults(cls) -> AppSettings:
@@ -110,10 +111,14 @@ class SettingsStore:
                 else "capslock"
             ),
         )
-        return AppSettings(spotlight, keystroke, capslock)
+        language = backend.value("language", "system")
+        if language not in {"system", "zh", "en"}:
+            language = "system"
+        return AppSettings(spotlight, keystroke, capslock, language)
 
     def save(self, settings: AppSettings) -> None:
         values = {
+            "language": settings.language,
             "spotlight/enabled": settings.spotlight.enabled,
             "spotlight/color": settings.spotlight.color,
             "spotlight/opacity": settings.spotlight.opacity,

{prkit-0.2.1 → prkit-0.3.0}/src/prkit/tray.py

@@ -22,7 +22,8 @@ from PySide6.QtWidgets import (
     QWidgetAction,
 )
 
-from prkit.icon import tray_icon
+from prkit.icon import language_icon, tray_icon
+from prkit.language import effective_language, tr
 from prkit.platform import is_wayland
 from prkit.settings import (
     MAX_SPOTLIGHT_SIZE,
@@ -37,6 +38,7 @@ class ColorButton(QPushButton):
     def __init__(self, color: str, parent: QWidget | None = None) -> None:
         super().__init__(parent)
         self._color = color
+        self._dialog_title = "選擇顏色"
         self.setFixedSize(42, 24)
         self.setToolTip("選擇顏色")
         self.clicked.connect(self._choose_color)
@@ -54,7 +56,7 @@ class ColorButton(QPushButton):
         )
 
     def _choose_color(self) -> None:
-        chosen = QColorDialog.getColor(QColor(self._color), self, "選擇顏色")
+        chosen = QColorDialog.getColor(QColor(self._color), self, self._dialog_title)
         if chosen.isValid():
             self.set_color(chosen.name())
             self.color_changed.emit(self._color)
@@ -126,6 +128,7 @@ class SettingsPanel(QWidget):
         layout.setSpacing(10)
 
         self.spotlight_enabled = QCheckBox("啟用聚光燈游標")
+        self.spotlight_enabled.setProperty("i18n", "啟用聚光燈游標")
         self.spotlight_enabled.setChecked(settings.spotlight.enabled)
         self.spotlight_color = ColorButton(settings.spotlight.color)
         self.spotlight_opacity = ValueSlider(10, 100, settings.spotlight.opacity, "%")
@@ -144,6 +147,7 @@ class SettingsPanel(QWidget):
         layout.addWidget(self._separator())
 
         self.keystroke_enabled = QCheckBox("啟用按鍵顯示")
+        self.keystroke_enabled.setProperty("i18n", "啟用按鍵顯示")
         self.keystroke_enabled.setChecked(settings.keystroke.enabled)
         self.keystroke_color = ColorButton(settings.keystroke.color)
         self.keystroke_opacity = ValueSlider(10, 100, settings.keystroke.opacity, "%")
@@ -155,6 +159,7 @@ class SettingsPanel(QWidget):
         layout.addWidget(self._separator())
         layout.addWidget(self._section_title("Caps Lock／輸入法狀態"))
         self.capslock_enabled = QCheckBox("啟用狀態顯示")
+        self.capslock_enabled.setProperty("i18n", "啟用狀態顯示")
         self.capslock_enabled.setChecked(settings.capslock.enabled)
         self.capslock_color = ColorButton(settings.capslock.color)
         self.capslock_opacity = ValueSlider(10, 100, settings.capslock.opacity, "%")
@@ -176,11 +181,13 @@ class SettingsPanel(QWidget):
         layout.addLayout(self._row("透明度", self.capslock_opacity))
         layout.addLayout(self._row("顯示時間", self.capslock_duration))
         hint = QLabel("顯示時可用滑鼠拖曳，位置會自動保存。")
+        hint.setProperty("i18n", hint.text())
         hint.setWordWrap(True)
         layout.addWidget(hint)
 
         if is_wayland():
             warning = QLabel("⚠ Wayland 不保證支援全域按鍵與覆蓋層")
+            warning.setProperty("i18n", warning.text())
             warning.setWordWrap(True)
             warning.setStyleSheet("color: #b26a00; padding-top: 6px")
             layout.addWidget(warning)
@@ -199,6 +206,22 @@ class SettingsPanel(QWidget):
         self.capslock_mode.currentIndexChanged.connect(
             lambda index: self.capslock_mode_changed.emit(self.capslock_mode.itemData(index))
         )
+        self.retranslate(effective_language(settings.language))
+
+    def retranslate(self, language: str) -> None:
+        for widget in self.findChildren(QLabel) + self.findChildren(QCheckBox):
+            key = widget.property("i18n")
+            if key:
+                widget.setText(tr(key, language))
+        for button in self.findChildren(ColorButton):
+            button._dialog_title = tr("選擇顏色", language)
+            button.setToolTip(button._dialog_title)
+        self.capslock_duration.setSuffix(tr(" 秒", language))
+        self.capslock_duration.setSpecialValueText(tr("一直顯示", language))
+        self.capslock_duration.setToolTip(tr("狀態變化後的顯示時間；0 表示一直顯示", language))
+        self.capslock_mode.setItemText(0, tr("Caps Lock 指示燈", language))
+        if self.capslock_mode.count() > 1:
+            self.capslock_mode.setItemText(1, tr("目前輸入法（中文／英文）", language))
 
     def set_spotlight_enabled(self, enabled: bool) -> None:
         self.spotlight_enabled.setChecked(enabled)
@@ -209,6 +232,7 @@ class SettingsPanel(QWidget):
     @staticmethod
     def _section_title(text: str) -> QLabel:
         label = QLabel(text)
+        label.setProperty("i18n", text)
         font = label.font()
         font.setBold(True)
         label.setFont(font)
@@ -226,6 +250,7 @@ class SettingsPanel(QWidget):
         layout = QHBoxLayout()
         layout.setContentsMargins(18, 0, 0, 0)
         title = QLabel(label)
+        title.setProperty("i18n", label)
         title.setMinimumWidth(62)
         layout.addWidget(title)
         layout.addWidget(widget, 1)
@@ -234,6 +259,8 @@ class SettingsPanel(QWidget):
 
 class TrayController(QObject):
     exit_requested = Signal()
+    autostart_changed = Signal(bool)
+    language_changed = Signal(str)
 
     def __init__(self, settings: AppSettings, parent: QObject | None = None) -> None:
         super().__init__(parent)
@@ -243,12 +270,59 @@ class TrayController(QObject):
         panel_action.setDefaultWidget(self.panel)
         self.menu.addAction(panel_action)
         self.menu.addSeparator()
-        exit_action = QAction("結束", self.menu)
-        exit_action.triggered.connect(self.exit_requested)
-        self.menu.addAction(exit_action)
+        autostart_row = QWidget(self.menu)
+        autostart_layout = QHBoxLayout(autostart_row)
+        autostart_layout.setContentsMargins(14, 4, 14, 4)
+        self.autostart_checkbox = QCheckBox(autostart_row)
+        self.autostart_checkbox.toggled.connect(self.autostart_changed)
+        autostart_layout.addWidget(self.autostart_checkbox)
+        autostart_action = QWidgetAction(self.menu)
+        autostart_action.setDefaultWidget(autostart_row)
+        self.menu.addAction(autostart_action)
+        self.language_mode = settings.language
+        language_row = QWidget(self.menu)
+        language_layout = QHBoxLayout(language_row)
+        language_layout.setContentsMargins(14, 4, 14, 4)
+        self.language_label = QLabel(language_row)
+        self.language_button = QPushButton(language_row)
+        self.language_button.setFixedSize(40, 36)
+        self.language_button.clicked.connect(self._cycle_language)
+        language_layout.addWidget(self.language_label)
+        language_layout.addStretch(1)
+        language_layout.addWidget(self.language_button)
+        language_action = QWidgetAction(self.menu)
+        language_action.setDefaultWidget(language_row)
+        self.menu.addAction(language_action)
+        self.exit_action = QAction(self.menu)
+        self.exit_action.triggered.connect(self.exit_requested)
+        self.menu.addAction(self.exit_action)
         self.tray = QSystemTrayIcon(tray_icon(), self)
-        self.tray.setToolTip("簡報瑞士刀")
         self.tray.setContextMenu(self.menu)
+        self.retranslate(effective_language(settings.language))
+
+    def retranslate(self, language: str) -> None:
+        self.panel.retranslate(language)
+        self.autostart_checkbox.setText(tr("開機自動啟動", language))
+        mode_label = {"system": "隨系統", "zh": "中文", "en": "英文"}[self.language_mode]
+        separator = ": " if language == "en" else "："
+        self.language_label.setText(f"{tr('語言', language)}{separator}{tr(mode_label, language)}")
+        self.language_button.setIcon(language_icon(self.language_mode))
+        self.language_button.setToolTip(self.language_label.text())
+        self.exit_action.setText(tr("結束", language))
+        self.tray.setToolTip(tr("簡報瑞士刀", language))
+
+    def set_language(self, preference: str) -> None:
+        self.language_mode = preference
+        self.retranslate(effective_language(preference))
+
+    def _cycle_language(self) -> None:
+        modes = ("system", "zh", "en")
+        self.language_changed.emit(modes[(modes.index(self.language_mode) + 1) % len(modes)])
+
+    def set_autostart_checked(self, enabled: bool) -> None:
+        self.autostart_checkbox.blockSignals(True)
+        self.autostart_checkbox.setChecked(enabled)
+        self.autostart_checkbox.blockSignals(False)
 
     @staticmethod
     def is_available() -> bool:
@@ -262,7 +336,9 @@ class TrayController(QObject):
         self.tray.hide()
 
     def notify_warning(self, message: str) -> None:
-        self.tray.showMessage("簡報瑞士刀", message, QSystemTrayIcon.MessageIcon.Warning, 5000)
+        self.tray.showMessage(
+            self.tray.toolTip(), message, QSystemTrayIcon.MessageIcon.Warning, 5000
+        )
 
     def connect_settings(
         self,