frontengine 1.0.32__tar.gz → 1.0.33__tar.gz

{frontengine-1.0.32 → frontengine-1.0.33}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.32
+Version: 1.0.33
 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

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/show/pet/desktop_pet.py

@@ -16,6 +16,12 @@ from frontengine.show.window_helpers import apply_overlay_window_flags
 from frontengine.user_setting.user_setting_file import user_setting_dict
 from frontengine.utils.audio_meter.audio_envelope import AudioEnvelope
 from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.power_mode.power_mode import scaled_interval
+from frontengine.utils.platform_info.platform_info import (
+    idle_seconds as platform_idle_seconds,
+    read_battery as platform_read_battery,
+    standable_windows,
+)
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
 
 # 行為模式 / Behaviour modes
@@ -212,75 +218,17 @@ def derive_visual_state(dragging: bool, airborne: bool, surface: str, motion_sta
     return STATE_WALK
 
 
-# 列舉可站立視窗時要略過的外殼視窗類別
-# Shell window classes skipped when enumerating standable windows.
-_PLATFORM_SKIP_CLASSES = {"WorkerW", "Progman", "Shell_TrayWnd", "Button"}
-
-
 def windows_platforms(exclude_hwnds=()) -> list:
     """
-    回傳目前可見頂層視窗的上緣做為可站立平台 (left, right, top_y)。僅 Windows
-    有效，其餘平台或發生錯誤時回傳空清單。
-    Return the top edges of visible top-level windows as standable platforms
-    (left, right, top_y). Windows only; returns [] elsewhere or on error.
+    回傳目前可站立的視窗上緣 (left, right, top_y)；各平台實作見 platform_info。
+    Standable window top edges; per-platform implementations live in platform_info.
     """
-    if sys.platform != "win32":
-        return []
-    try:
-        import ctypes
-        from ctypes import wintypes
-
-        user32 = ctypes.windll.user32
-        exclude = {int(h) for h in exclude_hwnds}
-        platforms: list = []
-
-        @ctypes.WINFUNCTYPE(wintypes.BOOL, wintypes.HWND, wintypes.LPARAM)
-        def _collect(hwnd, _lparam):
-            if int(hwnd) in exclude or not user32.IsWindowVisible(hwnd):
-                return True
-            rect = wintypes.RECT()
-            if not user32.GetWindowRect(hwnd, ctypes.byref(rect)):
-                return True
-            width = rect.right - rect.left
-            height = rect.bottom - rect.top
-            if width < 80 or height < 40:
-                return True
-            class_buffer = ctypes.create_unicode_buffer(64)
-            user32.GetClassNameW(hwnd, class_buffer, 64)
-            if class_buffer.value in _PLATFORM_SKIP_CLASSES:
-                return True
-            platforms.append((rect.left, rect.right, rect.top))
-            return True
-
-        user32.EnumWindows(_collect, 0)
-        return platforms
-    except Exception as error:  # pragma: no cover - Win32 boundary
-        front_engine_logger.warning(f"[windows_platforms] error: {error!r}")
-        return []
+    return standable_windows(exclude_hwnds)
 
 
 def idle_seconds():
-    """
-    回傳使用者未操作的秒數；無法取得時回傳 None。僅 Windows 實作。
-    Seconds since the last user input, or None when unavailable (Windows only).
-    """
-    if sys.platform != "win32":
-        return None
-    try:
-        import ctypes
-
-        class _LASTINPUTINFO(ctypes.Structure):
-            _fields_ = [("cbSize", ctypes.c_uint), ("dwTime", ctypes.c_uint)]
-
-        info = _LASTINPUTINFO()
-        info.cbSize = ctypes.sizeof(info)
-        if not ctypes.windll.user32.GetLastInputInfo(ctypes.byref(info)):
-            return None
-        elapsed_ms = ctypes.windll.kernel32.GetTickCount() - info.dwTime
-        return max(0.0, elapsed_ms / 1000.0)
-    except Exception as error:  # pragma: no cover - Win32 boundary
-        front_engine_logger.warning(f"[idle_seconds] error: {error!r}")
-        return None
+    """使用者未操作的秒數；取不到回傳 None（跨平台，見 platform_info）。"""
+    return platform_idle_seconds()
 
 
 class PetTimeline:
@@ -335,35 +283,8 @@ def pop_due_reminders(now, reminders):
 
 
 def read_battery():
-    """
-    回傳 (電量百分比, 是否充電中)；無法取得時回傳 None。僅 Windows 實作。
-    Return (percent, charging) or None when unavailable. Windows only.
-    """
-    if sys.platform != "win32":
-        return None
-    try:
-        import ctypes
-
-        class _SPS(ctypes.Structure):
-            _fields_ = [
-                ("ACLineStatus", ctypes.c_byte),
-                ("BatteryFlag", ctypes.c_byte),
-                ("BatteryLifePercent", ctypes.c_byte),
-                ("SystemStatusFlag", ctypes.c_byte),
-                ("BatteryLifeTime", ctypes.c_ulong),
-                ("BatteryFullLifeTime", ctypes.c_ulong),
-            ]
-
-        status = _SPS()
-        if not ctypes.windll.kernel32.GetSystemPowerStatus(ctypes.byref(status)):
-            return None
-        percent = status.BatteryLifePercent & 0xFF
-        if percent == 255:  # unknown / no battery
-            return None
-        return (int(percent), status.ACLineStatus == 1)
-    except Exception as error:  # pragma: no cover - Win32 boundary
-        front_engine_logger.warning(f"[read_battery] error: {error!r}")
-        return None
+    """回傳 (電量百分比, 是否充電中)；沒有電池或取不到回傳 None（跨平台）。"""
+    return platform_read_battery()
 
 
 def nearest_peer(center, peers):
@@ -1147,6 +1068,9 @@ class DesktopPetWidget(BaseWidget):
 
         self._timer = QTimer(self)
         self._timer.timeout.connect(self._on_tick)
+        # 省電模式與原始更新間隔 / Low-power state and the base tick interval
+        self._low_power = False
+        self._tick_interval_ms = 33
 
         # Speech bubbles / chatter / mood
         self._talk = bool(talk)
@@ -1417,6 +1341,12 @@ class DesktopPetWidget(BaseWidget):
             painter.drawPixmap(
                 QRect((self.width() - width) // 2, self.height() - height, width, height), pixmap)
 
+    def set_low_power(self, enabled: bool) -> None:
+        """省電模式：把移動更新拉慢（畫面較不順，但省電）。"""
+        self._low_power = bool(enabled)
+        if self._timer.isActive():
+            self._timer.start(scaled_interval(self._tick_interval_ms, self._low_power))
+
     def start_moving(self, bounds: Tuple[int, int, int, int], interval_ms: int = 33) -> None:
         front_engine_logger.info(f"[DesktopPetWidget] start_moving | bounds={bounds}")
         left, top, right, bottom = bounds
@@ -1424,7 +1354,8 @@ class DesktopPetWidget(BaseWidget):
         self.motion.x = float(left)
         self.motion.y = float(bottom - self.pet_size)
         self.move(int(self.motion.x), int(self.motion.y))
-        self._timer.start(max(10, int(interval_ms)))
+        self._tick_interval_ms = max(10, int(interval_ms))
+        self._timer.start(scaled_interval(self._tick_interval_ms, self._low_power))
         self._schedule_chatter()
         self._reminder_timer.start(10000)
         if self._timeline_start is None:

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/show/text/draw_text.py

@@ -3,6 +3,7 @@ from PySide6.QtGui import QPainter, QFont, QColor, QFontMetrics
 
 from frontengine.show.base_widget import BaseWidget
 from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.power_mode.power_mode import scaled_interval
 
 
 _ALIGNMENT_MAP = {
@@ -35,6 +36,7 @@ class TextWidget(BaseWidget):
         self.draw_font = QFont(self.font().family(), self.font_size)
 
         # Marquee (horizontal scroll) state
+        self.low_power: bool = False
         self.marquee: bool = False
         self.marquee_speed: int = 4
         self.marquee_offset: int = 0
@@ -83,7 +85,7 @@ class TextWidget(BaseWidget):
             self.marquee_speed = 4
         if self.marquee:
             self.marquee_offset = self.width()
-            self._marquee_timer.start(30)
+            self._marquee_timer.start(scaled_interval(30, self.low_power))
         else:
             self._marquee_timer.stop()
 
@@ -116,6 +118,15 @@ class TextWidget(BaseWidget):
             self.text = text
             self.update()
 
+    def set_low_power(self, enabled: bool) -> None:
+        """省電模式：拉慢文字來源與跑馬燈的更新，降低重繪次數。"""
+        self.low_power = bool(enabled)
+        if self._source_timer.isActive() and self.text_source is not None:
+            self._source_timer.start(scaled_interval(
+                getattr(self.text_source, "refresh_interval_ms", 1000), self.low_power))
+        if self._marquee_timer.isActive():
+            self._marquee_timer.start(scaled_interval(30, self.low_power))
+
     def _tick_marquee(self) -> None:
         text_width = QFontMetrics(self.draw_font).horizontalAdvance(self.text)
         self.marquee_offset -= self.marquee_speed

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/ui/main_ui.py

@@ -12,7 +12,10 @@ from frontengine.system_tray.extend_system_tray import ExtendSystemTray
 from frontengine.ui.menu.help_menu import build_help_menu
 from frontengine.ui.menu.how_to_menu import build_how_to_menu
 from frontengine.ui.menu.language_menu import build_language_menu
-from frontengine.ui.menu.preset_menu import apply_named_preset, apply_startup_preset, build_preset_menu
+from frontengine.ui.menu.preset_menu import (
+    apply_named_preset, apply_startup_preset, build_preset_menu, restore_last_session,
+    save_last_session,
+)
 from frontengine.ui.menu.settings_menu import build_settings_menu
 from frontengine.ui.page.control_center.control_center_ui import ControlCenterUI
 from frontengine.ui.page.gif.gif_setting_ui import GIFSettingUI
@@ -184,8 +187,10 @@ class FrontEngineMainUI(QMainWindow):
         )
         self.preset_schedule_service.start()
 
-        # 套用啟動預設集（若有設定）
-        # Apply the configured startup preset, if any
+        # 還原上次工作階段（若有開啟），再套用啟動預設集
+        # Restore the last session when enabled, then apply the startup preset.
+        if user_setting_dict.get("restore_last_session"):
+            restore_last_session(self)
         apply_startup_preset(self)
 
         # Debug 模式下自動關閉
@@ -348,6 +353,8 @@ class FrontEngineMainUI(QMainWindow):
 
     def close(self) -> None:
         """關閉程式並清理資源 / Close application and clear resources"""
+        if user_setting_dict.get("restore_last_session"):
+            save_last_session(self)
         if getattr(self, "preset_schedule_service", None) is not None:
             self.preset_schedule_service.stop()
         if getattr(self, "theme_schedule_service", None) is not None:

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/ui/menu/preset_menu.py

@@ -225,6 +225,27 @@ def apply_named_preset(ui: "FrontEngineMainUI", name: str) -> bool:
     return True
 
 
+LAST_SESSION_PRESET = "__last_session__"
+
+
+def save_last_session(ui: "FrontEngineMainUI") -> bool:
+    """
+    把目前各頁面的設定存成「上次工作階段」預設集（關閉程式時呼叫）。
+    Store the current page settings as the last-session preset on exit.
+    """
+    try:
+        PresetRepository().save(LAST_SESSION_PRESET, _collect_state(ui))
+        return True
+    except (OSError, ValueError) as error:
+        front_engine_logger.warning(f"[PresetMenu] save_last_session failed: {error!r}")
+        return False
+
+
+def restore_last_session(ui: "FrontEngineMainUI") -> bool:
+    """啟動時還原上次的設定；沒存過或讀不到就跳過。"""
+    return apply_named_preset(ui, LAST_SESSION_PRESET)
+
+
 def apply_startup_preset(ui: "FrontEngineMainUI") -> None:
     """
     啟動時套用設定的預設集；缺失或損毀時僅記錄警告，不影響啟動。

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/ui/menu/settings_menu.py

@@ -13,6 +13,7 @@ from frontengine.user_setting.user_setting_file import (
     user_setting_dict,
     write_user_setting,
 )
+from frontengine.utils.autostart import autostart_service
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
 
@@ -44,6 +45,20 @@ def build_settings_menu(ui: "FrontEngineMainUI") -> None:
     menu.addAction(theme_schedule_action)
     ui.theme_schedule_action = theme_schedule_action
 
+    autostart_action = QAction(_t("settings_menu_autostart", "Start with the system"), menu)
+    autostart_action.setCheckable(True)
+    autostart_action.setChecked(autostart_service.is_enabled())
+    autostart_action.toggled.connect(lambda checked: _toggle_autostart(ui, checked))
+    menu.addAction(autostart_action)
+    ui.autostart_action = autostart_action
+
+    restore_action = QAction(_t("settings_menu_restore_session", "Restore last session"), menu)
+    restore_action.setCheckable(True)
+    restore_action.setChecked(bool(user_setting_dict.get("restore_last_session")))
+    restore_action.toggled.connect(lambda checked: _toggle_restore_session(checked))
+    menu.addAction(restore_action)
+    ui.restore_session_action = restore_action
+
     menu.addSeparator()
     export_action = QAction(_t("settings_menu_export", "Export settings..."), menu)
     export_action.triggered.connect(lambda: _export_settings(ui))
@@ -54,6 +69,28 @@ def build_settings_menu(ui: "FrontEngineMainUI") -> None:
     menu.addAction(import_action)
 
 
+def _toggle_autostart(ui: "FrontEngineMainUI", enabled: bool) -> None:
+    """開關開機自動啟動；設定失敗時把勾選狀態改回去並告知使用者。"""
+    if autostart_service.set_enabled(enabled):
+        return
+    action = getattr(ui, "autostart_action", None)
+    if action is not None:
+        action.blockSignals(True)
+        action.setChecked(not enabled)
+        action.blockSignals(False)
+    QMessageBox.warning(
+        ui,
+        _t("settings_menu_autostart", "Start with the system"),
+        _t("settings_autostart_failed", "Could not change the autostart setting."),
+    )
+
+
+def _toggle_restore_session(enabled: bool) -> None:
+    """開關「還原上次工作階段」。"""
+    user_setting_dict["restore_last_session"] = bool(enabled)
+    write_user_setting()
+
+
 def _toggle_theme_schedule(ui: "FrontEngineMainUI", enabled: bool) -> None:
     """啟用/停用排程主題並立即套用 / Enable/disable scheduled theme and apply now."""
     front_engine_logger.info(f"[SettingsMenu] toggle theme schedule | enabled={enabled}")

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/ui/page/control_center/control_center_ui.py

@@ -83,6 +83,9 @@ class ControlCenterUI(QWidget):
         self.chroma_key_button = self._create_button("control_center_chroma_key_on", self.toggle_chroma_key)
         self.reset_positions_button = self._create_button(
             "control_center_reset_positions", self.reset_overlay_positions)
+        self._low_power = False
+        self.low_power_button = self._create_button(
+            "control_center_low_power_on", self.toggle_low_power)
         self.clear_all_button = self._create_button("control_center_close_all", self.clear_all)
 
         # Log panel
@@ -108,8 +111,9 @@ class ControlCenterUI(QWidget):
         self.grid_layout.addWidget(self.lock_all_button, 10, 0)
         self.grid_layout.addWidget(self.chroma_key_button, 11, 0)
         self.grid_layout.addWidget(self.reset_positions_button, 12, 0)
-        self.grid_layout.addWidget(self.clear_all_button, 13, 0)
-        self.grid_layout.addWidget(self.log_panel_scroll_area, 0, 1, 14, 1)  # 明確指定 rowSpan, colSpan=1
+        self.grid_layout.addWidget(self.low_power_button, 13, 0)
+        self.grid_layout.addWidget(self.clear_all_button, 14, 0)
+        self.grid_layout.addWidget(self.log_panel_scroll_area, 0, 1, 15, 1)  # rowSpan covers every button
         self.setLayout(self.grid_layout)
 
         # Redirect
@@ -289,6 +293,27 @@ class ControlCenterUI(QWidget):
         """忘掉記住的覆蓋層位置，之後開的覆蓋層回到各自的預設顯示方式。"""
         front_engine_logger.info("ControlCenterUI reset_overlay_positions")
         clear_overlay_geometry()
+    def set_low_power(self, enabled: bool) -> None:
+        """省電模式：讓支援的覆蓋層把更新頻率調慢。"""
+        front_engine_logger.info(f"ControlCenterUI set_low_power | enabled={enabled}")
+        self._low_power = bool(enabled)
+
+        def apply(widget) -> None:
+            setter = getattr(widget, "set_low_power", None)
+            if setter is not None:
+                setter(self._low_power)
+
+        self._for_each_overlay(apply)
+        self.low_power_button.setText(
+            language_wrapper.language_word_dict.get(
+                "control_center_low_power_off" if self._low_power else "control_center_low_power_on",
+                "Low power off" if self._low_power else "Low power on",
+            )
+        )
+
+    def toggle_low_power(self) -> None:
+        """切換省電模式 / Toggle low-power mode."""
+        self.set_low_power(not getattr(self, "_low_power", False))
 
     def _sample_overlay_opacity(self) -> float:
         """取一個現有覆蓋層的不透明度作為起始值 / Seed from an existing overlay's opacity."""

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/user_setting/user_setting_file.py

@@ -38,6 +38,9 @@ user_setting_dict: Dict[str, Any] = {
     # 使用者拖曳過的覆蓋層位置：類別名稱 -> [x, y, 寬, 高]
     # Overlay positions the user dragged into place: class name -> [x, y, w, h]
     "overlay_geometry": {},
+    # 啟動時還原上次的頁面設定
+    # Restore the previous session's page settings on launch
+    "restore_last_session": False,
     # 桌面寵物心情值（0~100），跨工作階段保存
     # Desktop pet mood (0..100), persisted across sessions
     "pet_mood": 60,

frontengine-1.0.33/frontengine/utils/autostart/autostart_service.py

@@ -0,0 +1,172 @@
+"""
+開機自動啟動：Windows 寫 HKCU 的 Run 登錄機碼，Linux 放 XDG autostart 的 .desktop，
+macOS 放 LaunchAgents 的 plist。全部只碰目前使用者的設定，不需要管理員權限，
+也不新增相依套件；產生內容的部分是純函式，方便測試。
+
+Start FrontEngine with the session: an HKCU Run value on Windows, an XDG
+autostart .desktop on Linux, a LaunchAgent plist on macOS. Everything stays in
+the current user's own configuration — no elevation, no new dependencies — and
+the content builders are pure so they can be tested on any platform.
+"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+from typing import List, Optional
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+APP_NAME = "FrontEngine"
+LAUNCH_AGENT_LABEL = "com.frontengine.autostart"
+_DESKTOP_FILE = "frontengine.desktop"
+
+
+def escape_xml(text) -> str:
+    """
+    跳脫 plist 需要的三個字元。這裡只產生輸出、不解析任何 XML，所以不引入
+    XML 解析器（也就沒有 XXE 那類疑慮）。
+    Escape the three characters a plist needs. This only writes XML — nothing
+    here parses it — so no XML parser is pulled in.
+    """
+    return str(text).replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;")
+
+
+def launch_command() -> List[str]:
+    """
+    回傳能重新啟動本程式的命令：打包成執行檔時就是執行檔本身，
+    否則以目前的直譯器執行 `-m frontengine`。
+    The command that relaunches the app: the frozen executable when packaged,
+    otherwise the current interpreter running ``-m frontengine``.
+    """
+    if getattr(sys, "frozen", False):
+        return [sys.executable]
+    return [sys.executable, "-m", "frontengine"]
+
+
+def quote_command(command: List[str]) -> str:
+    """把命令組成一行字串，含空白的項目加上引號。"""
+    parts = []
+    for part in command:
+        text = str(part)
+        parts.append(f'"{text}"' if " " in text and not text.startswith('"') else text)
+    return " ".join(parts)
+
+
+def desktop_entry_text(command: List[str], app_name: str = APP_NAME) -> str:
+    """產生 XDG autostart 用的 .desktop 內容。"""
+    return (
+        "[Desktop Entry]\n"
+        "Type=Application\n"
+        f"Name={app_name}\n"
+        f"Exec={quote_command(command)}\n"
+        "X-GNOME-Autostart-enabled=true\n"
+        "Terminal=false\n"
+    )
+
+
+def launch_agent_plist(command: List[str], label: str = LAUNCH_AGENT_LABEL) -> str:
+    """產生 macOS LaunchAgent 用的 plist 內容。"""
+    arguments = "".join(f"        <string>{escape_xml(part)}</string>\n" for part in command)
+    return (
+        '<?xml version="1.0" encoding="UTF-8"?>\n'
+        '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" '
+        '"http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n'
+        '<plist version="1.0">\n'
+        "<dict>\n"
+        "    <key>Label</key>\n"
+        f"    <string>{escape_xml(label)}</string>\n"
+        "    <key>ProgramArguments</key>\n"
+        "    <array>\n"
+        f"{arguments}"
+        "    </array>\n"
+        "    <key>RunAtLoad</key>\n"
+        "    <true/>\n"
+        "</dict>\n"
+        "</plist>\n"
+    )
+
+
+def autostart_path() -> Optional[Path]:
+    """回傳本平台放置自動啟動設定的檔案路徑；Windows 用登錄檔，回傳 None。"""
+    if sys.platform == "win32":
+        return None
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "LaunchAgents" / f"{LAUNCH_AGENT_LABEL}.plist"
+    return Path.home() / ".config" / "autostart" / _DESKTOP_FILE
+
+
+def is_enabled() -> bool:
+    """目前是否已設定開機自動啟動。"""
+    if sys.platform == "win32":
+        return _read_windows_run_value() is not None
+    path = autostart_path()
+    return bool(path and path.is_file())
+
+
+def set_enabled(enabled: bool) -> bool:
+    """
+    開啟或關閉開機自動啟動；成功回傳 True，失敗記錄後回傳 False（不丟例外）。
+    Enable or disable autostart. Returns False (logged) instead of raising.
+    """
+    front_engine_logger.info(f"[autostart] set_enabled | enabled={enabled}")
+    try:
+        if sys.platform == "win32":
+            return _set_windows(enabled)
+        return _set_file(enabled)
+    except (OSError, ValueError) as error:
+        front_engine_logger.warning(f"[autostart] failed: {error!r}")
+        return False
+
+
+def _set_file(enabled: bool) -> bool:
+    path = autostart_path()
+    if path is None:
+        return False
+    if not enabled:
+        if path.is_file():
+            path.unlink()
+        return True
+    path.parent.mkdir(parents=True, exist_ok=True)
+    command = launch_command()
+    content = launch_agent_plist(command) if sys.platform == "darwin" else desktop_entry_text(command)
+    path.write_text(content, encoding="utf-8")
+    return True
+
+
+def _run_key():
+    import winreg
+
+    return winreg.OpenKey(
+        winreg.HKEY_CURRENT_USER,
+        r"Software\Microsoft\Windows\CurrentVersion\Run",
+        0,
+        winreg.KEY_READ | winreg.KEY_WRITE,
+    )
+
+
+def _read_windows_run_value() -> Optional[str]:
+    try:
+        import winreg
+
+        with _run_key() as key:
+            value, _kind = winreg.QueryValueEx(key, APP_NAME)
+            return str(value)
+    except FileNotFoundError:
+        return None
+    except Exception as error:  # pragma: no cover - registry boundary
+        front_engine_logger.debug(f"[autostart] registry read failed: {error!r}")
+        return None
+
+
+def _set_windows(enabled: bool) -> bool:
+    import winreg
+
+    with _run_key() as key:
+        if enabled:
+            winreg.SetValueEx(key, APP_NAME, 0, winreg.REG_SZ, quote_command(launch_command()))
+        else:
+            try:
+                winreg.DeleteValue(key, APP_NAME)
+            except FileNotFoundError:
+                pass
+    return True

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/utils/multi_language/english.py

@@ -186,6 +186,11 @@ english_word_dict = {
     "control_center_chroma_key_off": "Chroma key off",
     "control_center_reset_positions": "Reset overlay positions",
     "hotkey_toggle_lock": "Lock / unlock overlays",
+    "settings_menu_autostart": "Start with the system",
+    "settings_menu_restore_session": "Restore last session",
+    "settings_autostart_failed": "Could not change the autostart setting.",
+    "control_center_low_power_on": "Low power on",
+    "control_center_low_power_off": "Low power off",
     "control_center_mute_all": "Mute all",
     "control_center_unmute_all": "Unmute all",
     # Recent files

{frontengine-1.0.32 → frontengine-1.0.33}/frontengine/utils/multi_language/traditional_chinese.py

@@ -187,6 +187,11 @@ traditional_chinese_word_dict = {
     "control_center_chroma_key_off": "關閉綠幕背景",
     "control_center_reset_positions": "重設覆蓋層位置",
     "hotkey_toggle_lock": "鎖定／解鎖覆蓋層",
+    "settings_menu_autostart": "開機時自動啟動",
+    "settings_menu_restore_session": "還原上次工作階段",
+    "settings_autostart_failed": "無法變更自動啟動設定。",
+    "control_center_low_power_on": "開啟省電模式",
+    "control_center_low_power_off": "關閉省電模式",
     "control_center_mute_all": "全部靜音",
     "control_center_unmute_all": "取消全部靜音",
     # Recent files