frontengine 1.0.48__tar.gz → 1.0.50__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.48
+Version: 1.0.50
 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
@@ -185,25 +185,6 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
-## Stream and gaming
-
-Four things on the **Stream** tab, for playing and for going live:
-
-- **Crosshair** — a cross, dot, circle or T shape in the middle of the screen,
-  in your colour and size. It is **only drawn on top**: nothing is injected,
-  no memory is read, no game file is touched. An exclusive-fullscreen game will
-  cover it, which is how the OS stacks windows.
-- **Teleprompter** — scroll a script at an adjustable speed and size, with a
-  mirror option for prompter glass. It stops at the last line rather than
-  snapping back mid-read.
-- **Soundboard** — up to twelve slots, each with a sound and an optional
-  hotkey. A file that has gone missing is dropped rather than kept as a dead
-  button.
-- **OBS** — switch scenes and toggle recording or streaming through OBS's own
-  WebSocket (built in since OBS 28). The password stays in your local settings.
-
----
-
 ## Signage, whiteboard and lip-sync
 
 - **Signage mode** (Settings) — rotate through a list of presets on a timer and

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

@@ -161,25 +161,6 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
-## Stream and gaming
-
-Four things on the **Stream** tab, for playing and for going live:
-
-- **Crosshair** — a cross, dot, circle or T shape in the middle of the screen,
-  in your colour and size. It is **only drawn on top**: nothing is injected,
-  no memory is read, no game file is touched. An exclusive-fullscreen game will
-  cover it, which is how the OS stacks windows.
-- **Teleprompter** — scroll a script at an adjustable speed and size, with a
-  mirror option for prompter glass. It stops at the last line rather than
-  snapping back mid-read.
-- **Soundboard** — up to twelve slots, each with a sound and an optional
-  hotkey. A file that has gone missing is dropped rather than kept as a dead
-  button.
-- **OBS** — switch scenes and toggle recording or streaming through OBS's own
-  WebSocket (built in since OBS 28). The password stays in your local settings.
-
----
-
 ## Signage, whiteboard and lip-sync
 
 - **Signage mode** (Settings) — rotate through a list of presets on a timer and

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/ui/main_ui.py

@@ -2,7 +2,7 @@ import os
 import sys
 from os import getcwd
 from pathlib import Path
-from typing import Dict, Optional, Type
+from typing import Any, Dict, Optional, Type
 
 from PySide6.QtCore import QByteArray, QTimer, QCoreApplication
 from PySide6.QtGui import QIcon, Qt
@@ -29,7 +29,6 @@ from frontengine.ui.page.scene_setting.scene_setting_ui import SceneSettingUI
 from frontengine.ui.page.presentation.presentation_setting_ui import PresentationSettingUI
 from frontengine.ui.page.screen_care.screen_care_setting_ui import ScreenCareSettingUI
 from frontengine.ui.page.sound_player.sound_player_setting_ui import SoundPlayerSettingUI
-from frontengine.ui.page.stream.stream_setting_ui import StreamSettingUI
 from frontengine.ui.page.text.text_setting_ui import TextSettingUI
 from frontengine.ui.page.tools.tools_setting_ui import ToolsSettingUI
 from frontengine.ui.page.video.video_setting_ui import VideoSettingUI
@@ -74,6 +73,20 @@ from frontengine.utils.theme_schedule.theme_schedule_service import ThemeSchedul
 FrontEngine_EXTEND_TAB: Dict[str, Type[QWidget]] = {}
 
 
+def tray_can_restore_window(window: Any) -> bool:
+    """
+    系統匣能不能把主視窗叫回來。任何「把主視窗藏起來」的功能都得先問這件事，
+    不然藏掉的就是唯一能把該功能關掉的畫面。
+    Whether the tray can bring the main window back. Anything that hides the
+    window has to ask first: otherwise what it hides is the only screen that
+    can turn that same thing off.
+    """
+    tray = getattr(window, "system_tray", None)
+    return bool(ExtendSystemTray.isSystemTrayAvailable()
+                and getattr(window, "show_system_tray_ray", False)
+                and tray is not None and tray.isVisible())
+
+
 class FrontEngineMainUI(QMainWindow):
     """
     FrontEngine 主視窗
@@ -136,7 +149,6 @@ class FrontEngineMainUI(QMainWindow):
         self.focus_setting_ui = FocusSettingUI()
         self.widgets_setting_ui = WidgetsSettingUI()
         self.tools_setting_ui = ToolsSettingUI()
-        self.stream_setting_ui = StreamSettingUI()
 
         # 控制中心
         # Control Center
@@ -321,9 +333,10 @@ class FrontEngineMainUI(QMainWindow):
         """
         sources = (
             (self.screen_care_setting_ui, ("filter_widget_list", "ruler_widget_list",
-                                           "break_overlay_list")),
+                                           "break_overlay_list", "color_vision_widget_list")),
             (self.presentation_setting_ui, ("annotation_widget_list", "cursor_widget_list",
-                                            "keystroke_widget_list", "magnifier_widget_list")),
+                                            "keystroke_widget_list", "magnifier_widget_list",
+                                            "whiteboard_widget_list")),
             (self.focus_setting_ui, ("dim_widget_list", "mask_widget_list")),
         )
         for page, attributes in sources:
@@ -334,6 +347,12 @@ class FrontEngineMainUI(QMainWindow):
         # The wallpaper page keys its widgets by monitor, so hand over the values.
         self.control_center_ui.register_overlay_source(
             lambda: list(self.wallpaper_setting_ui.wallpaper_widgets.values()))
+        self.control_center_ui.register_overlay_source(
+            lambda: getattr(self.web_setting_ui, "dashboard_widgets", []))
+        # 批次關閉之後，沒有覆蓋層在聽就把全域輸入監聽收掉
+        # After a batch close nothing is listening, so drop the global input hook.
+        self.control_center_ui.register_cleanup(
+            self.presentation_setting_ui.release_input_watch)
         for attribute in ("spectrum_widget_list", "monitor_widget_list",
                           "now_playing_widget_list", "note_widget_list"):
             self.control_center_ui.register_overlay_source(
@@ -341,9 +360,6 @@ class FrontEngineMainUI(QMainWindow):
         for attribute in ("measure_widget_list", "capture_widget_list", "camera_widget_list"):
             self.control_center_ui.register_overlay_source(
                 lambda attribute=attribute: getattr(self.tools_setting_ui, attribute, []))
-        for attribute in ("crosshair_widget_list", "teleprompter_widget_list"):
-            self.control_center_ui.register_overlay_source(
-                lambda attribute=attribute: getattr(self.stream_setting_ui, attribute, []))
 
     def _add_tabs(self) -> None:
         """加入所有內建與擴充的 Tab / Add all built-in and extended tabs"""
@@ -363,7 +379,6 @@ class FrontEngineMainUI(QMainWindow):
             (self.focus_setting_ui, "tab_focus_text"),
             (self.widgets_setting_ui, "tab_widgets_text"),
             (self.tools_setting_ui, "tab_tools_text"),
-            (self.stream_setting_ui, "tab_stream_text"),
             (self.control_center_ui, "tab_control_center_text"),
         ]
 
@@ -518,12 +533,28 @@ class FrontEngineMainUI(QMainWindow):
             self._handle_hotkey(action)
 
     def start_signage(self) -> Optional[str]:
-        """開始輪播；設定要求的話也把主視窗收起來。"""
+        """開始輪播；設定要求、而且托盤能把視窗叫回來時才收起主視窗。"""
         first = self.signage_service.start()
         if first is not None and current_signage_settings().get("hide_window", True):
-            self.hide()
+            self._hide_for_signage()
         return first
 
+    def _hide_for_signage(self) -> None:
+        """
+        收起主視窗——但只在系統匣真的能把它叫回來的時候。沒有系統匣就等於
+        把唯一能關掉輪播的畫面藏起來，重開也只會再被藏一次，使用者就只能去
+        手動改設定檔了。
+        Put the main window away - but only when the tray can actually bring it
+        back. Without a tray this would hide the only screen that can turn the
+        rotation off, and restarting just hides it again, leaving the settings
+        file as the only way out.
+        """
+        if tray_can_restore_window(self):
+            self.hide()
+            return
+        front_engine_logger.info(
+            "[FrontEngineMainUI] signage kept the window visible: no tray to restore it from")
+
     def stop_signage(self) -> None:
         """停止輪播並把主視窗放回來。"""
         self.signage_service.stop()
@@ -644,8 +675,6 @@ class FrontEngineMainUI(QMainWindow):
             self.tools_setting_ui.release_pinned_windows()
             self.tools_setting_ui.stop_camera()
             self.tools_setting_ui.stop_virtual_camera()
-        if getattr(self, "stream_setting_ui", None) is not None:
-            self.stream_setting_ui.soundboard.stop_all()
 
     def _clear_overlays(self) -> None:
         """清空各分頁記著的覆蓋層清單。"""

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/ui/page/control_center/control_center_ui.py

@@ -1,3 +1,5 @@
+from typing import Callable
+
 from PySide6.QtCore import QTimer, Qt
 from PySide6.QtWidgets import (
     QComboBox, QGridLayout, QLabel, QPushButton, QScrollArea, QTextEdit, QWidget,
@@ -93,6 +95,7 @@ class ControlCenterUI(QWidget):
         # 其他分頁登記進來的覆蓋層來源（桌布、專注、護眼、簡報…）
         # Overlay sources registered by the other pages: wallpaper, focus, screen care, presenting.
         self._extra_overlay_sources: list = []
+        self._cleanup_callbacks: list = []
         self.low_power_button = self._create_button(
             "control_center_low_power_on", self.toggle_low_power)
         self._hidden_from_capture = False
@@ -190,19 +193,29 @@ class ControlCenterUI(QWidget):
         self.scene_setting_ui.close_scene()
 
     def clear_all(self) -> None:
+        """
+        關閉所有覆蓋層。先真的 close() 再清空清單：close() 會跑到 closeEvent，
+        計時器、媒體、全域監聽才停得掉；只丟掉 Python 參考做不到這件事，而且
+        對「其他分頁註冊進來的」覆蓋層根本沒作用——它們會留在螢幕上。
+        Close every overlay. Actually call close() before emptying the lists:
+        that runs closeEvent, which is what stops timers, releases media and
+        drops global listeners. Merely dropping a Python reference does none of
+        that, and for the overlays other pages registered it did nothing at all
+        - they stayed on screen.
+        """
         front_engine_logger.info("ControlCenterUI clear_all")
-        self.video_setting_ui.video_widget_list.clear()
-        self.image_setting_ui.image_widget_list.clear()
-        self.web_setting_ui.web_widget_list.clear()
-        self.gif_setting_ui.gif_widget_list.clear()
-        self.sound_player_setting_ui.sound_widget_list.clear()
-        self.text_setting_ui.text_widget_list.clear()
-        self.particle_setting_ui.particle_list.clear()
-        if self.pet_setting_ui is not None:
-            self.pet_setting_ui.pet_list.clear()
+        self._for_each_overlay(lambda widget: widget.close())
+        for widget_list in self._all_overlay_widget_lists():
+            widget_list.clear()
         self.scene_setting_ui.close_scene()
+        for callback in self._cleanup_callbacks:
+            try:
+                callback()
+            except Exception as error:
+                front_engine_logger.warning(
+                    f"[ControlCenterUI] cleanup failed: {error!r}")
 
-    def register_overlay_source(self, provider) -> None:
+    def register_overlay_source(self, provider: Callable[[], list]) -> None:
         """
         讓控制中心也管得到其他分頁開的覆蓋層。provider 是一個回傳 widget 清單
         的函式（每次都重新問，才拿得到當下還活著的那些）。
@@ -212,6 +225,16 @@ class ControlCenterUI(QWidget):
         """
         self._extra_overlay_sources.append(provider)
 
+    def register_cleanup(self, callback: Callable[[], None]) -> None:
+        """
+        批次關閉之後要順手收掉的東西。例如全域輸入監聽：覆蓋層都關掉了就
+        沒有東西需要它，繼續掛著只是白吃資源。
+        Something to release after a batch close - a global input listener,
+        say: with every overlay gone nothing needs it, and leaving it hooked
+        just costs for nothing.
+        """
+        self._cleanup_callbacks.append(callback)
+
     def _all_overlay_widget_lists(self) -> list:
         """回傳所有覆蓋層 widget 清單 / All overlay widget lists."""
         lists = [
@@ -231,11 +254,15 @@ class ControlCenterUI(QWidget):
             except Exception as error:  # pragma: no cover - defensive boundary
                 front_engine_logger.warning(f"[ControlCenterUI] overlay source failed: {error!r}")
                 continue
+            # 交回原本的清單物件（不是複本），死掉的參考才清得掉、
+            # 「全部關閉」也才真的能把它們清空。
+            # Hand back the provider's own list rather than a copy, so pruning
+            # a dead reference - and closing everything - reaches the real one.
             if widgets:
-                lists.append(list(widgets))
+                lists.append(widgets if isinstance(widgets, list) else list(widgets))
         return lists
 
-    def _for_each_overlay(self, action) -> None:
+    def _for_each_overlay(self, action: Callable[[QWidget], None]) -> None:
         """
         對每個仍存活的覆蓋層 widget 執行 action(widget)。手動關閉的覆蓋層因
         WA_DeleteOnClose 已被銷毀，其 Python 參考仍留在清單中，呼叫時會

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/ui/page/presentation/presentation_setting_ui.py

@@ -6,7 +6,7 @@ The presentation page: screen annotation, cursor emphasis (ring, click ripple,
 spotlight), a keystroke display and a region magnifier. Everything except the
 annotation layer passes clicks straight through.
 """
-from typing import List
+from typing import List, Optional
 
 from PySide6.QtCore import Qt
 from PySide6.QtGui import QGuiApplication
@@ -181,7 +181,8 @@ class PresentationSettingUI(QWidget):
         if self.keystroke_widget_list or self.cursor_widget_list:
             self.input_watch.start()
 
-    def _release_input_watch(self) -> None:
+    def release_input_watch(self) -> None:
+        """沒有覆蓋層要聽了就收掉全域輸入監聽（批次關閉之後也會呼叫）。"""
         if not self.keystroke_widget_list and not self.cursor_widget_list:
             self.input_watch.stop()
 
@@ -250,7 +251,7 @@ class PresentationSettingUI(QWidget):
 
     def stop_cursor_effects(self) -> None:
         self._close_all(self.cursor_widget_list)
-        self._release_input_watch()
+        self.release_input_watch()
         self.cursor_button.setText(
             language_wrapper.language_word_dict.get("cursor_effect_start", "Turn cursor effects on"))
 
@@ -285,7 +286,7 @@ class PresentationSettingUI(QWidget):
 
     def stop_keystrokes(self) -> None:
         self._close_all(self.keystroke_widget_list)
-        self._release_input_watch()
+        self.release_input_watch()
         self.keystroke_button.setText(
             language_wrapper.language_word_dict.get("keystroke_start", "Show keystrokes"))
 
@@ -341,7 +342,6 @@ class PresentationSettingUI(QWidget):
             except RuntimeError:
                 self.magnifier_widget_list.remove(widget)
 
-    # --- preset state ----------------------------------------------------
     # --- whiteboard ------------------------------------------------------
     def toggle_whiteboard(self) -> None:
         if self.whiteboard_widget_list:
@@ -364,7 +364,7 @@ class PresentationSettingUI(QWidget):
         self.whiteboard_button.setText(
             language_wrapper.language_word_dict.get("whiteboard_start", "Whiteboard"))
 
-    def save_whiteboard(self):
+    def save_whiteboard(self) -> Optional[str]:
         """把白板存成圖片；沒畫東西就不存。"""
         for board in self.whiteboard_widget_list[:]:
             try:
@@ -377,6 +377,7 @@ class PresentationSettingUI(QWidget):
                 self.whiteboard_widget_list.remove(board)
         return None
 
+    # --- preset state ----------------------------------------------------
     def get_state(self) -> dict:
         return {
             "annotate_tool": self.annotate_tool_combobox.currentData(),

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/user_setting/user_setting_file.py

@@ -81,12 +81,6 @@ user_setting_dict: Dict[str, Any] = {
     # 是否同意把擷取畫面送到 Anthropic 讀取文字（預設不同意）
     # Consent to send captures to Anthropic for reading text (off by default).
     "screen_text_consent": False,
-    # 音效板：[{label, path, hotkey, volume}]
-    # Soundboard slots: [{label, path, hotkey, volume}]
-    "soundboard": [],
-    # OBS WebSocket 連線設定（密碼只留在本機設定檔）
-    # OBS WebSocket connection; the password stays in the local settings file.
-    "obs": {"host": "127.0.0.1", "port": 4455, "password": "", "scene": ""},
     # 覆蓋層畫質檔位：high / balanced / saver
     # Overlay quality tier: high / balanced / saver.
     "quality_tier": "high",

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/utils/multi_language/english.py

@@ -518,30 +518,6 @@ english_word_dict = {
     "screen_text_consent_body": "Reading text needs the captured area sent to Anthropic's API. It leaves this machine, and anything visible in the selection goes with it. Your own ANTHROPIC_API_KEY is used. Send captures?",
     "screen_text_no_key": 'Set {env} in your environment to use this.',
     "screen_text_ready": 'Captures are sent to Anthropic only while the box above is ticked.',
-    "tab_stream_text": 'Stream',
-    "stream_crosshair_label": 'Crosshair',
-    "stream_crosshair_cross": 'Cross',
-    "stream_crosshair_dot": 'Dot',
-    "stream_crosshair_circle": 'Circle',
-    "stream_crosshair_t": 'T shape',
-    "stream_crosshair_start": 'Show crosshair',
-    "stream_crosshair_stop": 'Hide crosshair',
-    "stream_teleprompter_label": 'Teleprompter',
-    "stream_teleprompter_script": 'Paste your script here',
-    "stream_teleprompter_mirror": 'Mirror',
-    "stream_teleprompter_start": 'Start prompter',
-    "stream_teleprompter_stop": 'Stop prompter',
-    "stream_sound_label": 'Soundboard',
-    "stream_sound_add": 'Add sound',
-    "stream_sound_remove": 'Remove',
-    "stream_sound_play": 'Play',
-    "stream_obs_label": 'OBS',
-    "stream_obs_password": 'WebSocket password',  # NOSONAR - a field label, not a credential
-    "stream_obs_scene": 'Scene name',
-    "stream_obs_switch": 'Switch scene',
-    "stream_obs_record": 'Toggle recording',
-    "stream_obs_stream": 'Toggle streaming',
-    "stream_hint": 'The crosshair is only drawn on top - no game is modified. OBS control uses its own WebSocket; the password is kept in your local settings.',
     "control_center_hide_from_capture": 'Hide from capture',
     "control_center_show_in_capture": 'Show in capture',
     "settings_menu_screen_privacy": 'Screen-sharing privacy...',

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/utils/multi_language/traditional_chinese.py

@@ -517,30 +517,6 @@ traditional_chinese_word_dict = {
     "screen_text_consent_body": '讀取文字需要把框選到的畫面送到 Anthropic 的 API。這份畫面會離開這台電腦，框選範圍內看得到的東西都會一起送出，使用的是你自己的 ANTHROPIC_API_KEY。要送出嗎？',
     "screen_text_no_key": '請先在環境變數設定 {env} 才能使用。',
     "screen_text_ready": '只有在上面那個選項打勾時，擷取畫面才會送到 Anthropic。',
-    "tab_stream_text": '直播',
-    "stream_crosshair_label": '準星',
-    "stream_crosshair_cross": '十字',
-    "stream_crosshair_dot": '點',
-    "stream_crosshair_circle": '圓環',
-    "stream_crosshair_t": 'T 字',
-    "stream_crosshair_start": '顯示準星',
-    "stream_crosshair_stop": '關閉準星',
-    "stream_teleprompter_label": '提詞機',
-    "stream_teleprompter_script": '把講稿貼在這裡',
-    "stream_teleprompter_mirror": '左右鏡像',
-    "stream_teleprompter_start": '開始提詞',
-    "stream_teleprompter_stop": '停止提詞',
-    "stream_sound_label": '音效板',
-    "stream_sound_add": '新增音效',
-    "stream_sound_remove": '移除',
-    "stream_sound_play": '播放',
-    "stream_obs_label": 'OBS',
-    "stream_obs_password": 'WebSocket 密碼',  # NOSONAR - a field label, not a credential
-    "stream_obs_scene": '場景名稱',
-    "stream_obs_switch": '切換場景',
-    "stream_obs_record": '切換錄影',
-    "stream_obs_stream": '切換直播',
-    "stream_hint": '準星只是疊在畫面上的一層，不會更動任何遊戲。OBS 控制走它自己的 WebSocket，密碼只留在本機設定檔裡。',
     "control_center_hide_from_capture": '分享時隱藏',
     "control_center_show_in_capture": '分享時顯示',
     "settings_menu_screen_privacy": '螢幕分享隱私…',

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/utils/remote/remote_server.py

@@ -24,7 +24,7 @@ import secrets
 import socket
 import threading
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any, Dict, Optional, Tuple
 from urllib.parse import parse_qs, urlparse
 
 from PySide6.QtCore import QObject, Signal
@@ -138,7 +138,6 @@ class RemoteServer(QObject):
         self._on_action = on_action
         self._server: Optional[ThreadingHTTPServer] = None
         self._thread: Optional[threading.Thread] = None
-        self.received: List[str] = []
 
     @property
     def running(self) -> bool:
@@ -192,7 +191,6 @@ class RemoteServer(QObject):
             return 403
         if not is_allowed(action):
             return 400
-        self.received.append(str(action))
         self.action_requested.emit(str(action))
         if self._on_action is not None:
             self._on_action(str(action))

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/utils/screen_privacy/capture_affinity.py

@@ -22,10 +22,13 @@ determined attacker, and it never hides the window from the person at the desk.
 from __future__ import annotations
 
 import sys
-from typing import Optional
+from typing import TYPE_CHECKING, Iterable, Optional
 
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 
+if TYPE_CHECKING:  # 只為了型別標註，執行時不需要把 Qt 拉進這支純 ctypes 工具
+    from PySide6.QtWidgets import QWidget
+
 # WDA_NONE：正常擷取；WDA_EXCLUDEFROMCAPTURE：擷取時整片留白
 # WDA_NONE captures normally; WDA_EXCLUDEFROMCAPTURE comes out blank.
 WDA_NONE = 0x00000000
@@ -92,7 +95,7 @@ def is_excluded_from_capture(handle: int) -> Optional[bool]:
         return None
 
 
-def apply_to_widget(widget, excluded: bool) -> bool:
+def apply_to_widget(widget: Optional[QWidget], excluded: bool) -> bool:
     """
     對一個 Qt widget 套用擷取可見性。視窗還沒建立原生 handle 時回傳 False，
     呼叫端可以等 show() 之後再試一次。
@@ -108,7 +111,7 @@ def apply_to_widget(widget, excluded: bool) -> bool:
     return set_excluded_from_capture(handle, excluded)
 
 
-def apply_to_widgets(widgets, excluded: bool) -> int:
+def apply_to_widgets(widgets: Optional[Iterable[QWidget]], excluded: bool) -> int:
     """對一批 widget 套用，回傳成功的數量。"""
     applied = 0
     for widget in tuple(widgets or ()):

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/utils/virtual_camera/camera_feed.py

@@ -46,7 +46,7 @@ class VirtualCameraFeed(QObject):
             return None
         return screen.grabWindow(0, rect.x(), rect.y(), rect.width(), rect.height())
 
-    def set_grabber(self, grabber) -> None:
+    def set_grabber(self, grabber: Optional[Callable[[QRect], Optional[QPixmap]]]) -> None:
         self._grabber = grabber or self._default_grabber
 
     def start(self, region: QRect, fps: int) -> bool:

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine/utils/virtual_camera/virtual_camera.py

@@ -15,7 +15,7 @@ False and the feature stays off; nothing is ever sent quietly.
 """
 from __future__ import annotations
 
-from typing import Optional, Tuple
+from typing import Any, Optional, Tuple
 
 import numpy
 
@@ -47,7 +47,7 @@ def available() -> bool:
     return _module() is not None
 
 
-def clamp_fps(value, fallback: int = DEFAULT_FPS) -> int:
+def clamp_fps(value: Any, fallback: int = DEFAULT_FPS) -> int:
     """每秒張數夾在驅動接受的範圍。"""
     try:
         return max(MIN_FPS, min(MAX_FPS, int(value)))
@@ -55,9 +55,9 @@ def clamp_fps(value, fallback: int = DEFAULT_FPS) -> int:
         return fallback
 
 
-def even_size(width, height) -> Tuple[int, int]:
+def even_size(width: Any, height: Any) -> Tuple[int, int]:
     """把尺寸調成偶數且不小於 2x2。"""
-    def fix(value, fallback):
+    def fix(value: Any, fallback: int) -> int:
         try:
             number = max(_SIZE_STEP, int(value))
         except (TypeError, ValueError):

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.48
+Version: 1.0.50
 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
@@ -185,25 +185,6 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
-## Stream and gaming
-
-Four things on the **Stream** tab, for playing and for going live:
-
-- **Crosshair** — a cross, dot, circle or T shape in the middle of the screen,
-  in your colour and size. It is **only drawn on top**: nothing is injected,
-  no memory is read, no game file is touched. An exclusive-fullscreen game will
-  cover it, which is how the OS stacks windows.
-- **Teleprompter** — scroll a script at an adjustable speed and size, with a
-  mirror option for prompter glass. It stops at the last line rather than
-  snapping back mid-read.
-- **Soundboard** — up to twelve slots, each with a sound and an optional
-  hotkey. A file that has gone missing is dropped rather than kept as a dead
-  button.
-- **OBS** — switch scenes and toggle recording or streaming through OBS's own
-  WebSocket (built in since OBS 28). The password stays in your local settings.
-
----
-
 ## Signage, whiteboard and lip-sync
 
 - **Signage mode** (Settings) — rotate through a list of presets on a timer and

{frontengine-1.0.48 → frontengine-1.0.50}/frontengine.egg-info/SOURCES.txt

@@ -21,8 +21,6 @@ frontengine/show/capture/__init__.py
 frontengine/show/capture/region_capture.py
 frontengine/show/focus_shield/__init__.py
 frontengine/show/focus_shield/focus_shield_widget.py
-frontengine/show/gaming/__init__.py
-frontengine/show/gaming/crosshair_widget.py
 frontengine/show/gif/__init__.py
 frontengine/show/gif/paint_gif.py
 frontengine/show/image/__init__.py
@@ -56,8 +54,6 @@ frontengine/show/sound_player/sound_effect.py
 frontengine/show/sound_player/sound_player.py
 frontengine/show/spectrum/__init__.py
 frontengine/show/spectrum/spectrum_widget.py
-frontengine/show/teleprompter/__init__.py
-frontengine/show/teleprompter/teleprompter_widget.py
 frontengine/show/text/__init__.py
 frontengine/show/text/draw_text.py
 frontengine/show/toast/__init__.py
@@ -126,8 +122,6 @@ frontengine/ui/page/screen_care/__init__.py
 frontengine/ui/page/screen_care/screen_care_setting_ui.py
 frontengine/ui/page/sound_player/__init__.py
 frontengine/ui/page/sound_player/sound_player_setting_ui.py
-frontengine/ui/page/stream/__init__.py
-frontengine/ui/page/stream/stream_setting_ui.py
 frontengine/ui/page/text/__init__.py
 frontengine/ui/page/text/text_setting_ui.py
 frontengine/ui/page/tools/__init__.py
@@ -208,10 +202,6 @@ frontengine/utils/multi_language/simplified_chinese.py
 frontengine/utils/multi_language/traditional_chinese.py
 frontengine/utils/now_playing/__init__.py
 frontengine/utils/now_playing/now_playing.py
-frontengine/utils/obs/__init__.py
-frontengine/utils/obs/obs_client.py
-frontengine/utils/obs/obs_protocol.py
-frontengine/utils/obs/websocket_frames.py
 frontengine/utils/pet_chat/__init__.py
 frontengine/utils/pet_chat/pet_chat_service.py
 frontengine/utils/platform_info/__init__.py
@@ -243,8 +233,6 @@ frontengine/utils/signage/signage_service.py
 frontengine/utils/smart_pause/__init__.py
 frontengine/utils/smart_pause/pause_rules.py
 frontengine/utils/smart_pause/smart_pause_service.py
-frontengine/utils/soundboard/__init__.py
-frontengine/utils/soundboard/soundboard.py
 frontengine/utils/system_stats/__init__.py
 frontengine/utils/system_stats/system_stats.py
 frontengine/utils/text_source/__init__.py

{frontengine-1.0.48 → frontengine-1.0.50}/pyproject.toml

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