XiaoMusic用小愛音箱語音口令播本地曲庫和在線歌曲適合 NAS 自架【免費(fèi)下載鏈接】xiaomusic使用小愛音箱播放音樂音樂使用 yt-dlp 下載。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一個自架音樂服務(wù)器綁定小米賬號后接管音箱的語音指令讓本地曲庫和在線歌曲開口即播音頻由 yt-dlp 下載落本地。家里有 NAS 和小愛音箱的話一條容器命令就能跑起來。先認(rèn)識一下它它基于 Python FastAPIMIT 協(xié)議開源以容器跑在 NAS 或任意 Linux 服務(wù)器上。綁定小米賬號后接管指定音箱的語音交互附帶 Web 控制面板可搜索、點(diǎn)播、調(diào)音量、切換設(shè)備。下載的歌保存在音樂目錄形成可離線重播的曲庫。功能速覽語音口令播放歌曲周杰倫晴天、下一首、單曲循環(huán)、關(guān)機(jī)本地曲庫掃描目錄里 mp3、flac、wav 等格式每個目錄一個播放列表在線搜索用 yt-dlp 搜索下載落本地網(wǎng)絡(luò)歌單JSON 配置電臺與歌曲定時任務(wù)按 crontab 執(zhí)行播放、調(diào)音量、語音播報自定義口令詞把自己的話術(shù)綁定到動作解決什么麻煩現(xiàn)有做法各有局限內(nèi)置音樂服務(wù)曲庫有限且受會員限制熱門歌曲常無法完整播放本地音樂服務(wù)要在屏幕端打開瀏覽不適合免提場景音箱本身沒有入口播放自己存的音樂文件XiaoMusic 從口令入口切入音箱繼續(xù)當(dāng)交互終端它負(fù)責(zé)找歌、下載和回傳鏈接使用習(xí)慣不變。維度內(nèi)置音樂服務(wù)本項(xiàng)目做法曲庫來源平臺曲庫加會員本地曲庫加在線搜索控制方式受平臺指令限制語音口令可自由擴(kuò)展保存僅在線流下載落本地可離線重播原理一分鐘講完整個過程分三步拉取對話記錄小米賬號登錄成功后程序約每秒輪詢一次音箱對話記錄你說的話會出現(xiàn)在記錄里。匹配口令找歌記錄內(nèi)容與配置的口令詞字典匹配默認(rèn)需要播放歌曲前綴命中后先查本地曲庫查不到就調(diào) yt-dlp 在線搜索并下載。回傳播放鏈接本地文件或剛下載的歌都以 HTTP 鏈接回傳給音箱播放。打斷不是無縫的要先拉到記錄、再打斷音箱自帶回答全程有延遲。上圖是本地歌曲列表界面即第二步命中后的樣子。口令匹配與記錄拉取的邏輯可看 xiaomusic/command_handler.py 與 xiaomusic/conversation.py。十分鐘上手先建宿主機(jī)目錄再啟動容器mkdir -p /xiaomusic_music /xiaomusic_conf docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic啟動后打開http://NAS_IP:58090做三件事在設(shè)置頁填小米賬號密碼保存設(shè)備列表自動出現(xiàn)無需手動獲取 did。勾選要使用的音箱。確認(rèn)主機(jī)名與端口設(shè)置頁有自動填充按鈕改過端口映射要同步改配置。其余參數(shù)下載目錄、轉(zhuǎn) MP3、型號兼容模式等都在 Web 頁面完整清單對照 config-example.json。還能這樣玩每天早晨音樂喚醒用定時任務(wù)功能crontab 格式配置比如工作日早上 8 點(diǎn)播指定歌曲、7 點(diǎn)先發(fā)一句早上好語音還可以順手設(shè)音量。示例與參數(shù)說明見 docs/issues/182.md。給孩子點(diǎn)播故事對音箱說播放歌曲小豬佩奇的故事它會先從 B 站搜到并下載再播放這是 README 標(biāo)注的隱藏玩法歌名搜到就能放適合故事、兒歌這類內(nèi)容。常聽電臺在設(shè)置頁填一份 JSON 網(wǎng)絡(luò)歌單支持 m3u8 與 mp3 流地址可掛電臺整段播放也可放別人分享的歌曲列表格式示例見 docs/issues/78.md。用之前想清楚項(xiàng)目已官方通知停止維護(hù)不再接受新功能與 bug 修復(fù)公告在 README 頂部。下載的歌曲來自第三方平臺版權(quán)合規(guī)由使用者自行負(fù)責(zé)README 免責(zé)聲明寫明僅供學(xué)習(xí)研究。小米賬號存在配置里面板暴露公網(wǎng)必須開密碼登錄README 不建議把同一賬號綁在攝像頭上。L05B、L05C、LX06、L16A 等型號放不了 flac需要開轉(zhuǎn)換為 MP3 或型號兼容模式。高頻輪詢對話記錄可能觸發(fā)風(fēng)控導(dǎo)致登錄失敗不使用時建議隨手關(guān)閉語音口令開關(guān)。常見卡點(diǎn)設(shè)備列表空提示 Login failed先關(guān)代理并重新登錄米家 App再到 mi.com 官網(wǎng)完成一次驗(yàn)證FAQ 稱能解決多數(shù)登錄失敗最后確認(rèn)設(shè)置里的賬號密碼無誤。步驟見 docs/issues/99.md。網(wǎng)頁端能播語音控制無效先確認(rèn)獲取對話記錄語音口令開關(guān)已打開首次保存 did 后要重啟容器。默認(rèn)口令前綴是播放歌曲說播放音樂不會被識別?？稍谛?App 對話記錄與程序日志里對照判斷是拉不到記錄還是口令沒匹配。歌曲鏈接瀏覽器能打開音箱沒聲音先確認(rèn)音箱和 NAS 在同一局域網(wǎng)再核對主機(jī)名與端口配置設(shè)置頁有自動填充按鈕改過端口映射的要同步改配置。排查步驟見 FAQ 的日志顯示正在播放卻沒有聲音一節(jié)。第一天正常第二天語音失靈一般是拉取對話記錄過于頻繁觸發(fā)風(fēng)控。FAQ 建議用定時任務(wù)夜間關(guān)閉拉取、白天再開啟也可每天定時執(zhí)行一次重新初始化緩解登錄失效。接下來去哪docs/issues/99.mdFAQ 問題集合報錯排查主入口docs/issues/index.md文檔與快速入門索引config-example.json全量參數(shù)清單xiaomusic/command_handler.py 與 xiaomusic/conversation.py命令處理與對話記錄拉取源碼自定義口令的入手處本項(xiàng)目功能已完整但作者已公告停止維護(hù)。若打算長期使用建議先看 README 推薦的社區(qū)接力項(xiàng)目評估遷移成本后再部署?！久赓M(fèi)下載鏈接】xiaomusic使用小愛音箱播放音樂音樂使用 yt-dlp 下載。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考