Features
MBXHub provides complete network access to MusicBee with 140+ REST endpoints and full RPC access to all 137 MusicBee API methods.
Network Discovery
MBXHub announces itself on the local network using SSDP/UPnP. Find it automatically in Windows Explorer under Network → Other Devices.
Discovery Features
- SSDP broadcast on local network
- Appears in Windows Explorer Network view
- Click to open the Dashboard in your browser
- Unique device name includes machine identifier
REST API
Clean, resource-oriented endpoints for common operations. Perfect for web apps, mobile clients, and integrations.
Player Control
- Play, pause, stop, next, previous
- Volume and mute control
- Seek to position
- Shuffle and repeat modes
- Album navigation (next/previous album)
Now Playing
- Current track metadata (title, artist, album, duration)
- Album artwork (binary image)
- Lyrics
- Playback position
Queue Management
- View entire queue with pagination
- Add tracks (queue next or last)
- Remove tracks by index
- Move/reorder tracks
- Clear queue
- Play track immediately
Library Browsing
- Query files with MusicBee filter syntax
- Filter by artist, album, genre
- Full-text search
- Get/update file tags
- Browse distinct artists, albums, genres
- Pagination support (offset/limit)
Playlist Management
- List all playlists
- Create/delete playlists
- Get playlist tracks
- Add/remove tracks from playlists
- Play entire playlist
Audio Processing
- Equalizer on/off
- DSP effects on/off
- Crossfade on/off
- ReplayGain modes (off, track, album, smart)
- Scrobbling on/off
MBXQueue Integration
Smart shuffle tracking and ban list management via integration with the MBXQueue plugin.
Note: These features require the MBXQueue plugin to be installed. Returns 503 SERVICE_UNAVAILABLE if MBXQueue is not connected.
Smart Shuffle Tracking
- View shuffle cycle progress (% complete)
- Reset shuffle cycle
- View played tracks in current cycle
- View remaining unplayed tracks
Ban List Management
- View all banned tracks
- Ban tracks with optional reason
- Unban tracks
Library Sync (Preview)
File-based library synchronization between MBXHub instances. Currently in stub mode - API is defined, actual sync engine coming soon.
Sync Features (Coming Soon)
- Discover MBXHub instances on network
- Push/pull files between nodes
- Mirror or selective sync modes
- Track sync operation progress
RPC Interface
Direct access to the complete MusicBee plugin API. Call any of the 137 available methods with JSON parameters.
Method Categories
- Player_* - 30+ playback control methods
- NowPlaying_* - 20+ current track methods
- NowPlayingList_* - 15+ queue methods
- Library_* - 25+ library methods
- Playlist_* - 15+ playlist methods
- Setting_* - 10+ settings methods
- MB_* - 15+ application methods
- Podcasts_* - Podcast subscription methods
- Sync_* - Device sync methods
Security
Local Network Only
- CORS restricted to localhost and local network IPs
- Supports 192.168.x.x, 10.x.x.x, 172.16-31.x.x ranges
- No internet exposure by default
- Request body size limits (1MB max)
API Coverage
| Category | REST Endpoints | RPC Methods |
|---|---|---|
| System | 4 | - |
| Player Control | 20 | 30+ |
| Now Playing | 5 | 20+ |
| Queue | 7 | 15+ |
| Library | 15 | 25+ |
| Playlists | 8 | 15+ |
| Audio | 10 | - |
| AutoDJ | 5 | - |
| MBXQueue (Shuffle/Ban) | 7 | - |
| Library Sync | 10 | - |
| Total | 91 | 137 |
Technical Details
- Protocol: HTTP/1.1
- Content-Type: application/json
- Default Port: 8080
- MusicBee API Version: 3.1 (ApiRevision 53)
- Framework: .NET Framework 4.8