frontengine 1.0.46__tar.gz → 1.0.48__tar.gz

{frontengine-1.0.46 → frontengine-1.0.48}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.46
+Version: 1.0.48
 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
@@ -143,6 +143,14 @@ Measuring and capture tools on the **Tools** tab:
   `hsl(...)` or a CSS custom property.
 - **Region capture** — drag out an area; it lands on the clipboard and can be
   saved to a file.
+- **Virtual camera** — drag out an area and send it, overlays and all, as a
+  webcam that Zoom, Teams or Discord can pick as their video source. Needs the
+  optional `pyvirtualcam` package and a virtual camera driver on the system
+  (OBS installs one); without either, the button says so rather than failing
+  quietly.
+- **Camera** — any video input works, including capture cards, and the device
+  list can be refreshed without restarting since cards are usually plugged in
+  while the app is already running.
 - **Read text** — drag out an area to copy the text in it, translate it, or ask
   a question about it.
   > This is the **only** feature here that sends screen content off the
@@ -196,6 +204,42 @@ Four things on the **Stream** tab, for playing and for going live:
 
 ---
 
+## Signage, whiteboard and lip-sync
+
+- **Signage mode** (Settings) — rotate through a list of presets on a timer and
+  put the main window away, for a machine left running as a display. The
+  rotation wraps, so it keeps cycling.
+- **Whiteboard** (Presenting tab) — an infinite canvas: drag with the middle
+  button to pan, scroll to zoom, and save what you drew as an image. Strokes
+  live in canvas coordinates, so panning and zooming leaves them where they
+  belong.
+- **Pet lip-sync** — the pet can react to your **microphone** instead of your
+  speakers, so it moves while you talk. Like the speaker reaction this reads
+  only the meter — a number, not sound. Windows only.
+
+---
+
+## Remote control
+
+From **Settings → Remote control**:
+
+- **Your phone** — turn it on and FrontEngine serves a small page on your local
+  network; open the link on a phone and the buttons drive the same actions the
+  global hotkeys do.
+  > This opens a port on your machine, so it is **off by default**. The link
+  > carries a token that is regenerated every time the server starts, so an old
+  > link stops working, and the page can only ask for the fixed action list —
+  > nothing else is reachable. It is plain HTTP: someone else on the same
+  > network could read the token and press the same buttons, which is a
+  > nuisance rather than a breach given what the buttons do, but leave it off
+  > on networks you do not trust.
+- **A MIDI controller** — press *Learn*, move a knob or pad, and bind it to an
+  action. It uses Windows' built-in winmm, so no extra package is needed. A
+  knob fires once it reaches the top rather than repeatedly on the way, and
+  releasing a pad does not count as a second press.
+
+---
+
 ## Screen-sharing privacy
 
 Your overlays are for you, not for the people you are sharing with. From

{frontengine-1.0.46 → frontengine-1.0.48}/README.md

@@ -119,6 +119,14 @@ Measuring and capture tools on the **Tools** tab:
   `hsl(...)` or a CSS custom property.
 - **Region capture** — drag out an area; it lands on the clipboard and can be
   saved to a file.
+- **Virtual camera** — drag out an area and send it, overlays and all, as a
+  webcam that Zoom, Teams or Discord can pick as their video source. Needs the
+  optional `pyvirtualcam` package and a virtual camera driver on the system
+  (OBS installs one); without either, the button says so rather than failing
+  quietly.
+- **Camera** — any video input works, including capture cards, and the device
+  list can be refreshed without restarting since cards are usually plugged in
+  while the app is already running.
 - **Read text** — drag out an area to copy the text in it, translate it, or ask
   a question about it.
   > This is the **only** feature here that sends screen content off the
@@ -172,6 +180,42 @@ Four things on the **Stream** tab, for playing and for going live:
 
 ---
 
+## Signage, whiteboard and lip-sync
+
+- **Signage mode** (Settings) — rotate through a list of presets on a timer and
+  put the main window away, for a machine left running as a display. The
+  rotation wraps, so it keeps cycling.
+- **Whiteboard** (Presenting tab) — an infinite canvas: drag with the middle
+  button to pan, scroll to zoom, and save what you drew as an image. Strokes
+  live in canvas coordinates, so panning and zooming leaves them where they
+  belong.
+- **Pet lip-sync** — the pet can react to your **microphone** instead of your
+  speakers, so it moves while you talk. Like the speaker reaction this reads
+  only the meter — a number, not sound. Windows only.
+
+---
+
+## Remote control
+
+From **Settings → Remote control**:
+
+- **Your phone** — turn it on and FrontEngine serves a small page on your local
+  network; open the link on a phone and the buttons drive the same actions the
+  global hotkeys do.
+  > This opens a port on your machine, so it is **off by default**. The link
+  > carries a token that is regenerated every time the server starts, so an old
+  > link stops working, and the page can only ask for the fixed action list —
+  > nothing else is reachable. It is plain HTTP: someone else on the same
+  > network could read the token and press the same buttons, which is a
+  > nuisance rather than a breach given what the buttons do, but leave it off
+  > on networks you do not trust.
+- **A MIDI controller** — press *Learn*, move a knob or pad, and bind it to an
+  action. It uses Windows' built-in winmm, so no extra package is needed. A
+  knob fires once it reaches the top rather than repeatedly on the way, and
+  releasing a pad does not count as a second press.
+
+---
+
 ## Screen-sharing privacy
 
 Your overlays are for you, not for the people you are sharing with. From

frontengine-1.0.48/frontengine/show/canvas/whiteboard_widget.py

@@ -0,0 +1,243 @@
+"""
+無限畫布白板：可以一直往外畫、拖曳平移、滾輪縮放，最後存成圖片。
+
+和簡報分頁的塗鴉層不同的是，筆畫存的是「畫布座標」而不是螢幕座標，所以平移
+縮放之後線條還在它原本該在的地方——這正是「無限」的意思。
+
+An infinite whiteboard: keep drawing outwards, drag to pan, scroll to zoom, and
+save the result as an image.
+
+Unlike the presenting page's annotation layer, strokes are stored in canvas
+coordinates rather than screen ones, so panning and zooming leaves them where
+they belong - which is what makes it infinite.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Tuple
+
+from PySide6.QtCore import QPoint, QPointF, QRectF, Qt
+from PySide6.QtGui import QColor, QImage, QPainter, QPen
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.show.window_helpers import apply_overlay_window_flags
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+DEFAULT_COLOR = "#ffd54f"
+DEFAULT_WIDTH = 4
+MIN_ZOOM = 0.2
+MAX_ZOOM = 5.0
+ZOOM_STEP = 1.15
+_SAVE_MARGIN = 24
+
+
+def clamp_zoom(value: Any, fallback: float = 1.0) -> float:
+    """縮放倍率夾在看得清楚又不會迷路的範圍。"""
+    try:
+        return max(MIN_ZOOM, min(MAX_ZOOM, float(value)))
+    except (TypeError, ValueError):
+        return fallback
+
+
+def to_canvas(point: Tuple[float, float], offset: Tuple[float, float], zoom: float) -> Tuple[float, float]:
+    """螢幕座標 -> 畫布座標。"""
+    scale = clamp_zoom(zoom)
+    return ((point[0] - offset[0]) / scale, (point[1] - offset[1]) / scale)
+
+
+def to_screen(point: Tuple[float, float], offset: Tuple[float, float], zoom: float) -> Tuple[float, float]:
+    """畫布座標 -> 螢幕座標。"""
+    scale = clamp_zoom(zoom)
+    return (point[0] * scale + offset[0], point[1] * scale + offset[1])
+
+
+def content_bounds(strokes: List[Dict[str, Any]]) -> Optional[Tuple[float, float, float, float]]:
+    """
+    所有筆畫涵蓋的畫布範圍 (left, top, right, bottom)；沒有筆畫回傳 None。
+    存檔時用它決定要輸出多大，才不會存出一大片空白。
+    The canvas area the strokes cover, or None when there are none. Saving uses
+    it to size the image, so the result is not mostly blank.
+    """
+    points = [point for stroke in strokes for point in stroke.get("points", [])]
+    if not points:
+        return None
+    xs = [point[0] for point in points]
+    ys = [point[1] for point in points]
+    return (min(xs), min(ys), max(xs), max(ys))
+
+
+class WhiteboardWidget(BaseWidget):
+    """
+    無限畫布。筆畫以畫布座標保存，畫的時候才換算成螢幕座標。
+    """
+
+    def __init__(self, color: str = DEFAULT_COLOR, width: int = DEFAULT_WIDTH) -> None:
+        front_engine_logger.info("[WhiteboardWidget] Init")
+        super().__init__()
+        candidate = QColor(color)
+        self.color = candidate if candidate.isValid() else QColor(DEFAULT_COLOR)
+        self.pen_width = max(1, int(width))
+        self.opacity = 1.0
+        self.overlay_lockable = False
+        self.strokes: List[Dict[str, Any]] = []
+        self.zoom = 1.0
+        self.offset = [0.0, 0.0]
+        self._stroke: Optional[Dict[str, Any]] = None
+        self._pan_origin: Optional[QPoint] = None
+        apply_overlay_window_flags(self, show_on_bottom=False, allow_input=True)
+
+    # --- drawing ---------------------------------------------------------
+    def begin_stroke(self, point: QPoint) -> None:
+        """開始一筆。"""
+        self._stroke = {"color": self.color.name(), "width": self.pen_width,
+                        "points": [to_canvas((point.x(), point.y()), self.offset, self.zoom)]}
+
+    def extend_stroke(self, point: QPoint) -> None:
+        if self._stroke is not None:
+            self._stroke["points"].append(to_canvas((point.x(), point.y()), self.offset, self.zoom))
+            self.update()
+
+    def end_stroke(self) -> bool:
+        """
+        收筆。只有一個點的「筆畫」是誤點，丟掉不留。
+        Finish. A one-point stroke is a stray click and is discarded.
+        """
+        stroke, self._stroke = self._stroke, None
+        if stroke is None or len(stroke["points"]) < 2:
+            return False
+        self.strokes.append(stroke)
+        self.update()
+        return True
+
+    def undo(self) -> bool:
+        """收回最後一筆。"""
+        if not self.strokes:
+            return False
+        self.strokes.pop()
+        self.update()
+        return True
+
+    def clear(self) -> None:
+        self.strokes = []
+        self._stroke = None
+        self.update()
+
+    def set_pen(self, color: Optional[str] = None, width: Optional[int] = None) -> None:
+        if color is not None:
+            candidate = QColor(color)
+            if candidate.isValid():
+                self.color = candidate
+        if width is not None:
+            self.pen_width = max(1, int(width))
+
+    # --- navigating ------------------------------------------------------
+    def pan(self, dx: float, dy: float) -> None:
+        """平移畫布。"""
+        self.offset[0] += float(dx)
+        self.offset[1] += float(dy)
+        self.update()
+
+    def zoom_at(self, point: QPoint, factor: float) -> float:
+        """
+        以游標為中心縮放：游標底下的那一點在縮放前後要停在原地，
+        不然放大時畫面會整個跑掉。
+        Zoom around the cursor so whatever is under it stays put; otherwise the
+        view lurches away every time you zoom.
+        """
+        before = to_canvas((point.x(), point.y()), self.offset, self.zoom)
+        self.zoom = clamp_zoom(self.zoom * float(factor))
+        after = to_screen(before, self.offset, self.zoom)
+        self.offset[0] += point.x() - after[0]
+        self.offset[1] += point.y() - after[1]
+        self.update()
+        return self.zoom
+
+    def reset_view(self) -> None:
+        """回到原點與原始比例（筆畫都還在）。"""
+        self.zoom = 1.0
+        self.offset = [0.0, 0.0]
+        self.update()
+
+    # --- events ----------------------------------------------------------
+    def mousePressEvent(self, event) -> None:
+        if event.button() == Qt.MouseButton.LeftButton:
+            self.begin_stroke(event.position().toPoint())
+        elif event.button() == Qt.MouseButton.MiddleButton:
+            self._pan_origin = event.position().toPoint()
+        super().mousePressEvent(event)
+
+    def mouseMoveEvent(self, event) -> None:
+        point = event.position().toPoint()
+        if self._pan_origin is not None:
+            self.pan(point.x() - self._pan_origin.x(), point.y() - self._pan_origin.y())
+            self._pan_origin = point
+        else:
+            self.extend_stroke(point)
+        super().mouseMoveEvent(event)
+
+    def mouseReleaseEvent(self, event) -> None:
+        if event.button() == Qt.MouseButton.MiddleButton:
+            self._pan_origin = None
+        else:
+            self.end_stroke()
+        super().mouseReleaseEvent(event)
+
+    def wheelEvent(self, event) -> None:
+        step = ZOOM_STEP if event.angleDelta().y() > 0 else 1.0 / ZOOM_STEP
+        self.zoom_at(event.position().toPoint(), step)
+
+    # --- output ----------------------------------------------------------
+    def save_image(self, path: str) -> Optional[str]:
+        """
+        把所有筆畫存成一張圖（只涵蓋畫過的範圍）。沒有筆畫就不存，回傳 None。
+        Save the strokes as an image covering only the area drawn on. Nothing
+        drawn means nothing saved.
+        """
+        bounds = content_bounds(self.strokes)
+        if bounds is None:
+            return None
+        left, top, right, bottom = bounds
+        width = int(right - left) + _SAVE_MARGIN * 2
+        height = int(bottom - top) + _SAVE_MARGIN * 2
+        image = QImage(max(1, width), max(1, height), QImage.Format.Format_ARGB32)
+        image.fill(Qt.GlobalColor.transparent)
+        painter = QPainter(image)
+        painter.setRenderHint(QPainter.RenderHint.Antialiasing, True)
+        for stroke in self.strokes:
+            self._paint_stroke(painter, stroke,
+                               offset=(_SAVE_MARGIN - left, _SAVE_MARGIN - top), zoom=1.0)
+        painter.end()
+        target = Path(path)
+        try:
+            target.parent.mkdir(parents=True, exist_ok=True)
+            if not image.save(str(target)):
+                return None
+        except OSError as error:
+            front_engine_logger.warning(f"[WhiteboardWidget] save failed: {error!r}")
+            return None
+        front_engine_logger.info(f"[WhiteboardWidget] saved | {target}")
+        return str(target)
+
+    def _paint_stroke(self, painter: QPainter, stroke: Dict[str, Any],
+                      offset, zoom: float) -> None:
+        points = stroke.get("points", [])
+        if len(points) < 2:
+            return
+        pen = QPen(QColor(stroke.get("color", DEFAULT_COLOR)),
+                   max(1.0, float(stroke.get("width", DEFAULT_WIDTH)) * zoom))
+        pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+        pen.setJoinStyle(Qt.PenJoinStyle.RoundJoin)
+        painter.setPen(pen)
+        previous = to_screen(points[0], offset, zoom)
+        for point in points[1:]:
+            current = to_screen(point, offset, zoom)
+            painter.drawLine(QPointF(*previous), QPointF(*current))
+            previous = current
+
+    def draw_content(self, painter: QPainter) -> None:
+        painter.setRenderHint(QPainter.RenderHint.Antialiasing, True)
+        painter.fillRect(QRectF(self.rect()), QColor(0, 0, 0, 120))
+        for stroke in self.strokes:
+            self._paint_stroke(painter, stroke, self.offset, self.zoom)
+        if self._stroke is not None:
+            self._paint_stroke(painter, self._stroke, self.offset, self.zoom)

frontengine-1.0.48/frontengine/ui/dialog/remote_control_dialog.py

@@ -0,0 +1,207 @@
+"""
+遙控設定：手機網頁遙控與 MIDI 控制器。
+
+手機遙控會在這台機器上開一個網路埠，所以預設關閉、每次啟動換新權杖、
+只接受固定的動作清單——這些在畫面上都寫清楚，不藏在文件裡。
+
+Remote control settings: the phone web remote and a MIDI controller.
+
+The phone remote opens a network port on this machine, so it is off by default,
+mints a fresh token at every start and only accepts a fixed list of actions -
+all of which the dialog says out loud rather than hiding in the docs.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from PySide6.QtGui import QGuiApplication
+from PySide6.QtWidgets import (
+    QAbstractItemView, QCheckBox, QComboBox, QDialog, QDialogButtonBox, QGridLayout, QLabel,
+    QPushButton, QTableWidget, QTableWidgetItem, 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.midi.midi_input import available as midi_available, list_devices
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.remote.remote_server import ALLOWED_ACTIONS
+
+MIDI_KEY = "midi_bindings"
+REMOTE_KEY = "phone_remote"
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+def current_bindings() -> Dict[str, str]:
+    """設定裡的 {MIDI 鍵: 動作}，只留允許清單裡的動作。"""
+    stored = user_setting_dict.get(MIDI_KEY)
+    if not isinstance(stored, dict):
+        return {}
+    return {str(key): str(value) for key, value in stored.items()
+            if str(value) in ALLOWED_ACTIONS}
+
+
+def remote_enabled() -> bool:
+    settings = user_setting_dict.get(REMOTE_KEY)
+    return bool(settings.get("enabled")) if isinstance(settings, dict) else False
+
+
+class RemoteControlDialog(QDialog):
+    """設定手機遙控與 MIDI 綁定。"""
+
+    def __init__(self, parent: Optional[QWidget] = None, remote=None, midi=None) -> None:
+        front_engine_logger.info("[RemoteControlDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("remote_title", "Remote control"))
+        self._remote = remote
+        self._midi = midi
+        self._learning = False
+
+        self.remote_checkbox = QCheckBox(_t("remote_enable", "Let my phone control FrontEngine"))
+        self.remote_checkbox.setChecked(remote_enabled())
+        self.remote_checkbox.toggled.connect(self._toggle_remote)
+        self.remote_url_label = QLabel(self.remote_status())
+        self.remote_url_label.setWordWrap(True)
+        self.remote_url_label.setTextInteractionFlags(
+            self.remote_url_label.textInteractionFlags().TextSelectableByMouse)
+        self.remote_copy_button = QPushButton(_t("remote_copy", "Copy link"))
+        self.remote_copy_button.clicked.connect(self.copy_link)
+        self.remote_hint = QLabel(
+            _t("remote_hint",
+               "This opens a port on this machine for your local network. The link carries a "
+               "one-time token that changes every time it starts, and only the buttons on the "
+               "page can be triggered - nothing else. It is plain HTTP, so treat it like any "
+               "other device on your network: someone else on the same network could read the "
+               "token and press the same buttons. Leave it off on networks you do not trust."))
+        self.remote_hint.setWordWrap(True)
+
+        self.midi_label = QLabel(_t("remote_midi_label", "MIDI controller"))
+        self.midi_combobox = QComboBox()
+        for index, name in list_devices():
+            self.midi_combobox.addItem(name, index)
+        if self.midi_combobox.count() == 0:
+            self.midi_combobox.addItem(_t("remote_midi_none", "No MIDI device found"), -1)
+        self.learn_button = QPushButton(_t("remote_midi_learn", "Learn"))
+        self.learn_button.clicked.connect(self.start_learning)
+        self.learn_button.setEnabled(midi_available())
+        self.remove_button = QPushButton(_t("remote_midi_remove", "Remove"))
+        self.remove_button.clicked.connect(self.remove_selected)
+
+        self.table = QTableWidget(0, 2)
+        self.table.setHorizontalHeaderLabels([
+            _t("remote_midi_control_column", "Control"),
+            _t("remote_midi_action_column", "Action"),
+        ])
+        self.table.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectRows)
+        self.table.horizontalHeader().setStretchLastSection(True)
+
+        self.button_box = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Ok | QDialogButtonBox.StandardButton.Cancel)
+        self.button_box.accepted.connect(self.accept)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.remote_checkbox, 0, 0, 1, 3)
+        layout.addWidget(self.remote_url_label, 1, 0, 1, 2)
+        layout.addWidget(self.remote_copy_button, 1, 2)
+        layout.addWidget(self.remote_hint, 2, 0, 1, 3)
+        layout.addWidget(self.midi_label, 3, 0)
+        layout.addWidget(self.midi_combobox, 3, 1, 1, 2)
+        layout.addWidget(self.table, 4, 0, 1, 3)
+        layout.addWidget(self.learn_button, 5, 0)
+        layout.addWidget(self.remove_button, 5, 1)
+        layout.addWidget(self.button_box, 6, 0, 1, 3)
+
+        for control, action in current_bindings().items():
+            self.add_row(control, action)
+
+    # --- phone remote ----------------------------------------------------
+    def remote_status(self) -> str:
+        """目前該在手機上開什麼；沒開啟就說明它是關著的。"""
+        if self._remote is None or not getattr(self._remote, "running", False):
+            return _t("remote_off", "Off - nothing is listening.")
+        return self._remote.url()
+
+    def copy_link(self) -> bool:
+        """把連結複製起來，方便貼到手機上。"""
+        if self._remote is None or not getattr(self._remote, "running", False):
+            return False
+        clipboard = QGuiApplication.clipboard()
+        if clipboard is None:  # pragma: no cover - no clipboard at all
+            return False
+        clipboard.setText(self._remote.url())
+        return True
+
+    def _toggle_remote(self, enabled: bool) -> None:
+        user_setting_dict[REMOTE_KEY] = {"enabled": bool(enabled)}
+        write_user_setting()
+        if self._remote is None:
+            return
+        if enabled:
+            self._remote.start()
+        else:
+            self._remote.stop()
+        self.remote_url_label.setText(self.remote_status())
+
+    # --- MIDI bindings ---------------------------------------------------
+    def add_row(self, control: str = "", action: str = "") -> None:
+        """加一列綁定。"""
+        row = self.table.rowCount()
+        self.table.insertRow(row)
+        self.table.setItem(row, 0, QTableWidgetItem(str(control)))
+        combobox = QComboBox()
+        combobox.addItems(list(ALLOWED_ACTIONS))
+        if action in ALLOWED_ACTIONS:
+            combobox.setCurrentText(action)
+        self.table.setCellWidget(row, 1, combobox)
+
+    def start_learning(self) -> None:
+        """按下之後，下一個收到的 MIDI 訊息就會變成新的一列。"""
+        self._learning = True
+        self.learn_button.setText(_t("remote_midi_listening", "Press a control..."))
+
+    @property
+    def learning(self) -> bool:
+        return self._learning
+
+    def learn(self, control: str) -> bool:
+        """收到 MIDI 訊息時由主視窗呼叫；沒在學習狀態就忽略。"""
+        if not self._learning:
+            return False
+        self._learning = False
+        self.learn_button.setText(_t("remote_midi_learn", "Learn"))
+        self.add_row(control, ALLOWED_ACTIONS[0])
+        return True
+
+    def remove_selected(self) -> bool:
+        row = self.table.currentRow()
+        if row < 0:
+            return False
+        self.table.removeRow(row)
+        return True
+
+    def bindings(self) -> Dict[str, str]:
+        """目前表格上的綁定。"""
+        bindings: Dict[str, str] = {}
+        for row in range(self.table.rowCount()):
+            item = self.table.item(row, 0)
+            combobox = self.table.cellWidget(row, 1)
+            control = item.text().strip() if item else ""
+            action = combobox.currentText() if combobox else ""
+            if control and action in ALLOWED_ACTIONS:
+                bindings[control] = action
+        return bindings
+
+    def midi_device(self) -> Any:
+        """選到的 MIDI 裝置索引。"""
+        return self.midi_combobox.currentData()
+
+    def accept(self) -> None:
+        bindings = self.bindings()
+        user_setting_dict[MIDI_KEY] = bindings
+        user_setting_dict["midi_device"] = self.midi_device()
+        write_user_setting()
+        front_engine_logger.info(f"[RemoteControlDialog] saved | {len(bindings)} binding(s)")
+        super().accept()

frontengine-1.0.48/frontengine/ui/dialog/signage_dialog.py

@@ -0,0 +1,100 @@
+"""
+看板模式設定：依序輪播一組預設集，適合把機器擺著當展示螢幕。
+
+Signage settings: rotate through a set of presets, for a machine left running
+as a display.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from PySide6.QtWidgets import (
+    QCheckBox, QDialog, QDialogButtonBox, QGridLayout, QLabel, QPlainTextEdit, 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.signage.signage_service import (
+    DEFAULT_INTERVAL_MINUTES, MAX_INTERVAL_MINUTES, MIN_INTERVAL_MINUTES, clamp_interval,
+    normalize_playlist,
+)
+
+SETTING_KEY = "signage"
+DEFAULT_SETTINGS: Dict[str, Any] = {
+    "enabled": False, "presets": [], "interval_minutes": DEFAULT_INTERVAL_MINUTES,
+    "hide_window": True,
+}
+
+
+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_SETTINGS)
+    if isinstance(stored, dict):
+        settings.update({key: stored[key] for key in DEFAULT_SETTINGS if key in stored})
+    settings["presets"] = normalize_playlist(settings.get("presets"))
+    settings["interval_minutes"] = clamp_interval(settings.get("interval_minutes"))
+    return settings
+
+
+class SignageDialog(QDialog):
+    """設定要輪播哪些預設集、多久換一次。"""
+
+    def __init__(self, parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info("[SignageDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("signage_title", "Signage mode"))
+        settings = current_settings()
+
+        self.enable_checkbox = QCheckBox(_t("signage_enable", "Rotate presets"))
+        self.enable_checkbox.setChecked(bool(settings.get("enabled")))
+        self.presets_label = QLabel(_t("signage_presets_label", "Presets, one per line:"))
+        self.presets_edit = QPlainTextEdit("\n".join(settings.get("presets", [])))
+        self.interval_label = QLabel(_t("signage_interval_label", "Change every (minutes)"))
+        self.interval_spinbox = QSpinBox()
+        self.interval_spinbox.setRange(MIN_INTERVAL_MINUTES, MAX_INTERVAL_MINUTES)
+        self.interval_spinbox.setValue(settings.get("interval_minutes"))
+        self.hide_checkbox = QCheckBox(
+            _t("signage_hide_window", "Hide the main window while rotating"))
+        self.hide_checkbox.setChecked(bool(settings.get("hide_window", True)))
+        self.hint_label = QLabel(
+            _t("signage_hint",
+               "Presets are saved from the Presets menu. The rotation wraps at the end, so a "
+               "machine left running keeps cycling."))
+        self.hint_label.setWordWrap(True)
+
+        self.button_box = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Ok | QDialogButtonBox.StandardButton.Cancel)
+        self.button_box.accepted.connect(self.accept)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.enable_checkbox, 0, 0, 1, 2)
+        layout.addWidget(self.presets_label, 1, 0, 1, 2)
+        layout.addWidget(self.presets_edit, 2, 0, 1, 2)
+        layout.addWidget(self.interval_label, 3, 0)
+        layout.addWidget(self.interval_spinbox, 3, 1)
+        layout.addWidget(self.hide_checkbox, 4, 0, 1, 2)
+        layout.addWidget(self.hint_label, 5, 0, 1, 2)
+        layout.addWidget(self.button_box, 6, 0, 1, 2)
+
+    def settings(self) -> Dict[str, Any]:
+        """對話框上目前的設定。"""
+        return {
+            "enabled": self.enable_checkbox.isChecked(),
+            "presets": normalize_playlist(self.presets_edit.toPlainText()),
+            "interval_minutes": self.interval_spinbox.value(),
+            "hide_window": self.hide_checkbox.isChecked(),
+        }
+
+    def accept(self) -> None:
+        settings = self.settings()
+        user_setting_dict[SETTING_KEY] = settings
+        write_user_setting()
+        front_engine_logger.info(f"[SignageDialog] saved | {len(settings['presets'])} preset(s)")
+        super().accept()