# hanxi/xiaomusic

使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。

Repository: https://github.com/hanxi/xiaomusic
Canonical: https://ross.abutalabs.com/products/xiaomusic
Homepage: http://xdocs.hanxi.cc/
Language: Python
License: MIT
License Family: permissive
Topics: music, xiaoai, xiaoai-speaker, xiaomi, xiaomusic, docker, docker-compose, pdm, python, vue
Archived: true
Last push: 2026-06-09T05:24:33+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 86, release rhythm 75, longevity 75
- inputs: {"age_days": 1054, "days_push": 85, "days_rel": 85, "gap_med": 2, "n_releases_24m": 112}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 10048, forks 1147 (observed 2026-08-28T04:10:39.357867+00:00)

## What it is
XiaoMusic is a self-hosted Python application that lets Xiaomi XiaoAI smart speakers play music downloaded via yt-dlp, controlled through voice commands and a web settings UI. It deploys via Docker on NAS platforms and supports custom voice commands, plugins, and Edge-TTS, but the project is now discontinued in favor of the community fork songloft.

## Use cases
- play downloaded music on xiaomi xiaoai speaker
- let my smart speaker play songs from youtube
- self-host a music service for xiaoai speaker on my NAS
- control music playback on xiaomi speaker with voice commands
- download music with yt-dlp and stream it to a smart speaker
- replace xiaomi's built-in music service with my own library

## When to choose
- you own a Xiaomi XiaoAI speaker and want unlimited music playback from your own library
- you want a Docker-based, self-hosted music player for smart speakers on a NAS
- you need customizable voice commands and TTS on XiaoAI hardware

## When to avoid
- you need active maintenance or bug fixes - the project is officially discontinued
- you don't own a Xiaomi XiaoAI speaker
- you want a maintained alternative - use the community successor songloft instead

## Facets
- artifact type: application
- maturity: abandoned
- function: audio-processing, http-server, cli, plugin-system
- domain: media, self-hosted, iot
- platform: self-hosted, python, cross-platform
- tags: xiaomi, xiaoai-speaker, music-streaming, yt-dlp, smart-speaker, voice-control, tts, nas, discontinued, automation, docker, web-server

## Member repositories
- hanxi/xiaomusic (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:39.357867+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:19:54.383912+00:00, confidence not recorded.
  - readme: https://github.com/hanxi/xiaomusic (fetched 2026-08-28T04:10:39.357867+00:00, sha 178701beb6dd)
  - homepage: http://xdocs.hanxi.cc/ (fetched 2026-08-29T08:19:42.380594+00:00, sha e5ea19f669ae)
  - site_page: https://xdocs.hanxi.cc/issues/99.html (fetched 2026-08-29T08:19:42.383132+00:00, sha 9cb53805ccc9)
  - registry_pypi: https://pypi.org/pypi/xiaomusic/json (fetched 2026-08-29T08:19:42.387239+00:00, sha 803ef2c0e418)
- Data as of 2026-08-30T08:39:29.467469+00:00.