XiaoMusic 是一個開源項目，旨在通過小愛音箱播放音樂，支持本地和網(wǎng)絡(luò)音樂資源的無縫整合。該項目允許用戶通過語音命令控制播放，如播放歌曲、上一首、下一首、單曲循環(huán)、全部循環(huán)、隨機播放等。XiaoMusic 使用 yt-dlp 下載音樂文件，支持多種音頻格式，包括 mp3、flac、wav、ape、ogg、m4a 等。

• XiaoMusic官網(wǎng)入口網(wǎng)址：https://xdocs.hanxi.cc/
• XiaoMusic開源項目地址：https://github.com/hanxi/xiaomusic
• XiaoMusic安裝部署說明：https://xdocs.hanxi.cc/issues/
• 如果你看不懂官方提供的教程，可以在網(wǎng)上搜索其他網(wǎng)友分享的XiaoMusic相關(guān)教程，你也可以點擊：鏈接，查看b站相關(guān)博主分享的XiaoMusic安裝部署視頻教程。

功能特點

• 語音控制：用戶可以通過小愛音箱的語音指令控制播放，如“播放歌曲陳奕迅十年”或“下一首”。
• 本地與網(wǎng)絡(luò)音樂支持：XiaoMusic 支持本地音樂文件和網(wǎng)絡(luò)音樂資源的播放。如果本地沒有特定歌曲，系統(tǒng)會自動從 B 站或 YouTube 下載并存儲為 MP3 格式 。
• Docker 部署：XiaoMusic 可以通過 Docker 容器進行部署，支持多種 NAS 設(shè)備（如威聯(lián)通、綠聯(lián)、飛牛、群暉等）的快速安裝和配置。用戶可以通過 Docker Compose 文件指定鏡像、重啟策略、掛載路徑和環(huán)境變量 。
• Web 管理界面：XiaoMusic 提供了一個 Web 管理界面，用戶可以通過瀏覽器訪問，進行音樂管理、播放列表配置、設(shè)備設(shè)置等操作 。
• 自定義口令：用戶可以設(shè)置自定義口令，通過語音指令調(diào)用特定功能，如“播放歌曲”或“停止播放”。
• 歌單管理：XiaoMusic 支持 JSON 格式的歌單管理，用戶可以輕松創(chuàng)建和管理自己的音樂庫 。
• 安全設(shè)置：為了確保安全，建議開啟密碼登錄并設(shè)置復(fù)雜密碼，避免在公共場所的 WiFi 環(huán)境下使用 。

部署與配置

1. Docker 部署：用戶可以通過 Docker Compose 文件快速部署 XiaoMusic。例如，在 NAS 上創(chuàng)建一個 docker-compose.yml 文件，指定鏡像、端口映射、卷掛載和環(huán)境變量 。
2. 環(huán)境變量配置：XiaoMusic 支持多種環(huán)境變量配置，如 MI_USER（小米賬號）、MI_PASS（小米密碼）、XIAOMUSIC_SEARCH（指定音樂來源，如 B 站或 YouTube）等 。
3. 音樂文件管理：用戶可以將音樂文件存儲在 NAS 的指定目錄中，XiaoMusic 會自動掃描并播放這些文件。如果本地沒有特定歌曲，系統(tǒng)會自動從網(wǎng)絡(luò)下載 。
4. Web 界面訪問：用戶可以通過瀏覽器訪問 XiaoMusic 的 Web 管理界面，進行播放列表管理、設(shè)備設(shè)置等操作。默認端口通常是 8090 或 58090 。

社區(qū)與支持

XiaoMusic 有一個活躍的社區(qū)，用戶可以通過 GitHub 倉庫提交問題、報告錯誤或提出建議。此外，項目還提供了 QQ 群和交流群，方便用戶交流和獲取幫助。

XiaoMusic 是一個功能強大且靈活的開源項目，旨在通過小愛音箱播放音樂，支持本地和網(wǎng)絡(luò)音樂資源的無縫整合。通過 Docker 部署和 Web 管理界面，用戶可以輕松管理和控制音樂播放。該項目不僅解決了小愛音箱播放源受限的問題，還推動了開源精神和網(wǎng)絡(luò)共享文化的發(fā)展 。