在 macOS 上安裝

支援 Intel（x64）與 Apple Silicon（arm64）。

需求

項目	需求
版本	macOS 12 Monterey 以上
架構	x64 或 arm64
記憶體	最低 4GB

安裝

從 Releases 下載對應架構的 .dmg，拖進「應用程式」。

開機自動啟動

系統設定 → 一般 → 登入項目 → 加入 HUAN Device。

或用 launchd：

<!-- ~/Library/LaunchAgents/tw.linyao.huan.device.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
	<dict>
		<key>Label</key>
		<string>tw.linyao.huan.device</string>
		<key>ProgramArguments</key>
		<array>
			<string>/Applications/HUAN Device.app/Contents/MacOS/HUAN Device</string>
		</array>
		<key>RunAtLoad</key>
		<true/>
		<key>KeepAlive</key>
		<true/>
	</dict>
</plist>

launchctl load ~/Library/LaunchAgents/tw.linyao.huan.device.plist

關閉螢幕休眠

sudo pmset -a displaysleep 0 sleep 0

或用 caffeinate 包住播放器。

溫度

macOS 上沒有不需要特殊權限就能取得 CPU 溫度的公開 API，裝置回報 null，後台顯示「—」。

憑證儲存

裝置憑證使用 Electron 的 safeStorage，在 macOS 上存進系統的鑰匙圈。

適合的情境

macOS 主要用於開發與測試——它讓開發者不需要準備 Raspberry Pi 就能執行真正的播放器。

正式部署的看板通常會選 Raspberry Pi 或小型 Linux 電腦，成本與功耗都低得多。Mac mini 在需要 4K、色彩準確度或已經有 Apple 生態系統的場合仍然是合理的選擇。

疑難排解

應用程式無法開啟，顯示「已損毀」：這通常是 quarantine 屬性造成的，用上面的 xattr 指令處理。

全螢幕時仍然看得到選單列：在系統設定裡把「自動隱藏並顯示選單列」設為「一律」。