How hanxi/xiaomusic works
XiaoMusic is a self-hosted music server for controlling Xiaomi smart speakers. The main path is a spoken or web-panel command, matched by the command handler, executed by the application and device player, and fulfilled from local music or online music sources. The product also exposes web/API controls for music, files, devices, playlists, and plugins, plus authentication and configuration. The graph uses README claims and indexed imports as evidence; several unsampled subsystems are included, but their internal connections are omitted where wiring was not shown.
Main entry points: xiaomusic.py Music Service · music_library.py Music Library · dependencies.py API State and Auth · file.py File Controls
Components 24
User and API
- FastAPI App
xiaomusic/api/app.py - API Routers
xiaomusic/api/routers - File Controls
xiaomusic/api/routers/file.py - Music Controls
xiaomusic/api/routers/music.py
Playback Core
- Command Handler
xiaomusic/command_handler.py - Music Service
xiaomusic/xiaomusic.py - Device Manager
xiaomusic/device_manager.py - Speaker Player
xiaomusic/device_player.py - Voice Conversation
xiaomusic/conversation.py
Music Sources
- Music Library
xiaomusic/music_library.py - Online Music
xiaomusic/online_music.py - Audio Processing
xiaomusic/utils/music_utils.py - File Utilities
xiaomusic/utils/file_utils.py - Network Utilities
xiaomusic/utils/network_utils.py
Platform Services
- Configuration
xiaomusic/config.py - Authentication
xiaomusic/auth.py - API State and Auth
xiaomusic/api/dependencies.py - JavaScript Plugins
xiaomusic/js_plugin_manager.py - Event Bus
xiaomusic/events.py
Other components
- Speaker User
- Web User
- Music Files
- Xiaomi Services
- Online Music Services
Connections 30
- Speaker User → Command Handler: speaks commands
- Command Handler → Music Service: dispatches commands
xiaomusic/command_handler.py - Music Service → Device Manager: uses devices
xiaomusic/xiaomusic.py - Device Manager → Speaker Player: creates players
xiaomusic/device_manager.py - Music Service → Music Library: uses library
xiaomusic/xiaomusic.py - Music Service → Online Music: delegates online
xiaomusic/xiaomusic.py - Speaker Player → Audio Processing: processes audio
xiaomusic/device_player.py - Speaker Player → Network Utilities: uses network
xiaomusic/device_player.py - Music Library → File Utilities: uses file helpers
xiaomusic/music_library.py - Music Library → Audio Processing: uses audio helpers
xiaomusic/music_library.py - Music Library → Network Utilities: uses network
xiaomusic/music_library.py - Music Library → Music Files: indexes local music
- Online Music → Online Music Services: retrieves music
- Web User → FastAPI App: uses web interface
- FastAPI App → API Routers: registers routes
xiaomusic/api/routers/__init__.py - API Routers → File Controls: routes file requests
xiaomusic/api/routers/__init__.py - API Routers → Music Controls: routes music requests
xiaomusic/api/routers/__init__.py - File Controls → Music Library: uses library
xiaomusic/api/routers/file.py - File Controls → File Utilities: uses file helpers
xiaomusic/api/routers/file.py - File Controls → Audio Processing: uses audio helpers
xiaomusic/api/routers/file.py - Music Controls → API State and Auth: uses dependencies
xiaomusic/api/routers/music.py - FastAPI App → API State and Auth: initializes state
xiaomusic/api/app.py - API State and Auth → Music Service: exposes service
xiaomusic/api/dependencies.py - API State and Auth → Configuration: exposes config
xiaomusic/api/dependencies.py - API State and Auth → Authentication: checks credentials
- Music Service → Configuration: uses settings
xiaomusic/xiaomusic.py - Music Service → Event Bus: initializes event bus
xiaomusic/xiaomusic.py - Music Service → JavaScript Plugins: initializes plugins
xiaomusic/xiaomusic.py - Online Music → JavaScript Plugins: uses plugin manager
- Device Manager → Xiaomi Services: refreshes device info