frontengine 1.0.64__tar.gz → 1.0.66__tar.gz

{frontengine-1.0.64 → frontengine-1.0.66}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.64
+Version: 1.0.66
 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.66/frontengine/show/replica/replica_widget.py

@@ -0,0 +1,118 @@
+"""
+視窗複本覆蓋層：一個小視窗，裡面是另一個視窗的即時畫面。
+
+和其他覆蓋層不同，這一個**不能點擊穿透**：使用者要能把它拖到順手的位置、拉大縮小、
+關掉。所以它是一個可以拖曳的無邊框視窗，而不是一層蓋在畫面上的東西。
+
+A window replica overlay: a small window showing another window, live.
+
+Unlike the other overlays this one must **not** pass clicks through: the user has
+to be able to drag it somewhere convenient, resize it and close it. So it is a
+draggable frameless window rather than a sheet laid over the screen.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+from PySide6.QtCore import QPoint, Qt
+from PySide6.QtGui import QColor, QPainter
+from PySide6.QtWidgets import QWidget
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.window_replica.dwm_thumbnail import (
+    DEFAULT_REPLICA_WIDTH, MIN_REPLICA_SIZE, DwmThumbnail, available, fit_within,
+)
+
+
+class WindowReplicaWidget(QWidget):
+    """顯示另一個視窗即時畫面的小視窗。"""
+
+    def __init__(self, source_handle: int, title: str = "",
+                 opacity_percent: int = 100, parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info(f"[WindowReplicaWidget] Init | source={source_handle}")
+        super().__init__(parent)
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+        self.setWindowFlags(
+            Qt.WindowType.FramelessWindowHint
+            | Qt.WindowType.WindowStaysOnTopHint
+            | Qt.WindowType.Tool)
+        self.setWindowTitle(title or "FrontEngine")
+        self.setMinimumSize(MIN_REPLICA_SIZE, MIN_REPLICA_SIZE)
+
+        self.source_handle = int(source_handle)
+        self.source_title = title
+        self.opacity_percent = max(1, min(100, int(opacity_percent)))
+        self.thumbnail = DwmThumbnail()
+        self._drag_origin: Optional[QPoint] = None
+
+        self.resize(DEFAULT_REPLICA_WIDTH, int(DEFAULT_REPLICA_WIDTH * 9 / 16))
+
+    def start(self) -> bool:
+        """
+        接上來源視窗並依它的長寬比調整大小。接不上就回 False，呼叫端不要把一個
+        空視窗留在畫面上。
+        Attach to the source and take its aspect ratio. False when it could not
+        attach, so the caller does not leave an empty window on screen.
+        """
+        if not available():
+            front_engine_logger.info("[WindowReplicaWidget] not supported on this platform")
+            return False
+        # 縮圖要接在「這個視窗的 handle」上，所以必須先讓它有 handle。
+        # The thumbnail attaches to this window's handle, so it needs one first.
+        self.show()
+        if not self.thumbnail.register(int(self.winId()), self.source_handle):
+            return False
+        source_size = self.thumbnail.source_size()
+        width, height = fit_within(source_size, (DEFAULT_REPLICA_WIDTH,
+                                                 int(DEFAULT_REPLICA_WIDTH * 9 / 16)))
+        self.resize(width, height)
+        self._refresh()
+        return True
+
+    def _refresh(self) -> None:
+        self.thumbnail.update(self.width(), self.height(),
+                              opacity=int(self.opacity_percent * 255 / 100))
+
+    def set_opacity_percent(self, percent: int) -> None:
+        self.opacity_percent = max(1, min(100, int(percent)))
+        self._refresh()
+
+    def resizeEvent(self, event) -> None:
+        super().resizeEvent(event)
+        self._refresh()
+
+    def paintEvent(self, event) -> None:
+        # DWM 把縮圖合成上來之前，先鋪一層不透明底色。少了這一步，來源還沒畫上來的
+        # 那一瞬間會透出後面的東西，看起來像破圖。
+        # An opaque backing before DWM composites the thumbnail. Without it the
+        # moment before the source arrives shows whatever is behind, which reads
+        # as a rendering fault.
+        painter = QPainter(self)
+        painter.fillRect(self.rect(), QColor(0, 0, 0))
+
+    def mousePressEvent(self, event) -> None:
+        if event.button() == Qt.MouseButton.LeftButton:
+            self._drag_origin = event.globalPosition().toPoint() - self.frameGeometry().topLeft()
+            event.accept()
+
+    def mouseMoveEvent(self, event) -> None:
+        if self._drag_origin is not None and event.buttons() & Qt.MouseButton.LeftButton:
+            self.move(event.globalPosition().toPoint() - self._drag_origin)
+            event.accept()
+
+    def mouseReleaseEvent(self, event) -> None:
+        self._drag_origin = None
+        event.accept()
+
+    def mouseDoubleClickEvent(self, event) -> None:
+        """雙擊關掉——沒有標題列，總得有一個看得懂的出口。"""
+        self.close()
+        event.accept()
+
+    def closeEvent(self, event) -> None:
+        # 縮圖是系統資源，視窗沒了也不會自己消失。從標題列以外的任何路徑關閉時
+        # closeEvent 是唯一會被呼叫到的地方，所以收尾放這裡。
+        # The thumbnail is a system resource and does not go away with the
+        # window. closeEvent is the one place every close path reaches.
+        self.thumbnail.unregister()
+        super().closeEvent(event)

frontengine-1.0.66/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.66/frontengine/ui/dialog/window_replica_dialog.py

@@ -0,0 +1,124 @@
+"""
+挑一個視窗，開一個顯示它即時畫面的小視窗。
+
+和「釘選視窗」的差別在於原視窗動不動：釘選會把它搬到最上層，複本讓它留在原地。
+Pick a window and open a small one showing it live. The difference from pinning
+is whether the original moves: pinning brings it to the top, a replica leaves it
+where it is.
+"""
+from __future__ import annotations
+
+from typing import List, Optional, Tuple
+
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import (
+    QAbstractItemView, QDialog, QDialogButtonBox, QGridLayout, QLabel, QListWidget,
+    QListWidgetItem, QPushButton, QSlider, QWidget,
+)
+
+from frontengine.show.replica.replica_widget import WindowReplicaWidget
+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, tr
+from frontengine.utils.window_pin import window_pin
+from frontengine.utils.window_replica.dwm_thumbnail import available
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+class WindowReplicaDialog(QDialog):
+    """列出目前的視窗，讓使用者挑一個做成即時複本。"""
+
+    def __init__(self, parent: Optional[QWidget] = None, lister=None,
+                 replica_factory=WindowReplicaWidget) -> None:
+        front_engine_logger.info("[WindowReplicaDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("window_replica_title", "Replicate a window"))
+        self._lister = lister or window_pin.list_windows
+        self._replica_factory = replica_factory
+        self.replica_widget_list: List[WindowReplicaWidget] = []
+
+        self.window_list = QListWidget()
+        self.window_list.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
+        self.refresh_button = tr(QPushButton(), "window_replica_refresh", "Refresh")
+        self.refresh_button.clicked.connect(self.reload_windows)
+        self.show_button = tr(QPushButton(), "window_replica_show", "Show replica")
+        self.show_button.clicked.connect(self.start_replica)
+
+        self.opacity_label = tr(QLabel(), "window_replica_opacity", "Opacity")
+        self.opacity_slider = QSlider(Qt.Orientation.Horizontal)
+        self.opacity_slider.setRange(10, 100)
+        self.opacity_slider.setValue(100)
+
+        hint_key, hint_fallback = (
+            ("window_replica_hint",
+             "A second window showing the chosen one live; the original stays where it "
+             "is. Drag the replica to move it, double-click it to close it. Windows only.")
+            if available() else
+            ("window_replica_unsupported", "Window replicas are 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)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.window_list, 0, 0, 1, 2)
+        layout.addWidget(self.refresh_button, 1, 0)
+        layout.addWidget(self.show_button, 1, 1)
+        layout.addWidget(self.opacity_label, 2, 0)
+        layout.addWidget(self.opacity_slider, 2, 1)
+        layout.addWidget(self.hint_label, 3, 0, 1, 2)
+        layout.addWidget(self.button_box, 4, 0, 1, 2)
+
+        self.show_button.setEnabled(available())
+        self.reload_windows()
+
+    def reload_windows(self) -> List[Tuple[int, str]]:
+        """重新抓一次視窗清單。"""
+        self.window_list.clear()
+        windows = self._lister() or []
+        for handle, title in windows:
+            item = QListWidgetItem(title)
+            item.setData(Qt.ItemDataRole.UserRole, int(handle))
+            self.window_list.addItem(item)
+        return windows
+
+    def selected(self) -> Optional[Tuple[int, str]]:
+        """目前選到的 (handle, 標題)；沒選就是 None。"""
+        item = self.window_list.currentItem()
+        if item is None:
+            return None
+        return int(item.data(Qt.ItemDataRole.UserRole)), item.text()
+
+    def start_replica(self) -> Optional[WindowReplicaWidget]:
+        """
+        對選到的視窗開一個複本。接不上就把它收掉再回 None——留一個永遠黑著的
+        小視窗在畫面上，比什麼都不做更糟。
+        Open a replica of the selected window. If it cannot attach, the widget is
+        closed and this returns None: leaving a permanently black window on
+        screen is worse than doing nothing.
+        """
+        chosen = self.selected()
+        if chosen is None:
+            return None
+        handle, title = chosen
+        replica = self._replica_factory(handle, title, self.opacity_slider.value(), None)
+        if not replica.start():
+            front_engine_logger.info(f"[WindowReplicaDialog] could not replicate {title!r}")
+            replica.close()
+            return None
+        self.replica_widget_list.append(replica)
+        return replica
+
+    def close_all(self) -> None:
+        """關掉這個對話框開過的所有複本。"""
+        for replica in list(self.replica_widget_list):
+            try:
+                replica.close()
+            except RuntimeError:  # pragma: no cover - 底層物件已消失
+                pass
+        self.replica_widget_list.clear()

{frontengine-1.0.64 → frontengine-1.0.66}/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",
     )
@@ -808,6 +888,10 @@ class FrontEngineMainUI(QMainWindow):
             self.widgets_setting_ui.stop_spectrum()
         if getattr(self, "tools_setting_ui", None) is not None:
             self.tools_setting_ui.release_pinned_windows()
+            # 複本註冊的是 DWM 縮圖，那是系統資源：視窗沒了也不會自己消失。
+            # A replica holds a DWM thumbnail, a system resource that does not
+            # go away just because the process is closing.
+            self.tools_setting_ui.close_replicas()
             self.tools_setting_ui.stop_camera()
             self.tools_setting_ui.stop_virtual_camera()
 

{frontengine-1.0.64 → frontengine-1.0.66}/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.64 → frontengine-1.0.66}/frontengine/ui/page/tools/tools_setting_ui.py

@@ -25,6 +25,7 @@ from frontengine.ui.dialog.screen_text_dialog import (
     ScreenTextDialog, ask_for_consent, has_consent,
 )
 from frontengine.ui.dialog.window_pin_dialog import WindowPinDialog
+from frontengine.ui.dialog.window_replica_dialog import WindowReplicaDialog
 from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
 from frontengine.ui.page.utils import coerce_int
 from frontengine.ui.page.layout_kit import SettingPage
@@ -85,6 +86,7 @@ class ToolsSettingUI(SettingPage):
         # raises RuntimeError on touch and "copy last" was a silent no-op.
         self.last_capture: Optional[QPixmap] = None
         self.pin_dialog: Optional[WindowPinDialog] = None
+        self.replica_dialog: Optional[WindowReplicaDialog] = None
 
         self._build_measure_row()
         self._build_capture_row()
@@ -95,6 +97,11 @@ class ToolsSettingUI(SettingPage):
         self.pin_button = tr(QPushButton(), "tools_pin_window", "Pin a window...")
         self.pin_button.clicked.connect(self.open_pin_dialog)
 
+        # 視窗複本：原視窗留在原地，另外開一個小視窗顯示它的即時畫面
+        # Window replica: the original stays put, a small window shows it live
+        self.replica_button = tr(QPushButton(), "tools_replicate_window", "Replicate a window...")
+        self.replica_button.clicked.connect(self.open_replica_dialog)
+
         # 視窗版面：記下每個視窗的位置，之後一鍵擺回去
         # Window layouts: remember where the windows are and put them back later.
         self.layout_label = tr(QLabel(), "tools_layout_label", "Window layout")
@@ -154,7 +161,7 @@ class ToolsSettingUI(SettingPage):
         windows.add_row("tools_name", self.layout_name_edit, "Name")
         windows.add_inline(self.layout_save_button)
         windows.add_row("tools_saved", self.layout_combobox, "Saved")
-        windows.add_inline(self.layout_restore_button, self.pin_button)
+        windows.add_inline(self.layout_restore_button, self.pin_button, self.replica_button)
 
         self.add_body_widget(self.hint_label)
         self.finish_body()
@@ -366,6 +373,20 @@ class ToolsSettingUI(SettingPage):
         self.pin_dialog.exec()
         return self.pin_dialog
 
+    def open_replica_dialog(self) -> WindowReplicaDialog:
+        """開視窗複本對話框（關掉主程式時會把開過的複本收乾淨）。"""
+        self.replica_dialog = WindowReplicaDialog(self)
+        self.replica_dialog.exec()
+        return self.replica_dialog
+
+    def close_replicas(self) -> None:
+        """關掉開過的視窗複本（主程式關閉時呼叫）。"""
+        if self.replica_dialog is not None:
+            try:
+                self.replica_dialog.close_all()
+            except RuntimeError:
+                self.replica_dialog = None
+
     def release_pinned_windows(self) -> None:
         """把釘過的別人視窗放開（主程式關閉時呼叫）。"""
         if self.pin_dialog is not None:

{frontengine-1.0.64 → frontengine-1.0.66}/frontengine/utils/multi_language/english.py

@@ -46,6 +46,19 @@ english_word_dict = {
     "tools_shape": "Shape",
     "tools_name": "Name",
     "tools_saved": "Saved",
+    "tools_replicate_window": "Replicate a window...",
+    "window_replica_title": "Replicate a window",
+    "window_replica_refresh": "Refresh",
+    "window_replica_show": "Show replica",
+    "window_replica_opacity": "Opacity",
+    "window_replica_hint": "A second window showing the chosen one live; the original stays where it is. Drag the replica to move it, double-click it to close it. Windows only.",
+    "window_replica_unsupported": "Window replicas are Windows only.",
+    "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.64 → frontengine-1.0.66}/frontengine/utils/multi_language/france.py

@@ -47,6 +47,19 @@ french_word_dict = {
     "tools_shape": "Forme",
     "tools_name": "Nom",
     "tools_saved": "Enregistrés",
+    "tools_replicate_window": "Dupliquer une fenêtre...",
+    "window_replica_title": "Dupliquer une fenêtre",
+    "window_replica_refresh": "Actualiser",
+    "window_replica_show": "Afficher le duplicata",
+    "window_replica_opacity": "Opacité",
+    "window_replica_hint": "Une seconde fenêtre affiche la fenêtre choisie en direct ; l'originale reste à sa place. Faites glisser pour la déplacer, double-cliquez pour la fermer. Windows uniquement.",
+    "window_replica_unsupported": "Les duplicatas de fenêtre sont réservés à Windows.",
+    "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.64 → frontengine-1.0.66}/frontengine/utils/multi_language/germany.py

@@ -47,6 +47,19 @@ germany_word_dict = {
     "tools_shape": "Form",
     "tools_name": "Name",
     "tools_saved": "Gespeichert",
+    "tools_replicate_window": "Fenster duplizieren...",
+    "window_replica_title": "Fenster duplizieren",
+    "window_replica_refresh": "Aktualisieren",
+    "window_replica_show": "Duplikat anzeigen",
+    "window_replica_opacity": "Deckkraft",
+    "window_replica_hint": "Ein zweites Fenster zeigt das gewählte live; das Original bleibt, wo es ist. Ziehen zum Verschieben, Doppelklick zum Schließen. Nur Windows.",
+    "window_replica_unsupported": "Fensterduplikate gibt es nur unter Windows.",
+    "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.64 → frontengine-1.0.66}/frontengine/utils/multi_language/italy.py

@@ -47,6 +47,19 @@ italian_word_dict = {
     "tools_shape": "Forma",
     "tools_name": "Nome",
     "tools_saved": "Salvati",
+    "tools_replicate_window": "Duplica una finestra...",
+    "window_replica_title": "Duplica una finestra",
+    "window_replica_refresh": "Aggiorna",
+    "window_replica_show": "Mostra il duplicato",
+    "window_replica_opacity": "Opacità",
+    "window_replica_hint": "Una seconda finestra mostra quella scelta in diretta; l'originale resta dov'è. Trascina per spostarla, doppio clic per chiuderla. Solo Windows.",
+    "window_replica_unsupported": "I duplicati di finestra sono solo per Windows.",
+    "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",