Wire host ID, TLS, WS, audio, clipboard, file transfer into Remote Desktop GUI

JE-Chen · JE-Chen · commit 91cba6ec4e14 · 2026-04-26T21:46:42.000+08:00
Host panel:
- Prominent Host ID display with a 'Copy' button so users can read it
  out (formatted as '123 456 789') and paste it into the viewer.
- Transport dropdown (TCP / WebSocket) routes Start through either
  RemoteDesktopHost or WebSocketDesktopHost.
- TLS cert / key fields with file pickers; both required to opt in,
  otherwise the connection stays plain.
- 'Stream system audio' checkbox (greyed when sounddevice is
  unavailable) flows through to enable_audio.

Viewer panel:
- Host ID input that accepts '123 456 789' / '123-456-789' / etc.
  and uses parse_host_id to verify the announced ID after AUTH_OK.
- Transport dropdown (TCP / WebSocket / TLS / WSS) plus a 'Skip cert
  verification' checkbox for self-signed deployments. WSS reuses the
  same SSLContext path; TLS/WSS hosts that present a real cert just
  uncheck the box.
- 'Play received audio' checkbox spins up an AudioPlayer per session
  and routes incoming AUDIO frames to it via a Qt signal.
- 'Push clipboard text' button sends the local clipboard to the host;
  incoming CLIPBOARD messages from the host are applied to the local
  clipboard and surfaced as a status line.
- 'Send file...' opens a file picker + destination prompt and runs
  the upload on a QThread, with a QProgressBar bound to FileSender's
  progress events.
- The frame display widget now accepts dragEnter/drop of local files;
  each dropped file kicks off the same upload flow.

The receiver thread's host_id / clipboard / audio / file callbacks
all marshal back to the GUI thread via Qt signals so the recv loop
never touches widgets directly. Translations added for English,
Traditional Chinese, Simplified Chinese, and Japanese.

remote_desktop_tab.py is now ~950 lines, over CLAUDE.md's 750-line
limit; splitting into gui/remote_desktop/{host_panel,viewer_panel,
frame_display}.py is a logical follow-up — left as one file here so
the diff stays scoped to the feature additions.
diff --git a/je_auto_control/gui/language_wrapper/english.py b/je_auto_control/gui/language_wrapper/english.py
@@ -401,6 +401,28 @@
     "rd_host_status_running": "Running on port {port} — {n} viewer(s)",
     "rd_host_status_stopped": "Host is stopped",
     "rd_host_preview_label": "Preview (what viewers see):",
+    "rd_host_id_group": "Host ID (share with viewers)",
+    "rd_host_id_label": "Host ID:",
+    "rd_host_id_copy": "Copy",
+    "rd_transport_label": "Transport:",
+    "rd_tls_cert_label": "TLS cert:",
+    "rd_tls_cert_placeholder": "PEM certificate path (optional)",
+    "rd_tls_key_label": "TLS key:",
+    "rd_tls_key_placeholder": "PEM private key path (optional)",
+    "rd_tls_both_required": "TLS cert and key must both be provided",
+    "rd_tls_insecure": "Skip cert verification (self-signed)",
+    "rd_browse": "Browse...",
+    "rd_enable_audio": "Stream system audio (sounddevice)",
+    "rd_viewer_audio_play": "Play received audio (sounddevice)",
+    "rd_viewer_push_clipboard": "Push my clipboard text to host",
+    "rd_viewer_send_file": "Send file...",
+    "rd_dest_path_prompt": "Destination path on remote for {name}:",
+    "rd_clipboard_empty": "Local clipboard is empty",
+    "rd_clipboard_sent": "Clipboard sent to host",
+    "rd_viewer_clipboard_received": "Clipboard updated from host",
+    "rd_progress_label": "Transfer: {done} / {total} bytes",
+    "rd_progress_done": "Transfer complete: {path}",
+    "rd_progress_failed": "Transfer failed: {error}",
     "rd_viewer_connect": "Connect",
     "rd_viewer_disconnect": "Disconnect",
     "rd_viewer_required_fields": (
diff --git a/je_auto_control/gui/language_wrapper/japanese.py b/je_auto_control/gui/language_wrapper/japanese.py
@@ -401,6 +401,28 @@
     "rd_host_status_running": "稼働中 ポート {port} — ビューア {n} 名",
     "rd_host_status_stopped": "ホストは停止中",
     "rd_host_preview_label": "プレビュー（ビューアの表示）:",
+    "rd_host_id_group": "ホスト ID（ビューアに伝える）",
+    "rd_host_id_label": "ホスト ID:",
+    "rd_host_id_copy": "コピー",
+    "rd_transport_label": "トランスポート:",
+    "rd_tls_cert_label": "TLS 証明書:",
+    "rd_tls_cert_placeholder": "PEM 証明書パス（任意）",
+    "rd_tls_key_label": "TLS キー:",
+    "rd_tls_key_placeholder": "PEM 秘密鍵パス（任意）",
+    "rd_tls_both_required": "TLS 証明書とキーは両方必要",
+    "rd_tls_insecure": "証明書検証をスキップ（自己署名用）",
+    "rd_browse": "参照...",
+    "rd_enable_audio": "システム音声をストリーム（sounddevice）",
+    "rd_viewer_audio_play": "受信音声を再生（sounddevice）",
+    "rd_viewer_push_clipboard": "ローカルのクリップボード文字をホストへ送信",
+    "rd_viewer_send_file": "ファイル送信...",
+    "rd_dest_path_prompt": "{name} のリモート保存先:",
+    "rd_clipboard_empty": "ローカルのクリップボードが空です",
+    "rd_clipboard_sent": "クリップボードをホストへ送信しました",
+    "rd_viewer_clipboard_received": "ホストからクリップボードを同期しました",
+    "rd_progress_label": "転送中: {done} / {total} バイト",
+    "rd_progress_done": "転送完了: {path}",
+    "rd_progress_failed": "転送失敗: {error}",
     "rd_viewer_connect": "接続",
     "rd_viewer_disconnect": "切断",
     "rd_viewer_required_fields": "アドレス・ポート・トークンはすべて必須です。",
diff --git a/je_auto_control/gui/language_wrapper/simplified_chinese.py b/je_auto_control/gui/language_wrapper/simplified_chinese.py
@@ -395,6 +395,28 @@
     "rd_host_status_running": "运行中 端口 {port} — {n} 个 viewer",
     "rd_host_status_stopped": "Host 已停止",
     "rd_host_preview_label": "预览（viewer 看到的画面）：",
+    "rd_host_id_group": "Host ID（给远程的人）",
+    "rd_host_id_label": "Host ID:",
+    "rd_host_id_copy": "复制",
+    "rd_transport_label": "传输协议:",
+    "rd_tls_cert_label": "TLS 证书:",
+    "rd_tls_cert_placeholder": "PEM 证书路径（选填）",
+    "rd_tls_key_label": "TLS 密钥:",
+    "rd_tls_key_placeholder": "PEM 私钥路径（选填）",
+    "rd_tls_both_required": "TLS 证书与密钥必须一并提供",
+    "rd_tls_insecure": "忽略证书验证（自签用）",
+    "rd_browse": "浏览...",
+    "rd_enable_audio": "串流系统音频（sounddevice）",
+    "rd_viewer_audio_play": "播放接收的音频（sounddevice）",
+    "rd_viewer_push_clipboard": "把本机剪贴板文字发送到 Host",
+    "rd_viewer_send_file": "发送文件...",
+    "rd_dest_path_prompt": "{name} 在远程的目的路径:",
+    "rd_clipboard_empty": "本机剪贴板是空的",
+    "rd_clipboard_sent": "剪贴板已发送到 Host",
+    "rd_viewer_clipboard_received": "已从 Host 同步剪贴板",
+    "rd_progress_label": "传输进度: {done} / {total} bytes",
+    "rd_progress_done": "传输完成: {path}",
+    "rd_progress_failed": "传输失败: {error}",
     "rd_viewer_connect": "连接",
     "rd_viewer_disconnect": "断开",
     "rd_viewer_required_fields": "地址、端口、token 都必须填写。",
diff --git a/je_auto_control/gui/language_wrapper/traditional_chinese.py b/je_auto_control/gui/language_wrapper/traditional_chinese.py
@@ -396,6 +396,28 @@
     "rd_host_status_running": "運行中 port {port} — {n} 個 viewer",
     "rd_host_status_stopped": "Host 已停止",
     "rd_host_preview_label": "預覽（viewer 看到的畫面）：",
+    "rd_host_id_group": "Host ID（給遠端的人）",
+    "rd_host_id_label": "Host ID：",
+    "rd_host_id_copy": "複製",
+    "rd_transport_label": "傳輸協定：",
+    "rd_tls_cert_label": "TLS 憑證：",
+    "rd_tls_cert_placeholder": "PEM 憑證路徑（選填）",
+    "rd_tls_key_label": "TLS 金鑰：",
+    "rd_tls_key_placeholder": "PEM 私鑰路徑（選填）",
+    "rd_tls_both_required": "TLS 憑證與金鑰必須一併提供",
+    "rd_tls_insecure": "忽略憑證驗證（自簽用）",
+    "rd_browse": "瀏覽...",
+    "rd_enable_audio": "串流系統音訊（sounddevice）",
+    "rd_viewer_audio_play": "播放接收的音訊（sounddevice）",
+    "rd_viewer_push_clipboard": "把本機剪貼簿文字送到 Host",
+    "rd_viewer_send_file": "傳送檔案...",
+    "rd_dest_path_prompt": "{name} 在遠端的目的路徑：",
+    "rd_clipboard_empty": "本機剪貼簿是空的",
+    "rd_clipboard_sent": "剪貼簿已送到 Host",
+    "rd_viewer_clipboard_received": "已從 Host 同步剪貼簿",
+    "rd_progress_label": "傳輸進度：{done} / {total} bytes",
+    "rd_progress_done": "傳輸完成：{path}",
+    "rd_progress_failed": "傳輸失敗：{error}",
     "rd_viewer_connect": "連線",
     "rd_viewer_disconnect": "中斷連線",
     "rd_viewer_required_fields": "位址、port、token 都必須填寫。",
diff --git a/je_auto_control/gui/remote_desktop_tab.py b/je_auto_control/gui/remote_desktop_tab.py
