Charms
A charm is a button on the charm bar. It opens a web app, fires an HTTP request at a device on your network, or calls an MBXHub endpoint. The bar sits on the dashboard, and since v0.5.5.0 it is also a desktop Charm Bar (Ctrl+Alt+B), where each charm opens as its own window.
They all ship on by default — hide the ones you have no hardware for under MBXHub Settings → Dashboard → Hidden charms.
Library
Finding something to play.
-
Browse
browseAlbums, artists, genres, playlists, podcasts, radio, tracks and moods — drilldown with breadcrumbs, diacritic-aware fuzzy search, and a lazy-loading album-art grid.
Opens
/pages/browse.html -
Slices
slicesThe library as sideways rows of album covers — New, Never Heard, Favorites, Top Rated, Random, and a row per genre, year, decade, rating or mood.
Opens
/pages/slices.html -
Tree
treeAlbum artist → year and album → track, each level fetched only when you open it, with a live filter box and an A–Z rail.
Opens
/pages/tree.html -
Explore
exploreAlbums as artwork — source filters, search and sort, embedded image galleries, PDF booklets, and the artist's discography in the expanded view.
Opens
/pages/explore.html -
History
historyRecently played over a day range — title, artist and album with play and skip counts, and play or queue on every row.
Opens
/pages/history.html -
Projector
projectorImages and videos by category — a full-screen slideshow and video player with shuffle, transport and a filterable file list.
Opens
/pages/media.html
Playing
Four takes on now playing, for four sizes of screen.
-
Dashboard
dashboardThe built-in Now Playing hub — transport, rating, reactions, mood, Ctrl+K search, and the charm bar itself.
Opens
/dashboard -
Play
playMusicBee in a browser, laid out like the AMOLED skin — artist picker, a pluggable middle pane, the upcoming queue, and a full-width transport.
Opens
/pages/play.html -
Now Playing
nowplayingA focused now-playing view with drag-drop queue reorder, lyrics, comments and set lists; stacks into collapsible blades on a phone.
Opens
/pages/nowplaying.html -
Player
playerThe original three-column player — browse, now playing and queue side by side. Kept for bookmarks; play.html supersedes it.
Opens
/pages/player.html
AutoQ
Tuning the queue that fills itself.
-
AutoQ Workbench
autoqworkbenchFive windows for tuning the queue — Faders, ON-AIR, Builder, Stations and Programs.
Opens
/pages/autoqworkbench/faders.html -
Stations
stationsSaved AutoQ stations, listed and started — flow, seed count and genre-free flag on every row.
Opens
/pages/stations.html
Devices
Hardware on the network, controlled from the same bar.
-
Mixer
mixerThree independent faders — MusicBee's own volume, the Windows audio device, and a network endpoint — each with mute. The endpoint fader controls Devialet Phantom and Phantom Ultimate speakers directly: volume, mute and source selection.
Opens
/pages/mixer.html -
WiiM
wiimWiiM streamers — transport, volume, sources, shuffle and repeat, multiroom zones, a ten-band equalizer with the device's own presets, and a scan that finds them without typing an IP.
Opens
/pages/wiim.html -
Fosi
streamsdkStreamers built on StreamUnlimited's StreamSDK, starting with the Fosi Audio S3 — transport, the four physical inputs, equalizer presets, and the device's whole settings tree.
Opens
/pages/streamsdk.html -
Matrix
matrixAn OREI BK-808 HDMI matrix — audio extraction first, then per-output video routing, scene recall and power.
Opens
/pages/matrix.html
System
The hub itself.
-
Settings
settingsEvery setting the hub will expose to a browser, rendered from its own schema, with category filters and search.
Opens
/pages/settings.html -
Theme
themeColors, for this device alone or for every device on the hub.
Opens
/pages/theme.html -
ARiA
ariaAutomated remote input — wake the PC, kick off a library scan, and whatever else you add to the menu.
Opens
post /aria/wake
On the bar
The charm bar
Mixer
Devialet Phantom — via Mixer
Now Playing
Up Next
Lyrics
Build your own
A charm is a drop-in .json manifest in the charms/ folder. No build step,
no restart of anything but MusicBee. This is the whole of browse.json:
{
"id": "browse",
"label": "Browse",
"expand": [
{
"icon": "<svg viewBox='0 0 16 16' width='16' height='16' fill='none' stroke='currentColor' stroke-width='1.5'><circle cx='7' cy='7' r='4.5'/><line x1='10.5' y1='10.5' x2='14' y2='14'/></svg>",
"label": "Browse",
"action": "webapp /pages/browse.html",
"display": "standalone"
}
]
}
An action is one of webapp <path> to open a page,
post <endpoint> to call the hub, http <url> to reach a device on
the LAN, or iframe-cmd <name> to talk to the charm's own open window — which
is how the WiiM, Fosi and Mixer charms put volume and mute on the bar itself. display
decides whether the charm opens inline on the dashboard, standalone in its own window, or both.
Order and visibility live in charmBar in mbxhub.json, or on the Dashboard
tab in MBXHub Settings.
Charms in the feature tour → · Datasheet → · REST API reference →