📖 Documentation · 🔄 Changelog · 🐛 Issues · 💬 Discussions
English | Русский
Stream your Music Assistant library to Smart TVs through Media Station X with a native TV-optimized interface.
# Clone alongside the MA server
git clone https://github.com/trudenboy/msx-music-assistant.git
cd msx-music-assistant
# Setup venv, install deps, symlink provider into MA
./scripts/link-to-ma.sh
# Start the MA server
source ../ma-server/.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 — PCM → ffmpeg → MP3/AAC/FLAC pipeline with MA queue integration
- Browser Web Player — full library browser + kiosk mode at
http://<SERVER_IP>:8099/web/ - 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
- Player Grouping — synchronized playback across multiple TVs (experimental)
- Universal — Samsung Tizen, LG webOS, Android TV, Fire TV, Apple TV, web browsers
| Guide | Description |
|---|---|
| Getting Started | Installation, TV setup, first steps |
| Architecture | Provider structure, navigation flow, audio pipeline, WebSocket protocol |
| Web Player | Browser player, kiosk mode, Sendspin sync, URL parameters |
| API Reference | All HTTP endpoints — MSX, audio, REST API, playback control |
| Configuration | Port, output format, idle timeout, stop behavior, group streaming |
| 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.