frontengine 1.0.63__tar.gz → 1.0.65__tar.gz

{frontengine-1.0.63 → frontengine-1.0.65}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.63
+Version: 1.0.65
 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.65/frontengine/ui/dialog/screensaver_dialog.py

@@ -0,0 +1,113 @@
+"""
+螢幕保護設定：閒置多久之後，把哪一頁的覆蓋層放上來。
+
+Screensaver settings: how long idle, and which page's overlay to put on screen.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from PySide6.QtWidgets import (
+    QCheckBox, QComboBox, QDialog, QDialogButtonBox, QGridLayout, QLabel, QSpinBox, QWidget,
+)
+
+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 tr
+from frontengine.utils.screensaver.screensaver_service import (
+    DEFAULT_SCREENSAVER, MAX_IDLE_MINUTES, MIN_IDLE_MINUTES, SOURCES, clamp_idle_minutes,
+    normalize_source,
+)
+
+SETTING_KEY = "screensaver"
+
+# 下拉選單的文字用各分頁既有的鍵，省得同一個詞在七種語言裡再翻一次。
+# The dropdown reuses each page's existing key rather than translating the same
+# word a second time in seven languages.
+SOURCE_LABEL_KEYS = {
+    "video": ("tab_video_text", "Video"),
+    "image": ("tab_image_text", "Image"),
+    "gif": ("tab_gif_text", "GIF and WEBP"),
+    "particle": ("tab_particle_text", "Particle"),
+    "web": ("tab_web_text", "Web"),
+}
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+def current_settings() -> Dict[str, Any]:
+    """目前的螢幕保護設定（缺項目補預設值）。"""
+    stored = user_setting_dict.get(SETTING_KEY)
+    settings = dict(DEFAULT_SCREENSAVER)
+    if isinstance(stored, dict):
+        settings.update({key: stored[key] for key in DEFAULT_SCREENSAVER if key in stored})
+    settings["idle_minutes"] = clamp_idle_minutes(settings.get("idle_minutes"))
+    settings["source"] = normalize_source(settings.get("source"))
+    settings["enabled"] = bool(settings.get("enabled"))
+    return settings
+
+
+class ScreensaverDialog(QDialog):
+    """設定閒置多久、顯示哪一頁。"""
+
+    def __init__(self, parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info("[ScreensaverDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("screensaver_title", "Screensaver"))
+        settings = current_settings()
+
+        self.enable_checkbox = tr(QCheckBox(), "screensaver_enable", "Show something when idle")
+        self.enable_checkbox.setChecked(settings["enabled"])
+
+        self.idle_label = tr(QLabel(), "screensaver_idle_minutes", "Idle for (minutes)")
+        self.idle_spinbox = QSpinBox()
+        self.idle_spinbox.setRange(MIN_IDLE_MINUTES, MAX_IDLE_MINUTES)
+        self.idle_spinbox.setValue(settings["idle_minutes"])
+
+        self.source_label = tr(QLabel(), "screensaver_source", "Show")
+        self.source_combobox = QComboBox()
+        for name in SOURCES:
+            key, fallback = SOURCE_LABEL_KEYS[name]
+            self.source_combobox.addItem(_t(key, fallback), name)
+        index = self.source_combobox.findData(settings["source"])
+        if index >= 0:
+            self.source_combobox.setCurrentIndex(index)
+
+        self.hint_label = tr(
+            QLabel(), "screensaver_hint",
+            "It uses that page as you have it set up, so choose the file there first. "
+            "Nothing appears while the page has nothing to show. Moving the mouse or "
+            "pressing a key takes it away again, and anything you opened yourself stays.")
+        self.hint_label.setWordWrap(True)
+
+        buttons = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Ok | QDialogButtonBox.StandardButton.Cancel)
+        buttons.accepted.connect(self.accept)
+        buttons.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.enable_checkbox, 0, 0, 1, 2)
+        layout.addWidget(self.idle_label, 1, 0)
+        layout.addWidget(self.idle_spinbox, 1, 1)
+        layout.addWidget(self.source_label, 2, 0)
+        layout.addWidget(self.source_combobox, 2, 1)
+        layout.addWidget(self.hint_label, 3, 0, 1, 2)
+        layout.addWidget(buttons, 4, 0, 1, 2)
+
+    def collect(self) -> Dict[str, Any]:
+        """把畫面上的選擇讀成設定。"""
+        return {
+            "enabled": self.enable_checkbox.isChecked(),
+            "idle_minutes": clamp_idle_minutes(self.idle_spinbox.value()),
+            "source": normalize_source(self.source_combobox.currentData()),
+        }
+
+    def accept(self) -> None:
+        user_setting_dict[SETTING_KEY] = self.collect()
+        write_user_setting()
+        front_engine_logger.info(
+            f"[ScreensaverDialog] saved | {user_setting_dict[SETTING_KEY]}")
+        super().accept()

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/ui/main_ui.py

@@ -67,6 +67,7 @@ from frontengine.utils.midi.midi_input import MidiInput, binding_key
 from frontengine.utils.remote.remote_server import RemoteServer
 from frontengine.ui.dialog.smart_pause_dialog import current_rules
 from frontengine.utils.screen_privacy.share_watch import ShareWatchService
+from frontengine.utils.screensaver.screensaver_service import ScreensaverService
 from frontengine.utils.app_profile.app_profile_service import AppProfileService
 from frontengine.utils.clipboard.clipboard_history import DEFAULT_LIMIT, ClipboardHistory
 from frontengine.utils.clipboard.clipboard_watcher import ClipboardWatcher
@@ -329,6 +330,15 @@ class FrontEngineMainUI(QMainWindow):
         )
         self.preset_schedule_service.start()
 
+        # 閒置夠久就把選定的覆蓋層放上來 / Show the chosen overlay once idle
+        self._screensaver_overlays: list = []
+        self.screensaver_service = ScreensaverService(
+            config_provider=lambda: user_setting_dict.get("screensaver", {})
+        )
+        self.screensaver_service.screensaver_started.connect(self._start_screensaver)
+        self.screensaver_service.screensaver_stopped.connect(self._stop_screensaver)
+        self.screensaver_service.start()
+
         # 還原上次工作階段（若有開啟），再套用啟動預設集
         # Restore the last session when enabled, then apply the startup preset.
         if user_setting_dict.get("restore_last_session"):
@@ -383,6 +393,76 @@ class FrontEngineMainUI(QMainWindow):
             self.control_center_ui.register_overlay_source(
                 lambda attribute=attribute: getattr(self.tools_setting_ui, attribute, []))
 
+    # 螢幕保護能顯示哪些分頁：來源名稱 -> (頁面屬性, 啟動方法, 覆蓋層清單屬性)
+    # What the screensaver can show: source -> (page attribute, start method,
+    # the page's overlay list).
+    _SCREENSAVER_SOURCES = {
+        "video": ("video_setting_ui", "start_play_video", "video_widget_list"),
+        "image": ("image_setting_ui", "start_play_image", "image_widget_list"),
+        "gif": ("gif_setting_ui", "start_play_gif", "gif_widget_list"),
+        "particle": ("particle_setting_ui", "start_play_particle", "particle_list"),
+        "web": ("web_setting_ui", "start_open_web_with_url", "web_widget_list"),
+    }
+
+    @staticmethod
+    def _screensaver_ready(source: str, page: Any) -> bool:
+        """
+        這一頁現在按下開始會不會出東西。
+
+        非問不可：每個分頁在沒選檔案時都會跳一個 modal 訊息框，而螢幕保護正好是
+        在沒有人的時候啟動的——那個對話框會擋在畫面上直到有人回來按掉。
+        Whether pressing start on this page would actually show something.
+
+        This has to be asked: every page opens a modal message box when no file
+        is chosen, and the screensaver fires precisely when nobody is there - the
+        dialog would sit on screen until someone came back and dismissed it.
+        """
+        if source == "web":
+            field = getattr(page, "web_url_input", None)
+            return bool(field is not None and field.text().strip())
+        return bool(getattr(page, "ready_to_play", False))
+
+    def _start_screensaver(self, source: str) -> None:
+        """閒置夠久了：把選定分頁的覆蓋層放上來，並記住是哪幾個。"""
+        entry = self._SCREENSAVER_SOURCES.get(source)
+        if entry is None:
+            return
+        attribute, start_method, list_name = entry
+        page = getattr(self, attribute, None)
+        overlays = getattr(page, list_name, None) if page is not None else None
+        if page is None or overlays is None:
+            return
+        if not self._screensaver_ready(source, page):
+            front_engine_logger.info(
+                f"[FrontEngineMainUI] screensaver source '{source}' has nothing set up")
+            return
+        before = len(overlays)
+        try:
+            getattr(page, start_method)()
+        except Exception as error:  # pragma: no cover - defensive boundary
+            front_engine_logger.warning(f"[FrontEngineMainUI] screensaver start failed: {error!r}")
+            return
+        # 只記下這次新增的那幾個。人回來時關掉的就只有這些，使用者自己開著的
+        # 覆蓋層不會跟著被收走。
+        # Only what this call added. Coming back closes these and nothing else,
+        # so overlays the user opened themselves survive.
+        self._screensaver_overlays = [(overlays, widget) for widget in overlays[before:]]
+
+    def _stop_screensaver(self) -> None:
+        """人回來了：關掉螢幕保護開的那幾個覆蓋層，其他的留著。"""
+        for overlays, widget in self._screensaver_overlays:
+            try:
+                # 先 close() 再從清單移除：只丟掉參考不會跑 closeEvent，計時器與
+                # 媒體都停不下來。
+                # close() before dropping the reference: dropping it alone never
+                # runs closeEvent, so timers and media keep going.
+                widget.close()
+            except RuntimeError:  # pragma: no cover - 底層物件已消失
+                pass
+            if widget in overlays:
+                overlays.remove(widget)
+        self._screensaver_overlays = []
+
     @staticmethod
     def _startup_language() -> str:
         """
@@ -741,7 +821,7 @@ class FrontEngineMainUI(QMainWindow):
     # The background services to stop on close, outermost first.
     _CLOSING_SERVICES = (
         "preset_schedule_service", "theme_schedule_service", "usage_service",
-        "signage_service",
+        "signage_service", "screensaver_service",
         "remote_server", "midi_input", "share_watch_service", "reminder_service",
         "app_profile_service", "smart_pause_service", "hotkey_service",
     )

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/ui/menu/settings_menu.py

@@ -12,6 +12,7 @@ from frontengine.ui.dialog.hotkey_settings_dialog import HotkeySettingsDialog
 from frontengine.ui.dialog.reminder_dialog import ReminderDialog
 from frontengine.ui.dialog.remote_control_dialog import RemoteControlDialog
 from frontengine.ui.dialog.screen_privacy_dialog import ScreenPrivacyDialog
+from frontengine.ui.dialog.screensaver_dialog import ScreensaverDialog
 from frontengine.ui.dialog.signage_dialog import SignageDialog
 from frontengine.ui.dialog.smart_pause_dialog import SmartPauseDialog
 from frontengine.ui.dialog.usage_report_dialog import UsageReportDialog
@@ -107,6 +108,12 @@ def build_settings_menu(ui: "FrontEngineMainUI") -> None:
     menu.addAction(reminder_action)
     ui.reminder_action = reminder_action
 
+    screensaver_action = QAction(_t("settings_menu_screensaver", "Screensaver..."), menu)
+    retranslator.bind(screensaver_action, "settings_menu_screensaver", "Screensaver...")
+    screensaver_action.triggered.connect(lambda: ScreensaverDialog(ui).exec())
+    menu.addAction(screensaver_action)
+    ui.screensaver_action = screensaver_action
+
     signage_action = QAction(_t("settings_menu_signage", "Signage mode..."), menu)
     retranslator.bind(signage_action, "settings_menu_signage", "Signage mode...")
     signage_action.triggered.connect(lambda: _open_signage_dialog(ui))

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/utils/multi_language/english.py

@@ -46,6 +46,12 @@ english_word_dict = {
     "tools_shape": "Shape",
     "tools_name": "Name",
     "tools_saved": "Saved",
+    "settings_menu_screensaver": "Screensaver...",
+    "screensaver_title": "Screensaver",
+    "screensaver_enable": "Show something when idle",
+    "screensaver_idle_minutes": "Idle for (minutes)",
+    "screensaver_source": "Show",
+    "screensaver_hint": "It uses that page as you have it set up, so choose the file there first. Nothing appears while the page has nothing to show. Moving the mouse or pressing a key takes it away again, and anything you opened yourself stays.",
     "section_close": "CLOSE",
     "section_everything": "EVERYTHING AT ONCE",
     "section_log": "MESSAGES",

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/utils/multi_language/france.py

@@ -47,6 +47,12 @@ french_word_dict = {
     "tools_shape": "Forme",
     "tools_name": "Nom",
     "tools_saved": "Enregistrés",
+    "settings_menu_screensaver": "Économiseur d'écran...",
+    "screensaver_title": "Économiseur d'écran",
+    "screensaver_enable": "Afficher quelque chose en cas d'inactivité",
+    "screensaver_idle_minutes": "Inactif depuis (minutes)",
+    "screensaver_source": "Afficher",
+    "screensaver_hint": "Il affiche la page telle que vous l'avez réglée : choisissez-y d'abord un fichier. Tant que la page n'a rien à montrer, rien n'apparaît. Un mouvement de souris ou une touche le retire, et ce que vous avez ouvert vous-même reste.",
     "section_close": "FERMER",
     "section_everything": "TOUT À LA FOIS",
     "section_log": "MESSAGES",

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/utils/multi_language/germany.py

@@ -47,6 +47,12 @@ germany_word_dict = {
     "tools_shape": "Form",
     "tools_name": "Name",
     "tools_saved": "Gespeichert",
+    "settings_menu_screensaver": "Bildschirmschoner...",
+    "screensaver_title": "Bildschirmschoner",
+    "screensaver_enable": "Bei Untätigkeit etwas anzeigen",
+    "screensaver_idle_minutes": "Untätig seit (Minuten)",
+    "screensaver_source": "Anzeigen",
+    "screensaver_hint": "Es zeigt die gewählte Seite so, wie Sie sie eingerichtet haben - wählen Sie dort also zuerst eine Datei. Solange die Seite nichts zu zeigen hat, erscheint nichts. Eine Mausbewegung oder ein Tastendruck nimmt es wieder weg, und was Sie selbst geöffnet haben, bleibt.",
     "section_close": "SCHLIESSEN",
     "section_everything": "ALLES AUF EINMAL",
     "section_log": "MELDUNGEN",

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/utils/multi_language/italy.py

@@ -47,6 +47,12 @@ italian_word_dict = {
     "tools_shape": "Forma",
     "tools_name": "Nome",
     "tools_saved": "Salvati",
+    "settings_menu_screensaver": "Salvaschermo...",
+    "screensaver_title": "Salvaschermo",
+    "screensaver_enable": "Mostra qualcosa quando sei inattivo",
+    "screensaver_idle_minutes": "Inattivo da (minuti)",
+    "screensaver_source": "Mostra",
+    "screensaver_hint": "Mostra quella pagina così come l'hai impostata, quindi scegli prima un file lì. Finché la pagina non ha nulla da mostrare, non compare niente. Muovere il mouse o premere un tasto lo toglie, e ciò che hai aperto tu resta.",
     "section_close": "CHIUDI",
     "section_everything": "TUTTO IN UNA VOLTA",
     "section_log": "MESSAGGI",

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/utils/multi_language/russian.py

@@ -47,6 +47,12 @@ russian_word_dict = {
     "tools_shape": "Форма",
     "tools_name": "Имя",
     "tools_saved": "Сохранённые",
+    "settings_menu_screensaver": "Заставка...",
+    "screensaver_title": "Заставка",
+    "screensaver_enable": "Показывать что-нибудь при простое",
+    "screensaver_idle_minutes": "Простой (минут)",
+    "screensaver_source": "Показывать",
+    "screensaver_hint": "Показывается выбранная страница в том виде, как вы её настроили, поэтому сначала выберите там файл. Пока странице нечего показать, ничего не появится. Движение мыши или нажатие клавиши убирает наложение, а то, что вы открыли сами, остаётся.",
     "section_close": "ЗАКРЫТЬ",
     "section_everything": "ВСЁ СРАЗУ",
     "section_log": "СООБЩЕНИЯ",

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/utils/multi_language/simplified_chinese.py

@@ -47,6 +47,12 @@ simplified_chinese_word_dict = {
     "tools_shape": "形状",
     "tools_name": "名称",
     "tools_saved": "已保存",
+    "settings_menu_screensaver": "屏幕保护⋯",
+    "screensaver_title": "屏幕保护",
+    "screensaver_enable": "空闲时显示东西",
+    "screensaver_idle_minutes": "空闲多久（分钟）",
+    "screensaver_source": "显示",
+    "screensaver_hint": "它会按那一页当前的设置显示，所以请先在那一页选好文件。那一页没有东西可放时就不会出现。动一下鼠标或按任何键就会收掉，而且只收它自己开的，你原本开着的覆盖层都留着。",
     "section_close": "关闭",
     "section_everything": "一次全部",
     "section_log": "消息",

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine/utils/multi_language/traditional_chinese.py

@@ -47,6 +47,12 @@ traditional_chinese_word_dict = {
     "tools_shape": "形狀",
     "tools_name": "名稱",
     "tools_saved": "已儲存",
+    "settings_menu_screensaver": "螢幕保護⋯",
+    "screensaver_title": "螢幕保護",
+    "screensaver_enable": "閒置時顯示東西",
+    "screensaver_idle_minutes": "閒置多久（分鐘）",
+    "screensaver_source": "顯示",
+    "screensaver_hint": "它會照那一頁目前的設定顯示，所以請先在那一頁選好檔案。那一頁沒有東西可放時就不會出現。動一下滑鼠或按任何鍵就會收掉，而且只收它自己開的，你原本開著的覆蓋層都留著。",
     "section_close": "關閉",
     "section_everything": "一次全部",
     "section_log": "訊息",

frontengine-1.0.65/frontengine/utils/screensaver/screensaver_service.py

@@ -0,0 +1,177 @@
+"""
+螢幕保護模式：閒置到一定時間就把選定的覆蓋層放上來，人回來就收掉。
+
+這個程式的介紹一直寫著「or only use like screen saver」，但真正讓它自己啟動的
+那一段從來沒有寫。閒置秒數在 `platform_info.idle_seconds()` 裡早就有了（Windows、
+macOS、X11 三種都有），只是沒有任何地方在用。
+
+閒置判斷是純邏輯，時間來源可以注入，所以測試不必真的等五分鐘也不必去動滑鼠。
+Qt 服務只負責定時問它「狀態變了嗎」。
+
+Screensaver mode: put the chosen overlay on screen once the machine has been
+idle long enough, and take it away when someone comes back.
+
+The application has always described itself as "or only use like screen saver",
+but the part that starts it on its own was never written. The idle seconds were
+already there in `platform_info.idle_seconds()` - Windows, macOS and X11 - with
+nothing reading them.
+
+The idle decision is pure logic with an injectable clock, so a test does not have
+to wait five minutes or move a mouse. The Qt service only asks it, on a timer,
+whether the state changed.
+"""
+from __future__ import annotations
+
+from typing import Any, Callable, Dict, Optional
+
+from PySide6.QtCore import QObject, QTimer, Signal
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.platform_info.platform_info import idle_seconds
+
+DEFAULT_IDLE_MINUTES = 5
+MIN_IDLE_MINUTES = 1
+MAX_IDLE_MINUTES = 24 * 60
+
+# 可以當螢幕保護內容的分頁。順序就是設定畫面下拉選單的順序。
+# The pages that can be the screensaver. This order is the order in the dialog.
+SOURCES = ("video", "image", "gif", "particle", "web")
+DEFAULT_SOURCE = "video"
+
+DEFAULT_SCREENSAVER: Dict[str, Any] = {
+    "enabled": False,
+    "idle_minutes": DEFAULT_IDLE_MINUTES,
+    "source": DEFAULT_SOURCE,
+}
+
+
+def clamp_idle_minutes(value: Any, fallback: int = DEFAULT_IDLE_MINUTES) -> int:
+    """閒置門檻夾在 1 分鐘到 24 小時之間。"""
+    try:
+        return max(MIN_IDLE_MINUTES, min(MAX_IDLE_MINUTES, int(float(value))))
+    except (TypeError, ValueError):
+        return fallback
+
+
+def normalize_source(value: Any, fallback: str = DEFAULT_SOURCE) -> str:
+    """把設定裡的來源名稱正規化；不認得的就用預設。"""
+    name = str(value or "").strip().lower()
+    return name if name in SOURCES else fallback
+
+
+class ScreensaverState:
+    """
+    依閒置秒數決定該開還是該關。純邏輯，閒置秒數可以注入。
+
+    只在「狀態真的改變」時回話，所以呼叫端不必自己記上一次是什麼——每次輪詢都
+    回報「該開了」會把覆蓋層重開一遍又一遍。
+
+    Decides from the idle seconds whether it should be on or off, as pure logic
+    with an injectable idle source.
+
+    It speaks only when the state actually changes, so the caller does not have
+    to remember the last answer: reporting "should be on" on every poll would
+    reopen the overlay over and over.
+    """
+
+    def __init__(self, config_provider: Callable[[], Dict[str, Any]],
+                 idle_provider: Callable[[], Optional[float]] = idle_seconds) -> None:
+        self._config_provider = config_provider
+        self._idle = idle_provider
+        self.active = False
+
+    def _config(self) -> Dict[str, Any]:
+        config = self._config_provider() or {}
+        return config if isinstance(config, dict) else {}
+
+    def enabled(self) -> bool:
+        return bool(self._config().get("enabled"))
+
+    def idle_minutes(self) -> int:
+        return clamp_idle_minutes(self._config().get("idle_minutes"))
+
+    def source(self) -> str:
+        return normalize_source(self._config().get("source"))
+
+    def poll(self) -> Optional[bool]:
+        """
+        回傳 True 表示「現在該開」、False 表示「現在該關」、None 表示沒有變化。
+
+        關掉的條件不只是「人回來了」：功能被關掉時也要收乾淨，否則使用者關掉開關
+        之後畫面上還留著一層自己不會消失的覆蓋層。
+
+        True to start now, False to stop now, None when nothing changed.
+
+        Stopping is not only about someone coming back: switching the feature off
+        has to clear the screen too, or the user is left with an overlay that
+        will not go away on its own.
+        """
+        if not self.enabled():
+            if self.active:
+                self.active = False
+                return False
+            return None
+
+        seconds = self._idle()
+        if seconds is None:
+            # 這個平台問不到閒置時間，就不要自作主張把東西放上螢幕。
+            # No idle reading on this platform: do not put things on screen by guess.
+            if self.active:
+                self.active = False
+                return False
+            return None
+
+        should_be_active = seconds >= self.idle_minutes() * 60
+        if should_be_active == self.active:
+            return None
+        self.active = should_be_active
+        return should_be_active
+
+
+class ScreensaverService(QObject):
+    """把閒置判斷接上 QTimer，狀態改變時發出訊號。"""
+
+    screensaver_started = Signal(str)   # 要顯示哪一個來源 / which source to show
+    screensaver_stopped = Signal()
+
+    def __init__(self, config_provider: Callable[[], Dict[str, Any]],
+                 idle_provider: Callable[[], Optional[float]] = idle_seconds,
+                 interval_ms: int = 5000, parent: Optional[QObject] = None) -> None:
+        super().__init__(parent)
+        self.state = ScreensaverState(config_provider, idle_provider)
+        self._timer = QTimer(self)
+        self._timer.setInterval(max(1000, int(interval_ms)))
+        self._timer.timeout.connect(self.poll_once)
+
+    @property
+    def running(self) -> bool:
+        return self._timer.isActive()
+
+    @property
+    def active(self) -> bool:
+        return self.state.active
+
+    def start(self) -> None:
+        self._timer.start()
+        front_engine_logger.info("[Screensaver] start")
+
+    def stop(self) -> None:
+        self._timer.stop()
+        front_engine_logger.info("[Screensaver] stop")
+
+    def poll_once(self) -> None:
+        """檢查一次閒置狀態（測試直接呼叫這個，不必等計時器）。"""
+        try:
+            change = self.state.poll()
+        except Exception as error:  # pragma: no cover - defensive boundary
+            front_engine_logger.warning(f"[Screensaver] poll error: {error!r}")
+            return
+        if change is None:
+            return
+        if change:
+            source = self.state.source()
+            front_engine_logger.info(f"[Screensaver] idle, showing {source}")
+            self.screensaver_started.emit(source)
+        else:
+            front_engine_logger.info("[Screensaver] back, clearing")
+            self.screensaver_stopped.emit()

{frontengine-1.0.63 → frontengine-1.0.65}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.63
+Version: 1.0.65
 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.63 → frontengine-1.0.65}/frontengine.egg-info/SOURCES.txt

@@ -80,6 +80,7 @@ frontengine/ui/dialog/reminder_dialog.py
 frontengine/ui/dialog/remote_control_dialog.py
 frontengine/ui/dialog/screen_privacy_dialog.py
 frontengine/ui/dialog/screen_text_dialog.py
+frontengine/ui/dialog/screensaver_dialog.py
 frontengine/ui/dialog/signage_dialog.py
 frontengine/ui/dialog/smart_pause_dialog.py
 frontengine/ui/dialog/usage_report_dialog.py
@@ -227,6 +228,8 @@ frontengine/utils/screen_privacy/capture_affinity.py
 frontengine/utils/screen_privacy/share_watch.py
 frontengine/utils/screen_text/__init__.py
 frontengine/utils/screen_text/screen_text_service.py
+frontengine/utils/screensaver/__init__.py
+frontengine/utils/screensaver/screensaver_service.py
 frontengine/utils/signage/__init__.py
 frontengine/utils/signage/signage_service.py
 frontengine/utils/smart_pause/__init__.py

{frontengine-1.0.63 → frontengine-1.0.65}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "frontengine"
-version = "1.0.63"
+version = "1.0.65"
 authors = [
     { name = "JE-Chen", email = "jechenmailman@gmail.com" },
 ]