remotedesktop 1.9.1__tar.gz → 1.9.3__tar.gz

{remotedesktop-1.9.1 → remotedesktop-1.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remotedesktop
-Version: 1.9.1
+Version: 1.9.3
 Summary: Remote desktop app for Windows computers on the same LAN, with autodiscovery. View other computers and optionally share this one — screen, keyboard, mouse, and clipboard, without RDP or Microsoft authentication.
 Project-URL: Homepage, https://github.com/jamesabel/remotedesktop
 Project-URL: Repository, https://github.com/jamesabel/remotedesktop
@@ -74,11 +74,14 @@ one-click *Forget* / *Revoke*, and the live connection log.
 - 🔍 **Autodiscovery** — sharing computers announce themselves over UDP; the app lists every one on the LAN at startup, no addresses to type (press *Refresh* or F5 to rescan).
 - 🗂️ **Multiple computers at once** — view and control several computers simultaneously, each in its own tab named for that computer; the window title shows who you're connected to, even minimized.
 - 🖥️ **Lossless screen sharing** — pixel-exact at full resolution, DXGI desktop-duplication capture (~10 ms per 4K frame), and inter-frame delta compression: an unchanged screen sends nothing.
+- ⚡ **Fewer frames to send while sharing** — while at least one viewer is connected, Windows animations, menu fades, and shadows are turned off on the shared computer so the stream snaps instead of smearing; everything is restored the moment the last viewer leaves, and nothing is permanently changed (a recommended, default-on preference).
 - ⌨️🖱️ **Full input control** — mouse, wheel, and keyboard forwarding that is safe against interruptions: anything still held down is released on the server if the viewer loses focus or disconnects, so no stuck keys. Prefer eyes-only? Choose *Shared, view only* and sharing becomes view-only, switchable live.
+- 🖲️ **Cursor shape mirroring** — the pointer is never burned into the captured frame; instead your own cursor takes the remote cursor's shape (an I-beam over text, resize arrows on a window edge), so it is always crisp and lag-free.
 - 🖼️ **View your way** — each connection scales to fit or shows the remote screen at 1:1 pixels with panning, and F11 goes full screen. While you type into a remote session every key is forwarded — F11 is the one key that stays local.
 - 📋 **Two-way clipboard** — text and images copied on either machine appear on the other; a Preferences toggle turns syncing off entirely.
 - 📸 **Screen captures** — grab the remote screen at its full resolution and copy it to the clipboard or save it as a PNG, from the *Screen capture* panel buttons or the File menu.
 - 🔒 **TLS + approve-once pairing** — every connection is encrypted; the server user approves a new client once, after which it reconnects with a stored token and no prompt.
+- 🔐 **Honest lock-screen behavior** — a locked server tells viewers so with a clear on-screen notice instead of a frozen frame, and streaming resumes by itself once someone signs in at the machine (see [The Windows lock screen](#the-windows-lock-screen)).
 - 📊 **Built-in performance monitoring** — live bandwidth and round-trip-time graphs with window statistics (mean/min/max/p99/jitter), plus a per-viewer table on the server.
 - 🔁 **Robust connections** — dead connections are detected within seconds, and dropped sessions reconnect automatically with backoff; a server restart heals by itself, no clicks needed. Connections that were open when the app closed are restored on the next start.
 - 🚀 **Hands-off operation** — optional start-at-login (per-user, no admin rights), close-to-tray while sharing (the screen stays available with the window closed), and a *Restart app* button usable from the remote session itself, so you can update the software without visiting the machine.
@@ -178,7 +181,10 @@ an idle screen costs essentially nothing. When duplication is unavailable
 or gets lost — the secure desktop (UAC/logon screen), an RDP session, a
 display-mode change — the server transparently falls back to Qt's
 `QScreen.grabWindow` (~96 ms per frame) and keeps retrying duplication in
-the background.
+the background. The captured frame never contains the mouse pointer;
+instead the server reports the current cursor's *shape* whenever it
+changes, and each client mirrors it on its own local cursor — which is why
+the pointer you see is always sharp and moves with zero latency.
 
 **Screen transfer.** Frames are captured at up to 30 fps and compared with
 the previous capture in 64-row bands; only the bands that changed are

{remotedesktop-1.9.1 → remotedesktop-1.9.3}/readme.md

@@ -50,11 +50,14 @@ one-click *Forget* / *Revoke*, and the live connection log.
 - 🔍 **Autodiscovery** — sharing computers announce themselves over UDP; the app lists every one on the LAN at startup, no addresses to type (press *Refresh* or F5 to rescan).
 - 🗂️ **Multiple computers at once** — view and control several computers simultaneously, each in its own tab named for that computer; the window title shows who you're connected to, even minimized.
 - 🖥️ **Lossless screen sharing** — pixel-exact at full resolution, DXGI desktop-duplication capture (~10 ms per 4K frame), and inter-frame delta compression: an unchanged screen sends nothing.
+- ⚡ **Fewer frames to send while sharing** — while at least one viewer is connected, Windows animations, menu fades, and shadows are turned off on the shared computer so the stream snaps instead of smearing; everything is restored the moment the last viewer leaves, and nothing is permanently changed (a recommended, default-on preference).
 - ⌨️🖱️ **Full input control** — mouse, wheel, and keyboard forwarding that is safe against interruptions: anything still held down is released on the server if the viewer loses focus or disconnects, so no stuck keys. Prefer eyes-only? Choose *Shared, view only* and sharing becomes view-only, switchable live.
+- 🖲️ **Cursor shape mirroring** — the pointer is never burned into the captured frame; instead your own cursor takes the remote cursor's shape (an I-beam over text, resize arrows on a window edge), so it is always crisp and lag-free.
 - 🖼️ **View your way** — each connection scales to fit or shows the remote screen at 1:1 pixels with panning, and F11 goes full screen. While you type into a remote session every key is forwarded — F11 is the one key that stays local.
 - 📋 **Two-way clipboard** — text and images copied on either machine appear on the other; a Preferences toggle turns syncing off entirely.
 - 📸 **Screen captures** — grab the remote screen at its full resolution and copy it to the clipboard or save it as a PNG, from the *Screen capture* panel buttons or the File menu.
 - 🔒 **TLS + approve-once pairing** — every connection is encrypted; the server user approves a new client once, after which it reconnects with a stored token and no prompt.
+- 🔐 **Honest lock-screen behavior** — a locked server tells viewers so with a clear on-screen notice instead of a frozen frame, and streaming resumes by itself once someone signs in at the machine (see [The Windows lock screen](#the-windows-lock-screen)).
 - 📊 **Built-in performance monitoring** — live bandwidth and round-trip-time graphs with window statistics (mean/min/max/p99/jitter), plus a per-viewer table on the server.
 - 🔁 **Robust connections** — dead connections are detected within seconds, and dropped sessions reconnect automatically with backoff; a server restart heals by itself, no clicks needed. Connections that were open when the app closed are restored on the next start.
 - 🚀 **Hands-off operation** — optional start-at-login (per-user, no admin rights), close-to-tray while sharing (the screen stays available with the window closed), and a *Restart app* button usable from the remote session itself, so you can update the software without visiting the machine.
@@ -154,7 +157,10 @@ an idle screen costs essentially nothing. When duplication is unavailable
 or gets lost — the secure desktop (UAC/logon screen), an RDP session, a
 display-mode change — the server transparently falls back to Qt's
 `QScreen.grabWindow` (~96 ms per frame) and keeps retrying duplication in
-the background.
+the background. The captured frame never contains the mouse pointer;
+instead the server reports the current cursor's *shape* whenever it
+changes, and each client mirrors it on its own local cursor — which is why
+the pointer you see is always sharp and moves with zero latency.
 
 **Screen transfer.** Frames are captured at up to 30 fps and compared with
 the previous capture in 64-row bands; only the bands that changed are

{remotedesktop-1.9.1 → remotedesktop-1.9.3}/src/remotedesktop/__init__.py

@@ -1,3 +1,3 @@
 """Remote desktop client/server for Windows computers on the same LAN."""
 
-__version__ = "1.9.1"
+__version__ = "1.9.3"

{remotedesktop-1.9.1 → remotedesktop-1.9.3}/src/remotedesktop/logs.py

@@ -16,7 +16,7 @@ import logging.handlers
 from pathlib import Path
 
 import platformdirs
-from PySide6.QtCore import Qt
+from PySide6.QtCore import QMessageLogContext, Qt, QtMsgType, qInstallMessageHandler
 from PySide6.QtWidgets import QDialog, QPlainTextEdit, QVBoxLayout, QWidget
 
 # Cap on what a peer gets when it asks for our log: the most recent entries
@@ -70,12 +70,39 @@ class PeerLogDialog(QDialog):
         layout.addWidget(view)
 
 
+_QT_LEVELS = {
+    QtMsgType.QtDebugMsg: logging.DEBUG,
+    QtMsgType.QtInfoMsg: logging.INFO,
+    QtMsgType.QtWarningMsg: logging.WARNING,
+    QtMsgType.QtCriticalMsg: logging.ERROR,
+    QtMsgType.QtFatalMsg: logging.CRITICAL,
+}
+
+
+def _qt_message_handler(
+    mode: QtMsgType, context: QMessageLogContext, message: str
+) -> None:
+    # Category ("qt.qpa.mime", ...) is how Qt names the subsystem; file/line
+    # are only populated in debug builds of Qt, so they aren't included.
+    category = context.category
+    if category and category != "default":
+        message = f"{category}: {message}"
+    logging.getLogger("remotedesktop.qt").log(
+        _QT_LEVELS.get(mode, logging.WARNING), message
+    )
+
+
 def init_logging(app_name: str, *, directory: Path | None = None) -> Path:
     """Write "remotedesktop" logger output to <log dir>/<app_name>.log.
 
+    Also routes Qt's own log output (e.g. "qt.qpa.mime: Retrying to obtain
+    clipboard.") into the same file: Qt's default message handler writes to
+    stderr, which a GUI app must never do.
+
     Returns the log file path. `directory` exists for tests; the apps use
     the platformdirs log dir.
     """
+    qInstallMessageHandler(_qt_message_handler)
     log_dir = directory if directory is not None else default_log_dir()
     log_dir.mkdir(parents=True, exist_ok=True)
     path = log_path(app_name, directory=directory)

{remotedesktop-1.9.1 → remotedesktop-1.9.3}/src/remotedesktop/preferences.py

@@ -118,6 +118,10 @@ class PreferencesTab(QWidget):
         )
         self._autostart = autostart if autostart is not None else Autostart()
         self.history_minutes = QSpinBox()
+        self.history_minutes.setToolTip(
+            "How much recent history the Performance tab's bandwidth and\n"
+            "round-trip-time graphs (and their statistics) cover."
+        )
         self.history_minutes.setRange(1, 30)
         self.history_minutes.setSuffix(" min")
         self.history_minutes.setValue(
@@ -125,23 +129,35 @@ class PreferencesTab(QWidget):
         )
         self.history_minutes.valueChanged.connect(self._on_history_changed)
         self.autostart_checkbox = QCheckBox("Start Remote Desktop when I log in to Windows")
+        self.autostart_checkbox.setToolTip(
+            "Registers this app in your Windows startup (per-user, no admin\n"
+            "rights) so it launches at login — minimized to the tray while\n"
+            "sharing is on, so sharing resumes after a reboot without\n"
+            "anyone having to launch the app."
+        )
         self.autostart_checkbox.setChecked(self._autostart.is_enabled())
         self.autostart_checkbox.setEnabled(self._autostart.available)
         self.autostart_checkbox.toggled.connect(self._on_autostart_toggled)
         self.clipboard_checkbox = QCheckBox("Sync clipboard with connected computers")
+        self.clipboard_checkbox.setToolTip(
+            "Text and images copied on this computer appear on connected\n"
+            "computers, and theirs appear here.\n"
+            "Turn off to keep this computer's clipboard private — nothing\n"
+            "is sent or applied in either direction."
+        )
         self.clipboard_checkbox.setChecked(load_clipboard_sync_enabled(settings))
         self.clipboard_checkbox.toggled.connect(self._on_clipboard_toggled)
         self.reduce_effects_checkbox = QCheckBox(
-            "Reduce Windows visual effects while sharing this screen"
+            "Reduce Windows visual effects while sharing this screen (recommended)"
         )
         self.reduce_effects_checkbox.setToolTip(
-            "Makes the remote view feel more responsive: window animations, "
-            "menu fades, and shadows each stream as a burst of screen "
-            "updates, so turning them off while viewers are connected lets "
-            "the remote screen snap instead of smearing — and saves "
-            "bandwidth. Submenus also open faster. Your Windows settings "
-            "come back when the last viewer disconnects; nothing is "
-            "permanently changed."
+            "Makes the remote view feel more responsive: window animations,\n"
+            "menu fades, and shadows each stream as a burst of screen\n"
+            "updates, so turning them off while viewers are connected lets\n"
+            "the remote screen snap instead of smearing — and saves\n"
+            "bandwidth. Submenus also open faster.\n"
+            "Your Windows settings come back when the last viewer\n"
+            "disconnects; nothing is permanently changed."
         )
         self.reduce_effects_checkbox.setChecked(load_reduce_effects_enabled(settings))
         self.reduce_effects_checkbox.toggled.connect(self._on_reduce_effects_toggled)
@@ -149,14 +165,30 @@ class PreferencesTab(QWidget):
         self.sharing_off_radio = QRadioButton(
             "Not shared — no one can see this computer's screen"
         )
+        self.sharing_off_radio.setToolTip(
+            "This computer neither listens for connections nor announces\n"
+            "itself on the LAN. Existing viewers are disconnected."
+        )
         self.sharing_view_radio = QRadioButton(
             "Shared, view only — clients can watch this computer's screen "
             "but not control it"
         )
+        self.sharing_view_radio.setToolTip(
+            "Approved clients see this screen live, but their keyboard and\n"
+            "mouse input is ignored.\n"
+            "Switching between view only and full control applies instantly\n"
+            "without disconnecting viewers."
+        )
         self.sharing_control_radio = QRadioButton(
             "Shared, full control — clients can watch this computer's screen "
             "and control it with their keyboard and mouse"
         )
+        self.sharing_control_radio.setToolTip(
+            "Approved clients see this screen live and can type and click\n"
+            "as if sitting at this computer.\n"
+            "Each new client needs a one-time approval on this computer\n"
+            "before it can connect."
+        )
         self._mode_radios = {
             SHARING_MODE_OFF: self.sharing_off_radio,
             SHARING_MODE_VIEW: self.sharing_view_radio,
@@ -174,8 +206,14 @@ class PreferencesTab(QWidget):
             sharing_layout.addWidget(radio)
         # Theme: an explicit light/dark override, or follow the OS setting.
         self.theme_system_radio = QRadioButton("Follow the Windows light/dark setting")
+        self.theme_system_radio.setToolTip(
+            "Match Windows: the app switches automatically when the\n"
+            "Windows light/dark mode changes."
+        )
         self.theme_light_radio = QRadioButton("Light")
+        self.theme_light_radio.setToolTip("Always use the light theme.")
         self.theme_dark_radio = QRadioButton("Dark")
+        self.theme_dark_radio.setToolTip("Always use the dark theme.")
         self._theme_radios = {
             THEME_SYSTEM: self.theme_system_radio,
             THEME_LIGHT: self.theme_light_radio,
@@ -193,14 +231,20 @@ class PreferencesTab(QWidget):
             theme_layout.addWidget(radio)
         self.restart_button = QPushButton("Restart app")
         self.restart_button.setToolTip(
-            "Relaunch this app (e.g. after updating the software). It can be "
-            "clicked from a remote desktop session, so an update doesn't "
-            "require visiting this computer."
+            "Relaunch this app (e.g. after updating the software).\n"
+            "It can be clicked from a remote desktop session, so an update\n"
+            "doesn't require visiting this computer."
         )
         self.viewer_checkbox = QCheckBox(
             "Act as a client — discover servers on this LAN and view or "
             "control their screens"
         )
+        self.viewer_checkbox.setToolTip(
+            "Shows the client-side UI: the server panel, session tabs, and\n"
+            "server history.\n"
+            "Turn off on a computer that only shares its screen — it will\n"
+            "not connect to (or scan for) other computers at all."
+        )
         self.viewer_checkbox.setChecked(load_viewer_enabled(settings))
         self.viewer_checkbox.toggled.connect(self._on_viewer_toggled)
         layout = QFormLayout(self)

{remotedesktop-1.9.1 → remotedesktop-1.9.3}/tests/test_logs.py

@@ -1,5 +1,7 @@
 import logging
 
+from PySide6.QtCore import qInstallMessageHandler, qWarning
+
 from remotedesktop import logs
 
 
@@ -23,6 +25,26 @@ def test_init_logging_writes_formatted_records(tmp_path):
             handler.close()
 
 
+def test_init_logging_routes_qt_messages_to_the_log_file(tmp_path):
+    # Qt's default message handler writes to stderr — a GUI app must never
+    # do that, so init_logging redirects Qt's output into the log file.
+    path = logs.init_logging("client", directory=tmp_path)
+    root = logging.getLogger("remotedesktop")
+    try:
+        qWarning("qt grumbled about something")
+        for handler in root.handlers:
+            handler.flush()
+        text = path.read_text(encoding="utf-8")
+        assert "qt grumbled about something" in text
+        assert "WARNING" in text
+        assert "remotedesktop.qt" in text
+    finally:
+        qInstallMessageHandler(None)  # back to Qt's default handler
+        for handler in list(root.handlers):
+            root.removeHandler(handler)
+            handler.close()
+
+
 def test_read_log_tail_returns_recent_content(tmp_path):
     (tmp_path / "server.log").write_text("early line\nrecent line\n", encoding="utf-8")
     text = logs.read_log_tail("server", directory=tmp_path)

{remotedesktop-1.9.1 → remotedesktop-1.9.3}/tests/test_preferences.py

@@ -50,6 +50,31 @@ def test_history_change_applies_to_all_monitors(qapp, tmp_path):
     assert all(m.window_seconds == 180.0 for m in monitors)
 
 
+def test_every_preference_control_has_a_multiline_tooltip(qapp, tmp_path):
+    settings = Settings(db.connect(tmp_path / "prefs.db"))
+    tab = PreferencesTab(settings, PerformanceMonitor(), autostart=make_autostart())
+    assert tab.reduce_effects_checkbox.text().endswith("(recommended)")
+    for control in (
+        tab.viewer_checkbox,
+        tab.sharing_off_radio,
+        tab.sharing_view_radio,
+        tab.sharing_control_radio,
+        tab.theme_system_radio,
+        tab.theme_light_radio,
+        tab.theme_dark_radio,
+        tab.history_minutes,
+        tab.clipboard_checkbox,
+        tab.reduce_effects_checkbox,
+        tab.autostart_checkbox,
+        tab.restart_button,
+    ):
+        tip = control.toolTip()
+        assert tip, f"{control.text() if hasattr(control, 'text') else control} has no tooltip"
+        # Long tooltips are broken into lines by hand — one endless line is
+        # hard to read. Short one-liners (the theme overrides) are fine.
+        assert "\n" in tip or len(tip) < 80
+
+
 @pytest.mark.skipif(sys.platform != "win32", reason="Windows registry")
 def test_autostart_checkbox_toggles_registration(qapp, tmp_path):
     autostart = make_autostart()