ZenTime 靜心主持台
ZenTime 是供靜心活動主持人使用的 macOS／Windows 雙視窗控制 App。主持台負責時間、聲音與畫面設定；乾淨的 16:9 參與者視窗可供 Zoom 分享或第二螢幕投影。
QNAP Docker 網頁版
docker-version/ 提供主持台、16:9 參與者畫面、手機控制頁、既有 Companion API，以及 WiiM Pro 播放控制。WiiM 的位址與音檔資料夾網址都由環境變數設定，程式沒有預設任何裝置。詳細部署方式請參考 docker-version/README.md。
使用方式
- 雙擊
靜心主持台.app。
- 在直式主持台設定文字、背景、時間、倒數與聲音。
- 拖曳 16:9 視窗的空白處可移動整個視窗；拖曳文字或倒數可改變各自位置，拖曳時會出現水平、垂直與中央參考線。
- 在 Zoom 的「分享螢幕」中選擇該 16:9 視窗。
- 按主持台的「開始」。
預選時間包含 3、5、7、10、15、20 分鐘。切換時間後，主持台和參與者畫面的倒數會立即同步。三組聲音各有加寬的獨立音量滑軌與百分比，并分別提供「淡入」和「淡出」選項。背景音樂可不選。
字體選單會讀取本機已安裝的全部字體。文字框寬度、文字大小、倒數大小皆可調整。參與者視窗也可選擇永遠顯示在最上層。
字體選單顯示字體的正式顯示名稱；大小欄可直接輸入 8–300 的任意數值。控制台最上方固定為時間、倒數與現場控制。參與者倒數另有獨立字體選單，時間也可輸入自訂分鐘。
「文字區域寬度」是長句可使用的最大橫向範圍；調小會較早換行，短文字不會有明顯差異。
背景可使用純色、圖片或雙色漸層。參與者倒數可搭配圓環或直線進度動畫，並可設定進度的起始色與結束色，形成漸層效果。
倒數進度採累積顯示：開始時為空，直線由左往右增加，圓環由頂端順時針增加，時間結束時填滿。
App 內建 磬聲.m4a 作為開頭與結尾磬聲。可分別選擇其他音檔，也可按「恢復使用內建磬聲」。勾選「無聲模式」會略過開頭磬聲、背景音樂與結尾磬聲。
按「切換到選單列模式」後，普通視窗會收起並展開選單列控制台；按「切換到一般視窗模式」才會返回視窗。兩種模式完全手動切換。選單列模式開啟檔案、字體或顏色選擇器時，控制台會保持開啟。
拖曳文字或倒數時，畫面會顯示 4×4 的 16 格參考線。接近格線或另一個物件的中心、左右邊緣、上下邊緣時會自動吸附，並提供觸覺回饋。
熱鍵
Return：開始或繼續空白鍵：暫停或繼續（文字輸入時不觸發）Esc：提早結束目前靜心Command-R：重新準備Command-Shift-D：顯示或隱藏參與者倒數Command-Shift-T：切換參與者視窗最上層Control-Command-F：參與者視窗全螢幕Command-,：顯示完整設定Command-H：隱藏 AppCommand-Q：結束 App
控制台內與「輔助說明」選單皆可開啟熱鍵說明畫面。滑鼠移到 Mac 頂端選單列時，參與者視窗會被帶到最前方，方便快速找到。
重新建置
執行 ./build-app.sh，完成後會在本資料夾產生新的 靜心主持台.app。
API 與 Companion
App 啟動後會在本機 4747 連接埠提供控制 API。狀態端點是 /api/state；控制端點包括 /api/start、/api/pause、/api/toggle、/api/reset、/api/finish 與 /api/duration?minutes=12。
主持台的「網頁控制：開啟」會打開響應式網頁控制台，網址是 http://127.0.0.1:4747。同一 Wi‑Fi 的手機或平板，可將 127.0.0.1 換成 Mac 的區域網路 IP 位址。
可直接匯入 Companion 的安裝包位於專案根目錄：靜心主持台-Companion模組-0.2.0.tgz。在 Companion 的 Modules 頁面選擇「Import module package」並選取該檔案即可，不需解壓縮。
