Mingmist Cast

繁體中文 | English

---

繁體中文

Mingmist Cast 是一個 本地優先、實驗性的 Windows 螢幕投影原型。

狀態：Preview／實驗階段，尚未達到正式產品標準。

目前流程

發送端

1. 執行 start_cast.bat。
2. 選擇「發送」。
3. 按下「開始發送」，選擇螢幕、視窗或瀏覽器分頁。
4. 將畫面顯示的區域網路網址與六位數連線碼提供給接收端。

接收端

1. 使用瀏覽器開啟發送端提供的網址。
2. 選擇「接收」。
3. 輸入六位數連線碼。
4. 核對 SAS 安全驗證碼，並允許本次連線。

主要流程不包含 QR Code，也不依賴外部 QR 服務。

已實作

• Windows Chrome／Edge 螢幕、視窗與瀏覽器分頁擷取
• 瀏覽器接收端介面
• 一次性連線碼與每次重新批准
• ECDH／SAS 應用層驗證
• WebRTC DTLS-SRTP 媒體傳輸基礎
• ICE candidate 排隊、重試與診斷
• Windows Wi-Fi Direct 探索、配對、Socket 與應用層驗證
• AES-256-GCM 安全控制通道
• 本地優先，不要求雲端帳號

已知限制

• iPhone Safari 尚未通過最終實機連線驗收。
• 公共、學校、飯店和圖書館 Wi-Fi 可能啟用 Client Isolation，阻止裝置互連。
• Windows 行動熱點或部分網卡環境仍可能阻擋 WebRTC ICE。
• Wi-Fi Direct 目前只完成安全控制基礎，尚未承載影音資料。
• 目前僅支援一個發送端與一個接收端。
• 尚未提供 Internet Relay、TURN 服務、AirPlay Receiver、Android 原生發送端或多人廣播。
• 目前介面主要為繁體中文，英文介面仍在補充中。

執行

start_cast.bat

測試

run_tests.bat

Windows Broker 驗證：

taskkill /IM Mingmist.Cast.WindowsBroker.exe /F
windows-broker\validate_windows_broker.bat

安全邊界

• 探索或作業系統配對不等於 Cast 授權。
• 接收端必須核對 SAS 並明確批准本次工作階段。
• 不保存永久信任、Session Token、私鑰或媒體內容。
• Wi-Fi Direct 安全控制通道的 Session Key 不會匯出至 Python 或 HTTP 層。

授權

本專案採用 GNU Affero General Public License v3.0。

你可以使用、研究、修改與重新散布本專案。若你透過網路提供修改後的版本，或散布修改版本與衍生版本，必須依照 AGPL-3.0 提供相應原始碼並保留相同授權條款。

---

English

Mingmist Cast is a local-first, experimental screen-casting prototype for Windows.

Status: Preview / experimental. Not production-ready.

Current workflow

Sender

1. Run start_cast.bat.
2. Select Send.
3. Select Start casting, then choose a screen, window, or browser tab.
4. Share the displayed local-network URL and six-digit connection code with the receiver.

Receiver

1. Open the URL provided by the sender in a browser.
2. Select Receive.
3. Enter the six-digit connection code.
4. Compare the SAS security code and approve the one-time session.

The primary workflow does not use QR codes or any external QR service.

Implemented

• Screen, window, and browser-tab capture in Chrome and Edge on Windows
• Browser-based receiver interface
• One-time connection codes and per-session approval
• ECDH / SAS application-layer authentication
• WebRTC DTLS-SRTP media transport foundation
• ICE candidate queuing, retry, and diagnostics
• Windows Wi-Fi Direct discovery, pairing, sockets, and application authentication
• AES-256-GCM secure control channel
• Local-first architecture without mandatory cloud accounts

Known limitations

• iPhone Safari has not passed final real-device connectivity validation.
• Public, school, hotel, and library Wi-Fi networks may use client isolation and block device-to-device communication.
• Windows Mobile Hotspot and some network adapters may still block WebRTC ICE connectivity.
• Wi-Fi Direct currently provides the secure-control foundation but does not yet carry the media data plane.
• Only one sender and one receiver are currently supported.
• Internet relay, TURN service, AirPlay receiver support, native Android sender support, and multi-receiver broadcasting are not available.
• The current interface is primarily in Traditional Chinese. English UI support is still being added.

Run

start_cast.bat

Tests

run_tests.bat

Windows Broker validation:

taskkill /IM Mingmist.Cast.WindowsBroker.exe /F
windows-broker\validate_windows_broker.bat

Security boundaries

• Discovery or operating-system pairing does not grant Cast authorization.
• The receiver must compare the SAS and explicitly approve each session.
• Permanent trust, session tokens, private keys, and media content are not stored.
• Wi-Fi Direct secure-control session keys are not exported to the Python or HTTP layers.

License

This project is licensed under the GNU Affero General Public License v3.0.

You may use, study, modify, and redistribute this project. Modified versions offered over a network, or distributed modified and derivative versions, must provide the corresponding source code under AGPL-3.0-compatible terms.