繁體中文｜用你現有的喇叭，組出穩定、可調、可驗證的同步播放環境。
English｜Synchronize the speakers you already own into a stable, adjustable, verifiable playback setup.
Mosaic Audio Lab is an AGPL-3.0 open-source macOS audio synchronization tool. It routes system audio to two independently controlled physical outputs and provides per-route delay and volume controls for practical Bluetooth / speaker alignment.
Mosaic Audio Lab 是一個 AGPL-3.0 開源 macOS 音訊同步工具。它把系統音訊送往兩個可獨立控制的實體輸出，並提供每一路延遲與音量控制，用於實際藍牙／喇叭對齊。
v1.1.1 keeps the stable open-source synchronization core and includes the public Advanced Alignment tools: Observer capture, BlackHole reference capture, manual GCC-PHAT measurement, Advanced Tuning Methods A / B / C, microphone diagnostics, and manual Device Profile saving.
v1.1.1 保留穩定的開源同步核心，並包含公開的「進階對齊」工具：Observer capture、BlackHole reference capture、手動 GCC-PHAT 量測、進階調音方式 A / B / C、麥克風診斷，以及手動 Device Profile 儲存。
- Two physical output routes: Route A and Route B. / 兩路實體輸出：Route A 與 Route B。
- Independent Delay A/B and Volume A/B. / 各路獨立 Delay A/B 與 Volume A/B。
- Manual live parameter apply for tuning. / 手動調整可即時套用。
- Conservative playback-time micro-drift guard. / 保守式播放中微調飄移守門。
- Advanced Alignment tab with Observer capture and BlackHole reference. / 「進階對齊」分頁：Observer capture 與 BlackHole reference。
- Manual GCC-PHAT measurement and Advanced Tuning Methods A / B / C. / 手動 GCC-PHAT 量測與進階調音方式 A / B / C。
- Microphone diagnostic ZIP recorder. / 麥克風診斷 ZIP 錄製。
- Manual Device Profile save/apply support. / 手動 Device Profile 儲存／套用。
- Traditional Chinese and English user documentation. / 繁中／英文雙語使用文件。
This public package does not include private spatializer DSP, a private Pro package, proprietary license code, credentials, tokens, private recordings, or bundled BlackHole binaries.
此公開套件不包含私有空間化 DSP、私有 Pro 套件、閉源授權碼、憑證、token、私人錄音，也不會包入 BlackHole 執行檔或驅動。
- macOS on Apple Silicon or Intel / Apple Silicon 或 Intel 的 macOS。
- Python 3.10+ / Python 3.10 以上。
numpy,sounddevice/numpy、sounddevice。- BlackHole 2ch or 16ch is recommended for system-audio routing and reference measurement. / 建議使用 BlackHole 2ch 或 16ch 進行系統音訊路由與 reference 量測。
See INSTALL.md and INSTALL_BLACKHOLE.md.
請閱讀 INSTALL.md 與 INSTALL_BLACKHOLE.md。
python3 -m pip install -r requirements.txt
python3 -m audio_sync_toolOr double-click / 或雙擊：
run_mosaic_audio_lab.command
- Set macOS system output to BlackHole when using the BlackHole route. / 使用 BlackHole 路徑時，先把 macOS 系統輸出設為 BlackHole。
- Select input, Route A, and Route B on the Sync / 同步 page. / 在「同步」頁選擇輸入、Route A 與 Route B。
- Start sync. / 開始同步。
- Use manual Delay A/B and Volume A/B to tune the two speakers. / 使用手動 Delay A/B 與 Volume A/B 調整兩顆喇叭。
- In Advanced Alignment / 進階對齊, start observer capture, select a BlackHole reference, and use Method A/B/C only as measurement assistance. / 在「進階對齊」開始 observer capture、選擇 BlackHole reference，並只把方式 A/B/C 作為量測輔助。
- Enable continuous alignment only after manual alignment is stable. / 手動對齊且播放穩定後，再視需要啟用播放時自動持續對齊。
- Automated tests cannot prove acoustic correctness. / 自動測試不能證明聲學結果正確。
- Bluetooth speakers may drift under heavy CPU, memory, or swap pressure. / 藍牙喇叭在高 CPU、記憶體或 swap 壓力下可能更容易飄移。
- Advanced Tuning Methods A / B / C do not automatically replace first-time manual alignment. / 進階調音方式 A / B / C 不取代第一次手動對齊。
- The app never bundles BlackHole. / 本程式不會包入 BlackHole。
- INSTALL.md — installation and launch / 安裝與啟動。
- INSTALL_BLACKHOLE.md — BlackHole/null-output setup / BlackHole／null output 設定。
- CONTRIBUTING.md — contribution and public-boundary rules / 貢獻與開源邊界。
- RELEASE_NOTES.md — release notes and validation scope / 發行說明與驗證範圍。
- GITHUB_FINAL_CLEAN_AUDIT.md — final clean release audit / 最終乾淨發布稽核。
- GITHUB_RELEASE_CHECKLIST.md — GitHub release checklist / GitHub 發布檢查表。
Mosaic Audio Lab is licensed under AGPL-3.0; see LICENSE.
Mosaic Audio Lab 採 AGPL-3.0 授權；詳見 LICENSE。
Contributions must follow CONTRIBUTING.md.
貢獻前請閱讀 CONTRIBUTING.md。