📖 Documentation · 🔄 Changelog · 🐛 Issues · 💬 Discussions
English | Русский
Stream your Music Assistant library to Smart TVs through Media Station X with a native TV-optimized interface.
# Clone and set up the development environment
git clone https://github.com/trudenboy/msx-music-assistant.git
cd msx-music-assistant
./scripts/setup.sh
# Start the MA server
source .venv/bin/activate
cd ma-server && python -m music_assistantThen open the MSX app → Settings → Start Parameter → enter http://<SERVER_IP>:8099/msx/start.json.
- MA Player Provider — runs inside the MA server process, no containers or addons needed
- MSX Native UI — browse albums, artists, playlists, and tracks with remote-control navigation
- Audio Playback — direct MA Streamserver delivery with a local ffmpeg compatibility fallback
- WebSocket Push — play/stop/pause/seek events pushed to TVs in real-time (bidirectional)
- Multi-TV Support — each TV gets its own MA player via MSX device ID
- Dynamic Registration — TVs register on-demand, cleaned up after idle timeout
- Universal Groups — use Music Assistant Universal Group for multi-TV playback
- Universal — Samsung Tizen, LG webOS, Android TV, Fire TV, Apple TV
| Guide | Description |
|---|---|
| Getting Started | Installation, TV setup, first steps |
| Architecture | Provider structure, navigation flow, audio pipeline, WebSocket protocol |
| API Reference | All HTTP endpoints — MSX, audio, REST API, playback control |
| Configuration | Port, output format, idle timeout, stream delivery |
| Development | Dev setup, tests, linting, commit format |
| Contributing | Bug reports, feature requests, pull requests |
| Testing | Running tests locally, CI pipeline, coverage |
| Incident Management | Labels, automated issue tracking, Copilot triage |
| Docker Dev Environment | Run MA + provider locally without dependencies |
- Music Assistant by Marcel Veldt
- Media Station X by Benjamin Zachey
MIT — see LICENSE. See CHANGELOG.md for version history.