What is this?
A self-hosted service that plays music on Xiaomi XiaoAI smart speakers: it serves your music library to the speaker and downloads new songs on demand with yt-dlp. You control it by voice and through a web console.
A self-hosted service that plays music on Xiaomi XiaoAI smart speakers: it serves your music library to the speaker and downloads new songs on demand with yt-dlp. You control it by voice and through a web console.Is this an app I install on the speaker itself, or where does it actually run?Neither — it's a server you host yourself, usually in Docker on a NAS or home server. The speaker just plays what it's told; everything is managed from a web settings page (Python/FastAPI backend, jQuery frontend).
Neither — it's a server you host yourself, usually in Docker on a NAS or home server. The speaker just plays what it's told; everything is managed from a web settings page (Python/FastAPI backend, jQuery frontend).What's the install like — is Docker the only way?Docker Compose is the recommended way (pip also works). After it starts, open the web page — the sample maps host port 58090 to container 8090 — and on first run enter your Xiaomi account and password there to fetch your device list.
Docker Compose is the recommended way (pip also works). After it starts, open the web page — the sample maps host port 58090 to container 8090 — and on first run enter your Xiaomi account and password there to fetch your device list.Do I need a Xiaomi account for this to work?Yes, a Xiaomi account is required to link the speaker, plus the speaker itself and an always-on machine for Docker (or Python for the pip route). Music and config live in two separate host folders you mount into the container.
Yes, a Xiaomi account is required to link the speaker, plus the speaker itself and an always-on machine for Docker (or Python for the pip route). Music and config live in two separate host folders you mount into the container.Is the project still being maintained?No — it's archived: the author stopped maintenance, so there are no new features or bug fixes, and open issues and PRs are no longer processed. The README points to the community successor songloft-org/songloft for migration.
No — it's archived: the author stopped maintenance, so there are no new features or bug fixes, and open issues and PRs are no longer processed. The README points to the community successor songloft-org/songloft for migration.Will it work with my speaker?Owners of Xiaomi XiaoAI speakers are the target: the tested list spans about 20 models, from XiaoAI and mini speakers and Redmi Speaker Play to Mi AI Speaker (2nd gen), Xiaomi Sound / Sound Pro, touchscreen models and Xiaomi Smart Speaker Pro.
Owners of Xiaomi XiaoAI speakers are the target: the tested list spans about 20 models, from XiaoAI and mini speakers and Redmi Speaker Play to Mi AI Speaker (2nd gen), Xiaomi Sound / Sound Pro, touchscreen models and Xiaomi Smart Speaker Pro.What can I actually say to the speaker?Basics like play a song by name (e.g. 'play song Jay Chou Qing Tian'), play local songs, next/previous track, and stop playback. You also get loop and random play modes, playlist commands by folder name, and a favorites list you can add to or remove from.
Basics like play a song by name (e.g. 'play song Jay Chou Qing Tian'), play local songs, next/previous track, and stop playback. You also get loop and random play modes, playlist commands by folder name, and a favorites list you can add to or remove from.Where does the music come from — do I need my own files?Either drop your own mp3, flac, wav, ape, ogg or m4a files into the music folder, or just ask for a song: it gets downloaded with yt-dlp (as mp3) into that folder and then plays. JSON network playlists can also stream radio stations.
Either drop your own mp3, flac, wav, ape, ogg or m4a files into the music folder, or just ask for a song: it gets downloaded with yt-dlp (as mp3) into that folder and then plays. JSON network playlists can also stream radio stations.Will lossless FLAC work on every speaker?Not always — models L05B, L05C, LX06 and L16A are known not to play flac. If a format fails, enable the 'convert to MP3' and model compatibility mode options in the settings page.
Not always — models L05B, L05C, LX06 and L16A are known not to play flac. If a format fails, enable the 'convert to MP3' and model compatibility mode options in the settings page.Anything fun beyond regular songs?Yes: say 'play song 小猪佩奇的故事' and it downloads and plays Peppa Pig stories. You can also load JSON network playlists with radio stations (with an m3u converter tool), and install third-party web themes like pure, Tailwind or SoundScape.
Yes: say 'play song 小猪佩奇的故事' and it downloads and plays Peppa Pig stories. You can also load JSON network playlists with radio stations (with an m3u converter tool), and install third-party web themes like pure, Tailwind or SoundScape.What are similar projects?linksift, ISpotify, stemdeck, EchoMuse, reclip, AlgerMusicPlayer, ha_xiaomi_home, spotify-downloader
linksift, ISpotify, stemdeck, EchoMuse, reclip, AlgerMusicPlayer, ha_xiaomi_home, spotify-downloaderWhich topics is it in?xiaomi, nas, smart-home, yt-dlp, music-player, downloader, iot, music, fastapi, audio, vue, deprecated
xiaomi, nas, smart-home, yt-dlp, music-player, downloader, iot, music, fastapi, audio, vue, deprecated