MBXHub Changelog
The bridge to everything else.
v0.5.5.3 — Segue
More Cowbell
- EV4.3.1: Updated Network status in plugin settings.
- EV4.3.1: Cast to Google speaker groups — groups made in Google Home appear in the cast menu beside the individual speakers.
- EV4.3: Artists and Genres lists can split multi-value tags — one row per person or genre (Browse setting).
- EV4.1: Revised /status page reporting.
- EV4: A reload button beside the mood model in Settings.
- EV4: Music Map fullscreen keeps the map square with the tools beside it on a wide screen, and works inside the HUD.
- EV4: The Music Map’s Song view shows the playing song and why it is playing.
- Smoother transitions: AutoQ matches the end of each track to the start of the next — key and tempo, including half and double time — using TrueDat’s start and end of track analysis. That analysis (edges) is off by default; without it, AutoQ matches on each track’s main key. A new Loudness Smoothing knob evens out volume jumps between tracks (on by default). Requires TrueDat 0.5.5.3 or later.
- Better track matching: with Prefer key-compatible on, AutoQ now picks tracks whose keys mix with the one before, instead of only reordering what it already chose. Applies to the radio, Fill, stations, Generate and journeys. On by default.
- A better valence read: the mood model’s valence axis was retrained from side-by-side listening comparisons, so tracks spread across the whole range instead of piling up at the ends. Arousal is unchanged. No rescan needed.
- Choose the mood model: a new Model setting under AutoQ picks which mood model scores your tracks — Model 296 (the current model), Model 180 (the July 2026 model), or a model file you put in the hub’s data folder. Switching rescores your library on the spot; no rescan and no tag rewrite.
- Mood data straight from TrueDat: AutoQ can read TrueDat’s database directly, instead of waiting for TrueDat to export its file. Requires TrueDat 0.5.5.3 or later. Off by default; without it, AutoQ uses your mood file as before. The Workbench Mood tab tells you when your mood data is out of date.
- The AutoQ Workbench’s Features tab is refreshed: the music map now lives on the plot (library dots, the radio trail, the path ahead, hover for a track’s key, right-click to play), and the channel table moved into its own Edit channels… window.
- DV1: Roll the dice for a single track, not just an album — a new What it rolls choice on the dice page. A track roll never hands you the track already playing, and pairs with Start a station so the music keeps going.
- When MusicBee won’t start from the Shell or the HUD, it now says why.
- Slice the music map by genre, mood, artist, album, track, or a ring around the current track. Or show the top tracks: Fresh, Never heard, Most played, or one of your MusicBee auto playlists. The map zooms to what the slice lights up.
- Click an area of the music map to light that mood; fullscreen the map with its slice controls.
- Shows edges: the key, tempo and loudness where each track starts and ends — what AutoQ matches from one track to the next.
- The AutoQ settings tab is store-aware.
Fixed
- EV4.3.1: Improved handling for casting between multiple instances by the same user.
- EV4.3: Play / Next / Last on track rows work again in the player page.
- EV4.2: Cast Control opens at a fixed height instead of filling the screen, and an overlay window that fails to open now logs why instead of failing silently.
- A program plays each station for the time you set, then moves on. Starting a program replaces what was queued.
- Search: relative dates such as
added:>now-30d and the date aliases now work. Before, they matched your whole library. A date MusicBee can’t read is now refused instead of matching everything.
- The HUD’s Settings window now uses the HUD’s theme.
- The Workbench plot no longer cuts off the current-track marker near its edge.
Migration
NEW: the TrueDat store. TrueDat can keep its analysis in a store, truedat.db — a SQLite database. Open it with existing SQLite tools, for example DB Browser for SQLite or sqlite3 truedat.db (read-only while TrueDat or MBXHub is running).
Requires MBXHub and TrueDat 0.5.5.3 or later. Reading the store and the start-and-end-of-track analysis are both off by default; turn them on in Settings. Until TrueDat has built the database, MBXHub keeps using your existing mbxmoods.json.
- Clean install: run your first scan with
truedat.exe --store --edges.
- Upgrade: bring your existing mood file into the database with
truedat.exe --store-import, then rescan with truedat.exe --edges --refresh for transitions. Note: the refresh re-analyzes every file to get each track’s start and end.
v0.5.5.2 — Reflection
- EV4: Preferred Persistent Speaker (PPS) — choose your default Cast speaker in MBXCast and enable Automatic connection. Press Play to connect, or enable Keep awake to connect when MusicBee starts. Pause, stop and an empty queue keep the established connection in place.
- EV4: Wake device when starting a Cast — optionally wake your preferred speaker when playback starts, if it supports Wake-on-LAN.
- EV4: Keep awake — wake/connect to your preferred speaker without pressing Play and maintain the connection while MusicBee runs. If connection takes longer than 90 seconds, playback stops on Cast and automatic retries pause until you connect the preferred speaker manually; the next MusicBee session uses your saved settings again.
- EV4: Pop out Cast Control into a desktop overlay or a separate browser window.
- EV4: Control Cast volume and mute directly from MusicBee.
- EV4: HUD (app) and Overlay (Hub web) settings refined.
- EV4: DICE — plays a random album, on the AutoQ panel in MusicBee and the radio toolbar on Play, Stations and ON-AIR.
- EV4: Refresh Station targeting by this track or from the queue ahead.
- EV4: Music map: a ring around any track becomes a station — set its size, press Seed, and it starts.
- EV4: HUD metadata settings in HUD Settings to control how it is displayed.
- EV4: Configure which Charms are shown in the HUD.
- EV4: The HUD bonus transport defaults to Explore on new installs.
- EV3: Casting implements the Google Cast sender specification.
- EV3: Queue management refinements to the new cast engine, with two queue modes: Dedicated, where MusicBee owns the queue, and Shared, where clients can add to it. A cast now takes its mode from wherever it was started — the MBXCast panel starts a Dedicated one, anything else starts Shared — rather than from a single stored setting.
- EV3: MBXCast — a new MusicBee plugin for local console cast control. Your music across the void. Bundled with MBXHub.
- EV3: The HUD gets settings to disable the volume gesture and hide the volume controls; the gesture is now off by default.
- EV2.1: Save moods as separate tag values and choose whether to include emojis. Use Retag to update existing tags without rescanning.
- Settings, with room to breathe. A redesigned, resizable dialog that follows your MusicBee theme. Clearer grouping and focused tabs give each setting room, while visible profile explanations make API permissions easier to understand.
- MBXHub.exe now needs the .NET 10 Desktop Runtime. The companion app — media keys, first-run network setup, the Overlay and the HUD — has moved from .NET 8, whose support ends in November 2026, to .NET 10, which is supported until November 2028. If MBXHub.exe will not start after updating, install the .NET 10 Desktop Runtime and choose the Desktop Runtime column for your architecture. The MusicBee plugin itself is unaffected and does not need it:
mb_MBXHub.dll runs on .NET Framework 4.8 inside MusicBee, so a missing .NET 10 cannot stop the plugin loading — only the companion app.
- Cast MusicBee’s queue to a Google Cast speaker (beta). The speaker fetches each track itself and plays the queue unattended; MusicBee’s queue stays the one queue, and the cast keeps playing through a MusicBee restart. One Cast button on the HUD, Play and the dashboard.
- API keys: named, revocable credentials for other programs (Remote Access tab). Read or Read-write, with an explicit Execute grant for ARiA host automation. Existing keys gain no Execute permission. Action GET aliases now require their real permission: Execute for ARiA commands, Write for theme changes. The internal proxy cannot bypass key permissions by calling back into this hub.
- Live event feed on a Shared LAN needs a credential (can be turned off); local and Private LAN unchanged. Pages fetch a ticket; programs send their key on the handshake.
- Undo: take back what you just did. Ctrl+K on the web pages, Ctrl+Z in the AutoQ Workbench. One step back, covering queue, volume, mute, bans, ratings, love and skips; never AutoQ’s own changes. Queue Undo captures the entire upcoming queue with no arbitrary track cap; its offer expires when playback advances or another queue operation intervenes. The last 200 actions are kept until MusicBee restarts. Turn off web access in API Access → Disable Features → Undo History.
- The AutoQ pick journal says what it is, where it is and how to turn it on. From the status page and from AutoQ itself.
- The HUD pauses the room once, at Listen Here takeover. It leaves later room playback alone and does not switch back automatically. In mirror mode both outputs may then be heard; listeners choose which one to stop.
- Cast availability uses one shared capability check. Streaming permission, the hub’s LAN address and browser support agree with the local queue’s conversion capability. Returning to a page refreshes an older answer, and a failed receiver watcher can retry without reloading the page.
- Client Management shows each client’s requests and file transfers. Select a client for current and recent activity, original file/title, conversion preparation, ranges, successful bytes and outcomes. Reported playback shows the controlling page separately from the IP fetching audio. Hub totals and network counters have their own Hub diagnostics view.
- Device proxy traceability. See each client’s device calls, timings and results in a nonblocking Client Management window, with copyable diagnostics for support.
- End a specific transfer from the local console. End transfer targets one live request; End current transfers targets only that client’s current requests. Other transfers and shared conversion work continue. Receivers may keep playing buffered audio or request again. Copy diagnostics captures the evidence without credentials or ownership tokens.
- Cast ownership is visible without guessing from traffic. Media observation IDs associate accepted controller reports with matching file requests. Conflicts stay ambiguous; a stale report is distinct from a recorded release or displacement. Returning to Speakers or leaving the page attempts release of that exact ownership instance, so an old reply cannot release a later activation.
- Client Management adapts to smaller windows and larger text. Controls wrap, oversized content scrolls, and activity headers and rows scale with the font. Live detail updates preserve where you were reading and what you selected.
- Listen Here stays where you put it. The audio is held until you hand it back, pass it on, or walk away — another client can no longer take it from a page that is still listening, and a queue running out no longer sends it to the speakers on its own.
- A client that goes away lets go on its own. Closing a page releases the audio at once; one that crashes or sleeps is treated as gone after 30 seconds, so nothing is left holding it.
- Immersive play: the artwork on the whole screen. A control in the corner of the cover fills the display, in a browser or in the HUD overlay; the details and transport fade over it. It uses the same timings as the dashboard theme settings for immersive view.
POST /queue/play-list plays a whole list in one call. Send the urls and a position — replace starts the first track now and queues the rest behind it, next and last leave playback alone — and the tracks land in order, in one step. Until now an integrator had to play one track and add the rest one request at a time. Host only: during a party a guest is refused. A first track MusicBee cannot play is a real error with nothing queued.
- Play an album or a genre by name.
POST /library/albums/{album}/play and POST /library/genres/{genre}/play resolve the tracks on the hub — an album in disc and track order — and play them through the same path, so a voice assistant or an automation can say the name and nothing else.
Fixed
- AutoQ Workbench refresh when showing during startup.
- Cast queues continue beyond the first track in the HUD, Play and Dashboard. Remote playback can advance from the receiver’s reported position when the browser has no local buffer or end event. Late events and the previous track’s position no longer skip the next queued track, including CUE segments. An empty queue keeps Listen Here selected.
v0.5.5.1 — Rock-Kandy
- Slices: your library as rows of album covers. New, Never Heard, Favorites, Random, Unrated, then a row per genre, year, decade, rating, or mood. Choose which fields, their order, and how many rows and covers each one returns; tap a cover to play or queue it.
- Other apps can plug into MBXHub. It is easy: a charm in the charms folder just works, and apps can register over the API. The contract is the charms section of
/docs and llms.txt.
- Cast to a speaker on your network (beta). The speaker fetches the file from MBXHub itself — your FLAC, decoded by the receiver, with this PC out of the audio path entirely. That is what separates it from your browser's own Cast tab, which re-encodes whatever the tab is playing and sends the speaker a lossy mirror. Beta, and the limits are real: the Cast button appears in Chrome on an Android phone or tablet. Desktop browsers do not offer it — there you can still cast from the browser's own menu, but that is its mirror of the tab, not your file; the page has to stay open, because it is what drives playback; there is a short gap between tracks; and the queue belongs to that page, so another device cannot add to what is casting.
- The HUD opens the view that suits the device. A phone lands on Slices, a desktop on the library, and whichever you pick is remembered for that device. Your browser's own Request desktop site is respected.
- A theme can be kept on the device, or follow the hub's. The theme drawer asks where a change goes — This device or All devices — so a phone that may not change hub settings can still set its own, and Follow the hub hands it back.
- Slices rows can be per device too. Rows… carries the same choice: keep this device's own order and hidden rows, or set them for everyone. The row formulas and the row numbers stay hub settings.
- A change the hub will not accept says so. Where a device may not write the hub, that position is shown unavailable with the reason, instead of appearing to save and reverting on the next reload.
- The HUD's close box is always in the same corner.
- Click the artist or album in the HUD to browse the rest of it in your library.
- Browse opens the library full-window — the HUD's chrome gets out of the way. Esc or the close box brings it back.
- Saved AutoQ stations have their own page. Tap one to start it, from the HUD or its own window.
- Library, Mixer and Stations moved onto the Services row, out of the drawer, so switching view is one click.
- Listen Here is in the HUD’s header, beside the speaker. The switch in the Services row is still there.
- In the installed app, the dashboard header is the title bar — hub list, search and settings in it.
- Standby while MusicBee is closed. The hub page shows a Start button, asking for the hub starts MusicBee, and the tray says standby.
- A Sleep Timer in MusicBee settings → Startup. It works without AutoQ, with a choice to finish the current track or stop on time. While it runs, MusicBee's status bar shows the time left, and Re-arm timer after stop chooses whether it stays set for the next listen or clears itself.
- Browse opens on Recently Added, newest first.
- Recently Added and Random can be capped.
- Send to AutoQ can have a hotkey.
- Client Management is now under Tools → MBXHub. See client IPs, activity and traffic, save names, and allow, ban or unblock clients from MusicBee.
- Choose Private LAN or Shared LAN in Settings → API Access. Shared LAN requires allowed clients and blocks remote administration and library writes; parties can use Free Join or whitelist-based Managed Join. A new installation uses Private LAN + Free Join, with all previous default read-only protections retained. Private LAN does not enable writes or remote administration.
- PartyMode guest and leaderboard tabs now share one live connection, with one guest connection allowed per IP.
- Network setup wizard helps configure your system for Local Only, Private LAN, or Shared LAN scenarios.
Fixed
- Stop after ran past the limit. Set to 45 minutes, it could play for over an hour: AutoQ kept queuing tracks, and going off air didn't stop the music. It now stops at the limit, and the track playing when the limit is reached finishes.
- Upcoming Tracks kept showing tracks you removed from Up Next, and refreshing didn't clear them. It now shows what MusicBee will actually play.
- Fixed bindings when Allow Remote Connections is disabled.
v0.5.5.0-EV2.1 — Closing Time
- One switch stops the queue. AutoQ is now the only thing that fills it. Turning AutoQ off stops the refill and lets playback run out, instead of the queue quietly refilling from somewhere else. TrueShuffle keeps its own rules either way — it still skips banned tracks, corrupt tracks and ones you have already heard this cycle — so you no longer have to give those up to stop the music continuing.
- Stations can have a duration. Give a station a length in minutes and the radio stops once that much music has played. Tracks already in the queue play out, and the clock survives a restart rather than starting over. Set it from the station menu’s Duration… entry, or on create.
- Any run can have one too. Stop after — play for 45 minutes and stop, whatever started the music: a mood, a station, an album you sent to AutoQ. Counts music played, not the clock on the wall, and saving the run as a station keeps the duration in the recipe.
- Journeys end. A journey playing on air used to reach its destination and then keep going, because something else took over filling. It now stops when it arrives. Nothing to set: arriving is what ends a journey, the same way a duration ends a station.
- AutoQ writes down why it picked what it picked — every fill, generate, journey, station play and Send to AutoQ now leaves one summary line in the log saying what it considered, what it threw out and why, where it aimed, and what reached the queue. Where a bad queue used to be something you could only describe, it is now something you can read back. Two references walk it stage by stage: How AutoQ picks for what each stage decides, and Reading an AutoQ pick for what it records and what a wrong one looks like.
- A full decision record, when you want one — turn on
diagnostics.pickJournalEnabled and each pick is also written in full to autoq-picks.log beside the main log, and served at /diag/autoq/picks. Which eligibility rule removed a track, what every candidate scored and which part of the score carried it, what a diversity cap cut, and how the running order was chosen. Off by default; the last 20 picks are held in memory either way, so switching it on answers straight away instead of making you wait for the problem to happen again.
- Send to AutoQ reports your tracks and AutoQ’s separately — send one track and AutoQ tops the queue up with five, and you now see one and five rather than a single six that looked like AutoQ ignoring you.
- .1: Settings — Remote Control group. ARiA and the Remote App move to the API Access tab, joined by the remote exit and new remote start permissions. All four are off by default.
- .1: Stop after is a field in the Workbench — directly under Size. Type the number of minutes; empty means unlimited.
Fixed
- Send to AutoQ plays what you send — a send into a stopped queue used to sit there silently.
- “Sometimes it’ll change everything back to TrueShuffle” — right-click tracks in MusicBee → Send to AutoQ. If the radio wasn’t already on, that starts it, which flips Pick mode from Off to a real mode. Now saved, like every other way of starting the radio.
- .1: First run could pick a port that was already taken — the free-port check only looked at IPv4, so a port held by something on the IPv6 side read as free and the bind failed afterwards.
- .1: Stars and hearts told you nothing when they were switched off. Tag editing is off by default, so clicking a star or the heart painted the new state and then quietly undid it — which reads as broken rather than as refused. The controls now know they are read-only before you click, and a blocked write says so instead of flickering. Turning tag editing on is unchanged: MBXHub settings → API Access.
v0.5.5.0-EV1.4 — Double Nickel
ROCKALLEY — Boxed Set
- The View Switcher — Ctrl+Shift+S pops an Alt-Tab-style list of your saved overlay sets: arrows pick, Enter applies, Esc cancels. And every saved set can carry its own hotkey — one row per set in the Hotkeys dialog — so a whole layout is a single chord from anywhere.
- The overlay supports layout sets — any charm that opens a hub page can be its own window on the desktop. Arrange them, save the arrangement under a name, and bring it back from the tray under Overlay Sets; Snap back home puts everything where it started. The shipped Workbench set opens the five AutoQ pages in one frame with adjustable splits, and any pane tears off into a window of its own.
- The HUD works against a remote target — point it at another machine’s hub from the tray, under Settings → HUD Target, and leave the Shell where it is. Only hubs it has discovered are offered: this is for the machines on your desk, not for pointing an always-on-top window at the internet.
- The HUD can be a drawer — tucked away at the side of your desktop until you pull it out. It rests at the edge showing a small thumb, comes out when you reach for the thumb, and slides back when you leave. Pin it to keep it open, and a pinned HUD ignores Esc as well. Off by default, remembered per view, from the tray.
- Reset overlay layout puts the HUD at home — Full view, centered on the primary monitor, whichever screen it had wandered to and whether or not it was tucked away as a drawer. Tray: Settings → Reset overlay layout; your hotkeys, target and switches are kept.
- The Charm Bar — your charms in a window docked to the edge of the screen, so each one is a click from its own desktop window. Click an icon and it grows into a window; click it again and it closes. It starts as a narrow column; pull it wider for a grid, and if there are more charms than fit, arrows at each end scroll them. Dock it left, right, top or bottom — top and bottom lay it out as a row. Choose which charms it shows with the R box in the web settings charm editor; it shows them all until you untick one. A lit icon means that charm’s window is on screen; one window at a time, Shift+click for another alongside. MusicBee is its first icon — open or focus the player itself, right from the bar — and the HUD its second. Clicks never steal focus (the first click lands, a game underneath keeps its keyboard) and a hotkey summon focuses the first icon, so arrows, Enter and Esc drive the whole bar without a mouse. It follows the HUD’s target, so the charms are the targeted hub’s. And when MusicBee is closed, overlay windows show a proper “MBXHub isn’t reachable” page with a Start MusicBee button instead of a browser error — press it and everything reconnects on its own. Tray: Settings → Charm Bar, or Ctrl+Alt+B.
- The mixer knows more than one kind of speaker — Fosi and WiiM units are endpoints in their own right alongside the Phantom, answering the same volume, mute and input controls. Which speaker the fader acts on is now a choice, and mute lives on the same fader as the volume.
- StreamSDK charm — drive a StreamUnlimited streamer from the hub; the first is the Fosi Audio S3. Scan finds it and remembers it, so there are no addresses to type. Playback, volume, mute and the physical inputs are at the top; the device’s own settings tree is below, with the nine Fosi equalizer curves as one-tap presets.
- Formats your browser cannot play — WMA and the like are converted on the
way to Listen Here, so the whole library plays on whatever device you are holding rather
than most of it. The conversion happens in transit and is remembered, so a track converts once and
seeking still works; your files are never touched. CUE tracks keep their start points. Needs
ffmpeg — see docs/ffmpeg-and-transcoding.md — and is off until
you turn it on.
- Couch mode — drive the hub from across the room with a controller. Arrow around the screen, and summon the overlay without getting up. Now Playing opts in first.
- Set your own global hotkeys — from a dialog, instead of editing a config file.
- The horizontal HUD bar gains ratings and a real volume control — −, speaker, +.
- Pop a charm onto the desktop — straight from the dashboard, without going via the tray.
- Reset overlay layout — put every window back where it started, from the tray. The way out when an arrangement gets away from you.
- Loose pages can be windows too — not just charms. Any hub page you drop in can open as its own desktop window; name it under Dashboard → Window pages and it joins the list.
- Choose what is on the Charm Bar, and in what order — it follows the charm order you already set for the dashboard, hiding a charm hides it here too, and loose pages appear only when you name them under Dashboard → Window pages.
- The dialogs follow your Windows app mode (Settings → Personalization → Colors → Choose your default app mode) — dark when apps are dark, like the tray menu they open from.
- Listen Here from Browse — the headphones button now works while browsing inside the player, and CUE tracks start where they should rather than at the beginning of the file.
- Listen Here in the HUD — one switch in the HUD’s Services row sends the music to the device the HUD is on instead of the room: it picks the current track up where the room was, pauses the room, and hands back when you flip it again. The 🎧 in the HUD’s browse pane plays there too.
Fixed
- A partial network setup now says so — Settings → Network Status checks every reservation for both processes, and a startup check prompts with a one-click elevated repair.
- HUD volume and mute now move the same device — they could previously act on different ones.
- A hidden HUD stops polling — dismissed, it used to keep asking the hub for an update every few seconds indefinitely.
- The HUD goes quiet when the hub goes away — rather than sitting there showing what was true some time ago.
- The drawer wakes on a small thumb at the middle of its edge, not the whole edge, so it stops appearing when you only brushed past it. It also stops walking across monitors, and closes when it has focus.
- An unreachable speaker reads as unreachable, not as a speaker turned down to zero.
- .2: Scans find the iTunes XML wherever the library lives — MusicBee names a folder per library (“Library” is just the default’s name); discovery now follows the active library, and hub-started scans hand truedat the exact path.
- .3: AutoQ no longer stops filling after you close the Workbench — leaving it in Builder mode and closing the window left auto-fill switched off with nothing to show for it: the queue drained, nothing refilled, and there was no way to tell why. Only reopening the Workbench or restarting MusicBee brought it back. The hold now lasts exactly as long as the Builder is in front of you, and if it ever does hold, the log says so.
- .3: Home goes to your default page — the ⌂ on every page opened the /dashboard no matter what you had chosen as your default page. It now opens whatever you set, as do the address MBXHub advertises on the network and the links to other hubs on the Hubs page.
- .3: Conversion covers more than WMA — AIFF, Ogg Vorbis and Opus are converted on the way to Listen Here too. Which of them your browser actually needs depends on the browser: Safari plays AIFF where Chrome and Firefox do not, and Vorbis and Opus are the other way round — native everywhere except Safari before 18.4, so every iPhone left on iOS 18.3 refuses them. Nothing is converted because it appears on that list; the browser reports what it cannot decode, and only then is a conversion made.
- .3: The converted-file cache can be emptied — drop every converted copy and let them rebuild on demand, for when you want a conversion redone rather than reused. Your own files are never involved.
- .3: The HUD’s Devices tile is now Mixer — which is the page it always opened. It wore the headphones, which in the HUD mean something specific: the music is playing on this device. Headphones now appear in one place only, and the Listen Here switch leads the Services row rather than trailing it.
- .4: A Theme charm, a Settings charm and a Dashboard charm — three things you reach for constantly that had no charm, so they were only reachable from the dashboard. Each opens as its own desktop window, sits on the Charm Bar, and appears in the charm rail. The Theme charm runs the same editor as the dashboard’s theme dropdown rather than a second copy of it, so the two can never drift apart.
- .4: The Charm Bar has an icon size — Small, Medium or Large, from the tray under Settings → Charm Bar. Small keeps the icon and removes the box around it, so a column reads as icons rather than as buttons, and the bar itself narrows to match — not small icons floating in a wide bar.
- .4: Charm windows open clear of the Charm Bar — a window opening for the first time used to land wherever the default put it, which was underneath the bar whenever the bar was docked on that side. It now keeps a gap. A window you have already placed yourself is left exactly where you put it.
- .4: Truedat Scan button appears on the AutoQ Workbench whenever Truedat is detected.
- .4: A theme change reaches the HUD without a restart — change the theme while the HUD is open and it stayed on the old one however long you left it, whatever you did to it. It now takes the current theme every time you summon it.
- .4: The Charm Bar wears the same theme as the HUD — both are windows the Shell puts on your desktop, often side by side, but the bar followed the active mode while the HUD followed the slot you pinned it to, so the two could disagree. One slot now dresses both.
v0.5.4.9 — Persephone Under Mars
Jam Thing
- MBXHub Overlay + HUD (beta) — press Ctrl+Shift+M and the HUD appears over whatever you’re doing: a compact now-playing page with transport, queue, browse and reactions, designed at overlay width. It’s a real page too — open
/pages/hud.html in any browser. Turn it on from the Shell tray (Settings → Enable Overlay, applies live) or with overlay.enabled in mbxhub-shell.json, where the hotkey and start page also live. Ctrl+K opens the command palette right inside it.
- AutoQ Workbench on the web (beta) — five single-purpose pages behind the new AutoQ Workbench charm: Faders (the tunings on a board of faders that saves as you move them), Live (what’s playing on the mood map and the Camelot wheel, reactions right there), Builder (search, stage, push to the queue in one move), Stations and Programs (play, rename, delete what you’ve saved).
- Matrix charm — drive the OREI BK-808 HDMI matrix from the hub: pick which input feeds the audio extraction (the SPDIF leg), switch the SPDIF mode, route any input to any output with your own names for both, recall and save scenes, power. Same device-proxy pattern as the WiiM and Phantom charms — the browser never talks to the matrix directly.
- Workbench queue plays on double-click — the Queue view is the queue: double-click a row and MusicBee jumps to it.
- The HUD rolls up — three sizes, one chevron. The full HUD, a wide player bar (artwork, track, transport, volume, with progress along the bottom edge), or just transport and mute. Each size remembers its own window position and size, so rolling down to a bar and back doesn’t disturb the shape you set for the full one — and the size you left it in is the one that comes back when you press Ctrl+Shift+M. Ctrl+K still opens the palette from any size; it returns to full first, because a search needs somewhere to put the results.
- Grab the HUD anywhere — moving it no longer means finding an invisible strip at its edge. The MBXHub name, the artwork and the bar itself all drag the window, and a press that doesn’t move isn’t a drag, so the buttons still behave like buttons.
Fixed
- A copied install no longer serves the original’s mood catalog — older builds wrote the auto-discovered
mbxmoods.json location into your settings as though you had typed it. Duplicate that install — portable copies especially — and the copy carried an absolute path to the first install’s library, then quietly loaded the wrong catalog; the only symptom was a track count that looked off. That remembered path is now cleared on startup when it matches what discovery would find anyway, so the same file loads and the setting goes back to following the install it lives in. A path you set on purpose is never touched. An install that was already copied keeps its inherited path — a path cannot tell us whether you meant it — but it now tells you: when the catalog belongs to another install and this one has a catalog of its own, both Settings and AutoQ’s Mood Tools say so and offer a one-click Use this install’s catalog. Pointing at a share or another box on purpose stays a supported setup, so when there is no local catalog to fall back on you get the plain note and no button.
- Mixer’s speaker scan finds UPnP-only speakers — Scan in the Mixer charm (and in the HUD’s Devices tile, which is the same panel) swept only the speaker service types Devialet advertises. A speaker that announces itself purely as a UPnP media renderer — the Phantom Ultimate 98 dB System is one — answered nothing on that sweep and so never appeared, however many times you scanned. The scan now runs both sweeps at once, so those speakers show up alongside the rest. Everything that was found before is found the same way and at the same speed; the two sweeps run together rather than one after the other.
- Tidal, Qobuz and Chromecast are named in the source list — a Devialet speaker sends the hub a bare list of source kinds with no display names, and the Mixer put a readable name to each one from a list that had never been given those three. They arrived in the source picker as raw identifiers —
42f14c21-44ae-… — which is not something you can pick from. They now read as Tidal Connect, Qobuz Connect and Chromecast, alongside AirPlay, Spotify, Roon, Optical and the rest.
- A speaker pair’s own inputs say which speaker — on a Devialet System, the inputs that belong to a single speaker — its optical socket, its Bluetooth — appear once for each speaker. Both rows said the same word, so the source picker offered you Optical twice and left you to guess. They now read Optical (L) and Optical (R). A speaker will only report its own side, so the other one is worked out from it; where that cannot be settled — more than two speakers, or a speaker that never says which side it is — the names are left as they are rather than labeled wrongly.
v0.5.4.8 — Harmonizing
Bring Me to Life
- WiiM charm remembers your devices — no more typing IP addresses. Every WiiM the charm has talked to is kept as a row in the Device card: tap one to switch to it, tap its × to forget it, and the one you used last reconnects by itself next time. A new Scan button finds the WiiMs on your network for you — each hit is checked against the real device before it earns a row, and anything the charm knows is also offered when grouping Zones. The list lives in the browser, so your phone and your desktop can each keep their own.
- Endpoint scan speaks SSDP too — the LAN speaker scan (
POST /devices/endpoints/scan) gains a ?protocol=mdns|ssdp|all switch: mdns is the existing speaker sweep, ssdp sweeps UPnP MediaRenderers (WiiM, Sonos, TVs) and names them from their own descriptions, all runs both at once. It reports what it found and which protocol found it — identifying the brand stays the caller’s job.
v0.5.4.7 — Cities On Flame
with Rock And Roll
- WiiM charm: Zones and Output — group other WiiM speakers to the streamer over the LAN (multiroom): join by IP (remembered for next time), per-speaker volume and mute, one-tap-armed ungroup — each speaker plays the same audio, one room each. Plus an Output selector (optical out and the device's other routes) that verifies every switch against the device instead of trusting its cheerful OK. Wired entirely from bench-measured commands.
- One-click restart from this computer — local apps on this computer (like the MBXHub tray) can restart MusicBee without enabling remote exit; the
allowRemoteExit setting now guards remote callers only.
- Local restart callers identify themselves — local apps send a simple id header (
X-MBXHub-Local) to use the one-click restart. It keeps browser pages from triggering restarts and lays the groundwork for per-caller allow/deny lists.
- Tree Charm and HTML page — a single tree view that works standalone (
/pages/tree.html) or as a dashboard charm: just a list of your files by Artist → “Year – Album” → Track, with an A–Z scrubber and Play / Queue Next / Queue Last / Send to AutoQ on album and track rows.
- Network setup can help restart — when a change needs the MBXHub plugin reloaded, the setup page can restart MusicBee for you (the simple way to reload the plugin).
- Disable Features gains App Restart — check it to block app restarts entirely, even from this computer.
- Reset tuning to defaults — the AutoQ Workbench’s Tuning tab can put every knob on it back to the shipped defaults in one step, after asking first. It resets what that tab shows and nothing else: your mood channels, stations, programs, filters and Send To settings are left alone.
- Named tunings — save every knob on the AutoQ Workbench’s Tuning tab under a name and bring it back whenever you want: one set for late nights, another for a party, and no more losing the old numbers the moment you try something new. The Tunings button on that tab saves, loads and deletes them, asking first before it overwrites a saved set or replaces what you have tuned now. A loaded tuning changes those knobs and nothing else — mood channels, stations, programs, filters and Send To settings stay put, and a station that overrides one of these keeps its own value.
- WiiM charm — control a WiiM streamer from the dashboard the way you already control a Phantom: transport, volume, source and now-playing, reached through the device proxy.
- WiiM charm: the full console — the charm grows an equalizer card (on/off, the device’s 24 named presets, and all ten bands as sliders — a custom curve without the vendor app, driven through two API commands the official docs don’t admit exist), a presets grid that shows your saved WiiM presets by name, shuffle and repeat, and a device status card with output mode, casting flag, remote battery and a writable left/right balance slider. Every control follows the same honesty rule: the speaker’s OK is never trusted — the page reads the state back and shows what the device actually did.
- WiiM charm is hidden by default — most installs don’t have a WiiM; the charm now starts in the hidden list. Have one? Un-hide it under Dashboard → Hidden charms.
- FIX: two tuning values could not be saved correctly. RMS Max and MFCC Min sat outside the range their own controls allowed, so saving the tuning page quietly wrote a different number than the one that shipped — on the web console the real default could not even be typed in. Both controls now accept the full range the server does.
- Charms can talk to HTTPS-only devices — the device proxy (
POST /api/proxy) now forwards https:// as well as http://, so gear that only answers on HTTPS with its own self-signed certificate — WiiM streamers, for one — is reachable from a charm at last. Those certificates are not checked: the connection is encrypted but MBXHub cannot prove which box answered. Nothing else changes — the same private-network-only rule applies, and every other connection MusicBee and MBXHub make still verifies certificates as before.
- FIX: a Bluetooth / hardware play-pause button no longer double-toggles — one press to resume could play for a second then snap back to paused (and the reverse when pausing). Windows was delivering the same press twice: once natively, then again through its media-key routing a moment later. MBXHub now recognizes and ignores that duplicate.
- Volume Knob (opt-in) — the Shell can take over a hardware volume knob or media dial and give it finer steps than Windows’ fixed 2%: 1% a click, about a quarter of the range per turn, with an on-screen readout and play/pause on the knob’s click. An analog mode is there too, where a fast spin sweeps like a pot. Off by default; turn it on under the tray Settings menu.
- FIX: Bluetooth / hardware play-pause echo suppression is now origin-aware and more robust on slower machines.
- “More like this” now listens to the music — finding tracks similar to one you like used to compare only the words on the file: same genre, same artist, a close BPM tag, a close year. It now compares how the two tracks actually sound, using the same judgment AutoQ uses to decide what plays next — mood, harmonic color, key, tempo, timbre and dynamics — so a track that genuinely fits can surface even when it shares none of your seed’s labels. Artist and genre still count, they just no longer decide on their own. Every suggestion says why it is there (chroma 92%, same key, close mood), or shows tags when a track has not been analyzed yet. This lifts the similar lists you already use — on the browse page, the dashboard, the player and Party Mode — without changing how any of them look. The musical reasons fill in as your library is rescanned; until then it behaves as it always did.
- Tray menu follows your Windows app mode (Settings → Personalization → Colors → Choose your default app mode) — dark menu when apps are dark, light when light, switching as you change it.
- The startup toast says what you can do — instead of just “running”, it lists each feature and whether it is on: media keys, the Volume Knob, and where to turn one on if it is off.
- Arc — new page (
/pages/arc.html), work in progress.
- Harmonic texture & dynamics tuning — two new sliders on the AutoQ Workbench’s Tuning tab (and the AutoQ web console). Harmonic texture weight adds graded, continuous chroma similarity to the continuity blend — where the Key weight knows only whether two keys are compatible, this hears how much the two tracks’ actual harmonic color agrees, within and across the key. Dynamics weight favors neighbors with a similar loudness feel. Both ship at 0 (off) and take effect as your library is rescanned with a truedat that records the new data; the queue’s why-trail shows each pair’s chroma agreement (“Texture: N% chroma”) as the data arrives, so you can judge the signal before turning it up.
v0.5.4.6 — Nuts and Bolts
- New first-run setup (OOBE) on new installs — a one-screen welcome with a QR to open MBXHub on your phone and one-click network access.
- Self-healing network setup — if MBXHub’s network port needs a one-time Windows permission (a URL-ACL reservation), it now surfaces the setup screen, reserves the port when you allow it, and comes online on its own — no MusicBee restart. If a port genuinely can’t be used, the message says why: “needs a one-time network setup” for a permission issue, or it names the program actually holding the port — never a misleading “in use”.
- Port conflict? Switch in one click — when another program is holding MBXHub’s port, the network setup page now names it and offers Switch (move MBXHub to a free port and restart) or Exit.
- Reset network setup — run the first-run setup again from the tray menu, from the setup page (“Start over”), or with
MBXHub.exe reset. Reset never removes firewall rules or port reservations unless you explicitly ask (--remove-reservations).
- FIX: opening MusicBee with the AutoQ tab active no longer freezes it while the mood data loads.
- FIX: a track whose mood data lists an old file path (after a library move or merge) is recognized again, so it can be sent to AutoQ.
- FIX: removing the firewall setup now clears both reservations it created, not just one.
v0.5.4.5 — QQQQQ
Quintet Q — End-to-End & Quality of Life for AutoQ
- Search autocomplete: the command palette, the browse search box, and the AutoQ candidate filter now suggest search grammar as you type — qualifier names, fixed values (source:, decade:), and live artist / album / playlist matches. Press ? to see the whole grammar; start a term with - to exclude, e.g. -genre:metal.
- Autocomplete in the AutoQ Workbench — the filter and search boxes suggest qualifiers as you type (and their values — decade, source, and real artist / album / genre / playlist names from your library, matched even when you skip the accents), so you can compose
genre:, year:>=, artist:, playlist: filters and searches without memorizing the syntax.
- Filter Composer — pop the AutoQ candidate filter out into its own window: room to see the whole filter, live validation as you type, and the suggestion list always in view. Launched from the ⧉ button on the Workbench filter row; Apply saves through the same path as the inline box.
- Fixed: firewall setup now actually reserves the URL ACL the network listener needs. On a fresh install the reservation could silently fail while the tool still reported success; the Add button and CLI now create it correctly, verify it landed, and log the outcome.
- Fixed: AutoQ Workbench tab — control is now borderless, removing the stray white border in dark skins.
- Smarter first-run setup: MBXHub now picks a free network port automatically on a fresh install and offers one-click network access so phones and other devices can reach it. If the chosen port is ever taken by another program, MBXHub says so — and names what's using it — instead of failing quietly.
v0.5.4.4 — QQQQ
Quantum Q — Balance & Refinements, and a few other new things
- Tightness dial — one Tight↔Loose control sets how adventurous an AutoQ radio run is: coherent, harmonically-mixed flow at Tight, wide-roaming variety at Loose. It lives on the radio strip (play / dashboard); the Workbench Mood tab and web tuning console break it into granular Reach + Continuity plus the slide pulls. Move the dial mid-run and it takes over; set Reach or Continuity and your values land on the next fill. Saved with each station.
- DJ-style harmonic mixing — each pick flows from the previous track by key (Camelot), tempo (half/double-aware), and timbre, computed on your own library with no tagging required. The harmonic flow is trusted as far as the three key estimates agree — fully when unanimous, half on a majority, off when they disagree — reads the tempo histogram’s second peak as half/double-time evidence, and keeps chord density flowing track to track.
- See the key, and why one track follows another — the AutoQ page shows a track’s key and Camelot code; Workbench queue rows explain each transition in a DJ’s words (“8A → 9A · +1 hour”); the Channels tab carries the Camelot wheel itself, lighting every key that mixes with what’s playing.
- Save a journey — pin a start and an end track (optional stops between) and save it as a station. Every play builds a fresh middle between the same bookends, any length you ask for.
- Talk / podcast tracks stay out of mood shuffle — AutoQ keeps speech-heavy tracks out of its auto-pick pool (on by default). Coverage grows as your library is scanned; tracks you queue yourself are never touched. This and the max track length sit with the other AutoQ controls on the tuning page and in the Workbench.
- Deeper track analysis on the AutoQ page — tempo-histogram peaks (half/double-time evidence), chord and tuning detail, and truedat’s speech / hi-res / transcode verdicts. Fields your last scan predates read as “—”, and the schema badge says so.
- Channels tab in the Workbench — the mood map without leaving MusicBee: channels as dots on the Valence/Arousal plot beside an editable table (add, reorder, delete, sort by energy, reset), with the playing track’s own reading on the same map. Turn on Re‑locate and click where the playing track really belongs to write an anchor the mood model learns from — the same one the Annotate page records.
- Full tuning in the Workbench — the Mood tab carries every knob the web console tunes: scoring weights, reaction and influence scores, normalization ranges, and behavior, all under one Save, with quick links to Annotate, AutoCal, A/B Tune, Labs and the web console. Every AutoQ-page slider and dropdown explains itself on hover.
- Build your own queue — the AutoQ Workbench Builder — flip the Workbench Queue tab from Mirror (auto-pilot: mirrors what’s coming up and tops itself off) to Builder and drive it by hand. Search your whole library and drop tracks into a scratchpad with the playing track on top, seed a run from what’s playing, then push the list to the queue, connect it into a journey, or save it as a station.
- Fresh — play what you haven’t heard in a while — a new AutoQ pick mode that prefers least-recently-played tracks, never-played at the top, with a Strict toggle for freshest-first.
- Shape a run in the Builder — the Workbench Builder’s Filters section now carries the controls that shape what AutoQ plays, right where you build: a Tight↔Loose Tightness dial, a Freshness pick (Never heard / Fresh / Free), and a Genre-free toggle. They apply to the current run and Save-as-station bakes them into the station. Freshness can also be set per-station and as a global default.
- See what’s driving your queue — the MusicBee Settings dialog and the Workbench now state plainly whether AutoQ, TrueShuffle, or nothing is filling your queue — and, for AutoQ, which pick mode / station / journey. “Enable AutoQ” checked while Pick mode is Off no longer reads as a contradiction: it says the queue is driven by TrueShuffle, and Pick mode “Off” now reads “Off — hand to TrueShuffle.”
- Key weight knob — tune how hard the mixing avoids key clashes: a new Key weight slider (Workbench Mood tab + web tuning console,
continuityKeyWeight) sets how much of the track-to-track continuity blend is Camelot key compatibility. Raise it for fewer clashes in the chain, zero it to ignore key entirely.
- Search by mix key, lay the queue out by mix —
key:9A finds tracks by Camelot code in every search surface, and the Workbench’s new Mix order verb reorders the list into a harmonic chain — smallest wheel move first, half/double tempo aware — so Q Next pushes a queue laid out by mix. The Builder’s Find box now speaks the same search filter language as everywhere else.
Fixed
- FIX: AutoCal coverage counts every track you rate. It only shaded cells for tracks flagged as anchors, so rating from the normal queue left the grid looking untouched — on the page whose whole job is filling it.
- FIX: AutoQ panel reactions stay readable on light skins — the like and dislike buttons were washing out into the background. All five reactions now sit on a contrast chip that follows your skin.
- FIX: Text contrast on dark-mode skins — Workbench tabs, lists, and labels no longer wash out against dark MusicBee themes; text now follows the skin with proper contrast throughout.
v0.5.4.3 — QQQ
Triple Q — Quality
- FIX: AutoQ Workbench no longer paints over MusicBee tabs — the Tools menu opens it floating, the Services › AutoQ navigator entry opens the tab, and dock/float round-trips, close-to-hide, and close-to-tab all follow which of the two is live.
v0.5.4.2 — QQ
Double Q
- AutoQ is now a tab in MusicBee — the Workbench opens as a full navigator tab: Services › AutoQ, or from the Tools menu. The docked side panel keeps the compact reaction strip.
- The Workbench travels — Tools › AutoQ Workbench › Tab or Floating…, plus a corner toggle to move between them live. Closing the floating window docks it back to the tab. Same instance either way.
- Send to AutoQ — one verb on any track or selection: MusicBee’s right-click menu, browse rows, multi-select, or Cmd+K (
POST /autoq/send). Sent tracks play next and re-anchor the programming; every send reports what it did.
- Send behavior is tunable — Reuse / Refresh / Restart slider plus queue placement, splice cap, waypoint cap, mood-magnet policy, idle-send, and station-memory boost knobs — on the Workbench’s Send To tab or the web tuning console.
- Truedat scans from the Mood tab — a Truedat Scan button with live status (auto-discovered in
Plugins\truedat\ or via truedat.path); new Truedat settings category; run(truedat) shares the same one-scan-at-a-time guard.
- The mood you pick commands Generate — Generate builds in the selected mood’s territory; (none) keeps like-your-list.
- Mood in the queue list — a Mood column (whatever field AutoQ writes to) plus full-details row tooltips.
- Q Next — the Apply verb, renamed for what it does: replace the queued-next tracks with the list on screen.
- The Queue view is the queue — the Workbench’s wide list live-mirrors your upcoming tracks: ✕ or Del removes them from MusicBee’s queue right there, Clear empties the upcoming queue, and the list refreshes itself as fills and sends land. Generate/Connect previews stay local until Q Next.
- Reactions steer the radio — 🔥/❤/👍 pull the run’s center toward that track’s mood, 👎 pushes away; remembered with the run.
- Pick the flow from anywhere — flow picker (∿) on the MusicBee panel and web strip;
POST /autoq/radio/flow for scripts; saved with stations.
- Bring your own flow —
autoq-flows.json next to your settings defines custom energy arcs; applies without restart, works everywhere flows are picked.
- The radio remembers its run — mood, flow, seeds, station memory and filter, journey destination all survive a MusicBee restart. Stop forgets on purpose.
- AutoQ Programs — a playlist of stations, each played for a set span (“Play for”: tracks / minutes / hold), composed in the Programs tab, via
/autoq/programs. Restart-resumable.
- Setlists feed the radio — setlist entries seed the tray (🌱) or Send to AutoQ (📨) directly.
- Start journey answers — Queuing… → ✓ queued, disabled during the window; double-clicks can’t queue twice.
- Local queue rows in Listen Here — double-click plays, ✕ drops; flipping output back starts from a clean mirror of the room.
- Workbench fit & finish — collapsible Setup row, content-fit columns, wider pickers, “Play for” label, Reload verb, MBXHub icon on the floating window.
- AutoQ mood: essentia-only fallback head — tracks without SMFM get a real mood read instead of collapsing toward center.
- AutoCal — new mood-tuning page — a coverage grid over the valence/arousal plane (
/pages/autocal.html): click a thin cell to find candidate tracks, audition them, and rate click-only (no pre-fill bias) — growing the anchor set the mood model trains on.
Fixed
- FIX: WMA excluded from Listen Here — no browser support; skipped with a note on the output chip, capped at 3 in a row.
- FIX: unplayable formats caught up front —
canPlayType gate before every local track; a definite no is skipped with the format named.
- FIX: the output chip shows its messages — a leftover inline style kept the 🎧 status chip permanently hidden.
- FIX: Listen Here next/back never dead-click — next at the tail hands off to the room; a finished track releases local ownership; back at the head restarts.
v0.5.4.1 — More Q
AutoQ — It’s All About the Q
- AutoQ Workbench in MusicBee — Tools → MBXHub → AutoQ Workbench: preview a mix or a journey, trim it (click a row’s ✕ or press Del), Clear to start over, apply it to the queue — without leaving MusicBee. Remembers its position and size.
- Workbench is one-stop — the candidate filter, Behavior Tuning (the same options the web tuning console edits), a Fill-now verb, and the station menu all live in the Workbench too.
- Mood tools in the AutoQ window — a Mood tab with Reload / Retag / Clear, live progress, a status line, and one-click links to the Annotate and A/B Tune pages.
- Connect from the queue — queue 2-3 tracks next, hit Connect (panel or dashboard), and the journey between them fills in right in the queue.
- Stations everywhere — save the current radio run as a station, rename, toggle genre-free, and delete — from the MusicBee panel and the dashboard, not just the browse tray.
- Retag says why — a refused mood retag now reports the reason instead of a silent “Updated 0 tracks”.
- Station memory is visible — the station picker’s new Memory button shows which tracks your reactions boost or exclude, and lets you remove a mis-tap.
- Field Factory Clear — a Clear button on the Labs page (and
POST /fields/{provider}/clear) wipes both SMFM target fields — the undo for a retag.
- Restart prompt for restart-requiring settings — settings that only take effect after a MusicBee restart (e.g. the mood tag field) now offer the restart when Settings closes.
- AutoQ filters — keep AutoQ away from parts of your library: a max track length, plus a candidate filter in search syntax (
-genre:"Test Disc" -year:1990..1999) that every fill, mix, and journey respects. Edit it on the tuning console or right in the AutoQ Workbench. Tracks you queue yourself are never touched, and a typo is rejected at save with the exact parse error.
- Media controls in the notification shade — when streaming to your device, play.html now feeds the system media panel (Android notification shade and lock screen): artwork, track info, play/pause, next/back, and seek.
- Read-only means read-only — the master
apiReadOnlyMode switch now covers AutoQ too: with it on, radio starts, reactions, retags, station edits, and every other AutoQ write are refused (403), matching the switch’s “blocks ALL writes” promise.
- Build and Wind-down flows — two new energy arcs alongside Smooth and Wave: Build opens each batch below the mood center and climbs above it; Wind-down does the reverse — pick them anywhere a flow is picked (Workbench, browse tray, the connect/generate APIs, saved stations).
- Per-station filters — each saved station can carry its own filter in search syntax (
year:1965..1979 -genre:Live) on top of the global one: global keeps the house rules (no test discs, no marathon tracks), the station filter shapes that station’s flavor. Edit it in the browse station picker or the station menu; typos are rejected with the exact parse error.
- Journeys sized by time — ask Connect for
45m instead of a track count and the journey fills to that much music — no more hour-long plans built from a pile of one-minute tracks.
- Trained mood model on by default —
useTrainedModel now defaults to on, so the trained V/A model drives AutoQ out of the box. Switch it off in the tuning console to fall back to the legacy weighted-sum formula.
Beyond the Q
- Worked example: MCP server for AI agents — not part of the release, but new alongside it: a one-prompt build of a seven-tool MCP server that lets AI agents drive MusicBee through MBXHub — library search, transport, now playing, playlists. Prompt, walkthrough, and download: mbxhub.com/features.html — Build with AI.
- A-Z scrub bar on Genres — the browse Genres tab gets the same letter index the artist list has: tap a letter to jump, drag to scrub.
- Media folder shorthand —
Pictures and Videos as media folder paths resolve to the Windows profile’s known folders.
Fixed
- Listen Here takes over cleanly — flipping output to this device now pauses the room and resumes the same track in the browser at the same position; flipping back stops the local stream and hands playback (and position) back to the room. And a phone-side stream error no longer skips MusicBee ahead — errors show on the output chip and never touch the queue.
- Listen Here toggle starts the stream — switching output to this device while a track was playing flipped the icon but never began browser playback, leaving play/pause unresponsive. The toggle now starts streaming the current track immediately.
- Queue verbs see what you see — Connect, Apply, and the auto-fill trigger counted already-played tracks hidden from Upcoming Tracks, refusing valid queues or skipping an empty one. Everything now follows MusicBee’s real play order.
- Numeric search filters actually filter —
duration:, year:, bpm:, comparisons, ranges, and decade shorthands were silently ignored when the query ran against MusicBee — the search looked fine but the numeric clause had no effect. They now filter correctly everywhere search syntax is accepted, including the new AutoQ candidate filter.
- Playlist picker groups folders — the browse add-to-playlist picker now groups foldered playlists the same way the charm does.
- Artist drill-down finds album-artist albums — album lookups by artist matched only regular artist fields on non-CUE rows, so albums credited via album artist could vanish from an artist’s drill-down. The post-filter now matches album artist too.
v0.5.4.0 — AutoQ Radio
Requirements
- MusicBee 3.5+ required — the plugin's API floor moves to MusicBee 3.5 (API rev 57). In exchange: expression evaluation and the no-artwork placeholder are baseline, search reaches the new
custom17:–custom20: tag slots, and a new TempoChanged WebSocket event relays MusicBee's playback-tempo notification. MusicBee 3.6 extras (live peak/RMS levels) still light up automatically when present.
The radio
- AutoQ-Radio — continuous AutoQ queue top-up is now a visible, explicit control: an ON-AIR light on the MusicBee panel's radio toggle and REST
/autoq/radio endpoints, with a Start fresh / Continue choice. One click takes you on or off the air.
- Seeded streams — queue a few tracks you're feeling and go on the air; the radio reads your next-up as the seed and keeps extending from it.
- PFS — Programmable Flow State — a producer in a box: each batch is ordered so tracks flow, glide, and slide instead of shuffling at random. Smooth and Wave are the first two FlowStates, and the pulls (glide tightness, slide spacing and reach) are tunable settings.
- Picks draw from your station's sound — radio fills now pull from the tracks that live near your station's mood, sized to how far Smooth or Wave is meant to roam, instead of leaning on taste scores alone when a session is quiet.
- Better picks from day one — with no listening history yet, upcoming tracks now follow the mood of what's playing instead of defaulting to the same familiar handful, and generated playlists draw from your whole scanned library.
- Browse seed tray — pick up to 3 tracks in Browse, Generate a reviewable list like them, then queue it, save it as a playlist, or start the radio from it.
- Curate before you commit — every row in the generated seed list can be removed with one click, so what you queue, save, or take on the air is exactly what survived your pruning.
- Journeys — pick a start and end track (optionally a midpoint) in the browse seed tray and Connect builds a playlist that travels between them, following the selected flow. Start journey queues it next without interrupting what's playing.
- Refresh works off-air — picking a mood or pressing refresh now fills the queue even when the radio is off (a one-time fill; ON-AIR still governs continuous programming).
Saved stations
- Saved stations — name an assembly (seeds + flow) in the browse tray and replay it later with one click: seeds queue next, the flow applies, and you're ON-AIR seeded. Stored with the same discipline as saved searches.
- Stations remember your reactions — downvote or ban a track while a saved station is on the air and it stays off that station's fills next time you play it; favorite one and it's more likely to come back. Global taste keeps learning from every reaction as before — this is on top, not instead.
- Stations stay in their lane — genre variety quota is off for seeded stations by default, and it's a per-station/per-channel switch.
- Saved stations from the panel — the MusicBee panel gained its own 📡 button to list and play a saved station, from MusicBee directly.
Every surface, same controls
- Dashboard and play, on the air — the full radio control set now lives on the dashboard charm and the play page transport, not just the panel: mood menu, ON-AIR toggle, seeded start, saved stations, and a status line that says what's playing and why.
- Narrow screens page, not cram — on tight widths, station controls and reaction buttons swap in and out with a dot pager (swipe on touch) instead of wrapping into a jumble — same pattern on the panel, the dashboard charm, and play.html.
- Panel refresh — the mood dropdown is now a compact button-menu, and the now-playing mood shows emoji icons with detail in tooltips.
- Charm menu — the Charm's mood control is now a compact button-menu too, matching the panel.
- Panel flows with you — the MusicBee panel reflows to fit: controls wrap onto rows as it narrows, and at tight widths it splits into two pages — station controls and reactions — with a dot pager to flip between them.
- Tastes refresh — the Browse Tastes blade gained a refresh that forces a fresh taste re-score, so a stale group can be shaken loose on demand.
Mood model
- Disagreement-targeted labeling —
GET /vam/annotate/next?mode=disagreement serves the unrated track where AutoQ and SMFM disagree most, and the annotation page shows SMFM's second opinion as an S marker beside the model ghost — labels go where the two V/A systems disagree, the highest-information tracks for the next retrain.
- Mood model RC2 hardening — missing SMFM scores and mode (major/minor) are now mean-imputed instead of zero-filled, with the same means used at training time and at serve time (no train/serve mismatch); major/minor mode is now a valence feature in its own right.
- Rebuild gear — a new
GET /vam/train/moods export, a rebuild-mood-model.cmd wrapper that trains a candidate model and gates it against the current one, and a gate-threshold calibration tool. Promotion of a retrained model stays a manual, deliberate step.
- Promote without restart —
POST /vam/model/reload now recomputes every cached track's valence/arousal in place, so a promoted model takes effect the moment it loads. Previously the cache kept serving the old model's values until MusicBee restarted.
- New embedded mood model — 24 features, 146 anchors — the shipped V/A model is retrained on the full anchor corpus with mean-impute and one new input: musical mode (major/minor), a direct valence cue the model previously had no access to. Valence accuracy jumps from LOO r=0.64 to r=0.87, the served valence range now matches the spread of human ratings instead of piling up near the middle, and valence no longer shadows loudness or tempo. Arousal stays at its already-strong r=0.93.
Fixes
- Fixed: continuous AutoQ top-up no longer requires Shuffle to be enabled — while you're on the air, the queue stays topped up on its own.
- Fixed: reacting to a track no longer makes open dashboards flash — stars and the love icon update in place instead of reloading the page.
v0.5.3.9 — Counting Streams
Play counts
- Listen Here plays now count — browser-streamed playback reports track exits to the new
POST /player/report-play endpoint. The server applies MusicBee's own play-count thresholds (percent/seconds), so streamed plays update play count, Last Played, skip count, and scrobbling exactly like speaker plays. CUE virtual sub-tracks are measured against their own duration and offset. Counted plays also feed AutoQ session signals and TrueShuffle cycle progress (neither is required).
- Play-count control switches — two new settings in the plugin's feature-disable panel: Play Reporting (
apiDisablePlayReporting) turns off just the Listen Here reporting, and Play Count Updates (apiDisablePlayCountUpdates) blocks every external play-count path — report-play, update-play-statistics, and RPC — so no API client can modify MusicBee play statistics. Both default off; MusicBee's own counting is never affected.
- Over-reporting guardrails — play-statistic updates share one per-IP rate limit (
rateLimitPlayStatsPerMinute, default 60/min, 0 = off, loopback exempt, independent of the party rateLimitEnabled switch) across all three API paths, and duplicate reports for the same track from the same client are absorbed within an adaptive window. Behavior change: /player/update-play-statistics now honors party-mode player access like its RPC twin — guest clients recording plays during a party need player permission.
- Exit-intent accuracy — non-deliberate exits (closing the tab, switching output back to speakers, another client changing MB's track) report as abandonment: a play if past MusicBee's threshold, nothing otherwise — never a fabricated skip. CUE virtual sub-tracks are judged against their CUE-sheet duration and never collide in the duplicate-report window.
Party mode
- Browser streaming gated during parties — a new Allow streaming switch in the PartyMode dialog (
partyAllowStreaming, default off). While a party is active, GET /stream (Listen Here, and video/PDF over the same route) returns 404 for everyone unless the switch is on; /system/features reflects the gate so clients hide the Listen Here control.
Review surface (Duplicates, preview)
- Manifest-driven decide layer — a generic review surface for fleet operations. Offline tools drop review manifests into
<AppData>\MBXHub\review\; the hub serves them (GET /review/manifests, GET /review/manifest/{id}) and stores operator verdicts beside them (GET/POST /review/verdicts/{id}). /pages/review.html renders any manifest kind generically (diff, dupes, identity, coherence) — the same renderer ships in a standalone file:// door. A manifest may point at a self-contained interactive companion (source.reviewHtml, e.g. truedat's co-emitted dupes.html), which GET /review/asset/{id} serves same-origin. The hub never computes diffs or applies verdicts; detection and apply stay offline. The manifest {id} is the drop file's name stem.
- Always fresh — the review page and its renderer are served
no-cache so a browser can never get stuck on an old cached copy of the UI (which would hide the ruling controls).
Mood tuning
- Live mood tuning — rate a track on the annotation page and its mood prediction (valence/arousal) shifts immediately. A rating stores a base-relative correction applied on top of the trained model at serve time, kept in a separate
mood-residuals.json keyed by audio-stream hash — fully resettable and changing no files of record. The loaded model stays the yardstick; corrections layer over it and clear back to pure model output at any time.
- Mood model v3 — SMFM fusion — rebuilt the AutoQ mood model on a curated, high-reliability anchor set for a much sharper valence (bright ↔ dark) read. Where SMFM data is present, its mood signal is fused (low-weight) into the model, correcting tracks the audio alone misreads — bright-but-calm songs (e.g. Norah Jones “Don't Know Why”) no longer land as dark. Degrades gracefully: libraries without SMFM get the full model, unaffected.
- No mood-source setting — the manual AutoQ/SMFM “mood source” dropdown is gone; the model now uses SMFM automatically where present and audio analysis everywhere else, with nothing to configure.
- Your ratings sharpen the model — the moods you rate on the annotation page can be folded into an updated model that fits your taste better, and every update is quality-checked before it goes live so it never makes predictions worse.
v0.5.3.8 — Field Factory & Half-Star Ratings
Field Factory — custom field support
- Field Factory — compute and write MusicBee
Custom* fields from pluggable providers. First up: SMFM, writing each track's top mood-channel labels from the Truedat scan.
- Labs page — inspect a track's SMFM channel scores, drill the distribution into per-bin tracks, rename channels, retag, export the map. Experimental, default-OFF.
Search & mood
- Search any field — the search DSL now reaches
custom1:…custom16:, not just artist/album/title.
- Search by file type — new
type: filter matches by file extension (e.g. type:flac, type:mp3); combine with OR for several formats.
- Search by mood — new
arousal: and valence: range filters (e.g. arousal:>0.7).
- Rate the mood source — SMFM joins AutoQ as a second (valence, arousal) marker on the same plot; vote per axis which source reads a track better. Which source drives AutoQ's track picking is a straight choice in settings (AutoQ or SMFM), defaulting to AutoQ.
- Pick the mood-tag field — choose where AutoQ writes mood labels from a dropdown in settings: the native
Mood tag, any Custom1–16, or None to not write. The "Reactions/Mood" kill-switch now correctly blocks mood-writes, and the Ratings/Loved kill-switches are enforced on every write path.
- Auto-Heart — a Fire/Heart reaction on the now-playing track can love it in your library (solo mode). New, disabled by default; enable in AutoQ settings.
- Choose the mood source — AutoQ track selection can be driven by AutoQ's own V/A or by SMFM's, picked from a dropdown in settings (SMFM where present, AutoQ otherwise).
- Clear & progress for mood tags — a Clear button removes mood labels from the chosen field, and both Retag and Clear now show live “X / Total” progress so a large write visibly shows it's working. Both are resumable — re-run to continue after an interruption.
Explore
- Browse by Mood — the Mood chip turns a mood into a flippable album deck.
- Scope your search — Artist / Album chips narrow to that field with one tap.
- Smarter album pick — picking an album from search opens that artist's whole catalog.
- Video pill — filter to albums that have videos.
Half-star ratings
- Half-star ratings — set and display 0.5 increments everywhere (player, transport bar, dashboard, lists) via left/right half-click zones.
- Easier on touch — bigger, spaced-out stars with a center line and tap-highlight so halves are easy to hit on a phone.
Optional password lock
- HTTP Basic password gate — an optional always-on password for remote access (Remote Connection Settings → Configure Access → Remote Access), off by default. Localhost, the
/ws stream, and PartyMode guests are exempt.
- Without HTTPS the password is effectively cleartext — a speed bump for a trusted LAN, not strong security.
v0.5.3.7 — Setlist Level Up
Browse, Explore, Nowplaying and Dashboard drilldown by setlist
- VAM diagnostics endpoint — new
GET /vam/diag: active model (source, version, anchors, LOO-CV), training inputs found on disk with counts + mtimes, and active-vs-suggested calibrator clarity. Read-only.
- Setlist expansion in the library browser — a track whose Comment parses as a setlist now shows an always-visible ☰ Setlist badge in
browse.html (on both the direct album drilldown and the artist→album expand) that expands the parsed songs (start time + title) inline beneath the row, mirroring the dashboard SET LIST badge and the nowplaying Tracklist tab. Lazy-loads from /library/file/{urlHash}/setlist (hash via MBXShared.urlHashOf); rows without a setlist are untouched. Read-only display.
- Virtual-tracklist badge — albums that are one file split into many tracks now show a
CUE or SET LIST chip on the browse album grid, the artist→albums list, and the dashboard now-playing card (CUE wins). New dashboardLayout.disableVirtualTracklistBadge setting (Advanced) hides them.
- Now-playing highlight in the explore setlist — expanding a setlist in
explore.html now marks the currently-playing song and follows along as the set advances (driven by the position feed), matching the active-row behavior of the Now Playing Tracklist tab.
- Up Next virtual queue — on Now Playing, the playing setlist/CUE row in Up Next expands into an inline list of the set's songs (index · time · title · duration), the current one highlighted and following playback. Tap a song to jump to it; the chevron collapses/expands, and playing the row also expands the list.
v0.5.3.6 — Transporter
Setlist Seeker
- Setlist-aware prev / next on the transport — when the playing track carries a Comment-embedded setlist, Next seeks to the next entry's start and Previous follows standard transport behavior within the setlist: within 2 seconds of an entry's start it jumps to the previous entry, after 2 seconds it restarts the current entry. From the last entry, Next falls through to the next file in the queue; from the first entry within the 2 second grace, Previous falls through to the previous file's start. Pre-CUE files now navigate like a CUE virtual album without needing a sidecar. Comment edits are picked up within ~2 seconds (short-TTL cache, free invalidation on track change). On by default; the Disable setlist-aware transport setting (Advanced) turns it off so prev/next always skip whole files.
- Year sort handles malformed Year tags — Year tags that are really a full date now sort by their extracted 4-digit year (
20180727→2018, 2024-01-01→2024, 5/27/2014→2014, 1999/2000→1999; garbage sinks to the tail). Non-destructive: sort key only — stored tags and displayed values untouched. Covers /library/files?sort=year, the albums-by-artist year sort, and the date / year-ascending track sorts. On by default; the Disable malformed-Year sort normalization setting (Advanced) turns it off to sort by the raw tag value.
v0.5.3.5 — Cue It Up
live setlist
- SET LIST badge on the dashboard — the immersive Now Playing card lights up a
SET LIST chip in the bottom strip whenever the current track's Comment carries a time-coded setlist. Click it to jump to the standalone Now Playing page with the Tracklist tab already focused.
- Tracklist tab on Now Playing — the parsed setlist renders as numbered
index · time · title rows with a per-entry seek button. As playback crosses entry boundaries the active row highlights and a muted sub-line under the title shows what's currently playing within the recording.
- Export setlist from Comments as a CUE file — the Tracklist tab carries an Extract to CUE button. One click writes a real
.cue sidecar next to the audio file (UTF-8 with BOM, atomic write via tmp → File.Replace → .bak). The album then expands into virtual tracks across browse, search, queue, and the wavescrubber.
- Setlist heuristic — the detector recognizes three line shapes:
MM:SS Title / HH:MM:SS Title (time-first, optional - / en-dash / em-dash before title), NN - Title - MM:SS, and NN. Title MM:SS. Threshold: ≥3 monotonically increasing entries whose timestamps land inside the file's duration.
- Wavescrubber chapter ticks — vertical ticks at each Comment-embedded setlist entry's start, on the dashboard and
play.html. Reads the parsed entries directly from /library/file/{urlHash}/setlist so the feature works on the natural pre-CUE flow: MusicBee plays the whole concert FLAC as a single item, the wave canvas covers the full file duration, ticks land at file-absolute positions. Once you click Extract to CUE and MusicBee starts playing virtualized sub-tracks, the wavescrubber rescopes to the per-virtual slice and ticks no longer apply — per-track navigation moves to the queue / browse / Tracklist tab instead.
- Clickable artist & album on Now Playing — the artist and album lines drill through to browse on both the immersive dashboard card and
nowplaying.html.
- Right-click on Now Playing title / artist / album — open in browse, copy filename, copy track URL, copy deep link, copy folder path. Works on phones and tablets.
- Now Playing deep link — the copied link opens browse, expands the album, and scrolls the matching track into view with a brief highlight.
extras
- Extras panel on Now Playing — the “Lyrics” panel is now Extras and holds five tabs: Lyrics, Comment, Tracklist, Fan Art, Video. Image files in the album folder render as a thumbnail grid (click for full size); video files (
.mp4 / .mkv / .webm / .mov / .m4v / .avi) render as a list with play arrow + size (click opens the browser's native player).
- Videos on Explore — the expanded album view in Explore shows a Videos strip next to Images when the folder contains
.mp4 / .mkv / .webm / .mov / .m4v / .avi.
v0.5.3.4 — sort of evolution
for Browse — multi-artist works
- Multiple-artist and role support improvements — Album Artist and per-track Artist are treated independently. Tracks carrying multiple Artist values — whether stored as separate values or as one delimited string (
; / , / & / feat / ft / featuring / with / and / vs / presents) — appear under every contributor's drill-down. The filter consults the full role union: Artist, Performer, Guest, Remixer, Composer, Conductor.
- CUE virtual tracks expand — CUE-backed single-file albums now expand to all their virtual tracks on browse drill-down, including under
?album=&people= query shapes that previously deduped to one row. CUE virtual rows also emit albumArtist so multi-artist covers compilations keep every CUE row under the artist's drill-down.
- Roles flag for API consumers —
/library/files?roles=true returns every per-track role bucket MB tracks separately (artistsRole, performers, guests, remixers, composers, conductors, artistsUnion). Default off; only paid for when requested.
for Custom Sorts
- Custom sorts — define your own sort orders over any MusicBee tag (Custom1–16, Virtual1–25, year/sort fields) in Settings. They appear in the Albums tab's sort dropdown next to the built-ins. The Tag picker reads MusicBee's friendly tag names when configured.
- Per-track sort-field value on expand — when the Albums tab is sorted by a custom-* sort, expanding an album now shows each track's value of that sort field as a muted inline badge between the artist line and the duration. Sort by AutoQ Moods → expand → each track shows its mood. New
?include=<TagName> on /library/files drives it, accepts any tag from the 48-tag customSorts allowlist.
for Now Playing & Dashboard
- Waveform on the scrubber — peak + RMS overlay drawn behind the played-portion fill, on both the play.html transport bar and the dashboard's progress bar. Backed by MusicBee's per-track
NowPlaying_GetSoundGraphEx (served as /nowplaying/sound-graph-ex). Painter lives in a shared transport-wave.js component.
- Immersive Now Playing refresh — centered nowrap+ellipsis metadata chips build bottom-up in the lower frame; mood and format badges anchor the corners and flank the time text in a single strip.
- Progress bar XL preset — new XL size (40px / 56px with waveform) plus a sweep: S almost a hairline (2px), M/L bumped a touch (14px / 24px). Waveform fill opacity scales down with size (0.34 → 0.16) so the silhouette reads through cleanly on the chunky presets.
- Tunable progress bar — new
progressBarHeight, progressBarFillOpacity, and progressBarFillColor overrides on top of the preset. Set any one to dial the bar independently of the S/M/L/XL preset; defaults leave preset behavior unchanged.
- Mood badge — channel name only by default — the
+0.1 87% vibe-score and confidence stats are now gated behind diagnostics.showMoodDebugStats (off by default). Tuning users flip it on; everyone else gets the cleaner badge.
polish
- Immersive text scale shift — M shrinks to fit at 100% zoom; S, L, XL trimmed proportionally.
- Tunable bar lifts the metadata stack — non-zero
progressBarHeight overrides now lift .np-info, time, and mood/format with the actual bar height, not just the preset class.
- Encoding-aware CUE parsing — BOM detection, strict UTF-8, and Windows-1252 fallback now applied on every CUE read.
- Safari backdrop on explore & browse — paired
-webkit-backdrop-filter rules so the chrome blur renders on Safari and iOS.
- Artist counts agree across surfaces — cmd-K, drilldown, browse-search, and
/library/albums/by-artist all report the same album count (via ArtistPeople); featured-on entries surface from every path.
- CUE album count reconciles after expand — the artist-album badge updates to the expanded track count once virtual tracks land.
- Dashboard up first on startup — renders immediately; library refresh, AlbumIndex pre-warm, and AutoQ mood cache build sequentially in the background.
- Search returns every matched album —
/library/search no longer caps the album fan-out; broad substrings now surface every CUE compilation, not the first 50.
- Duplicate CUE entries in playlists — each occurrence of the same CUE album now expands its full virtual-track list; previously only the first did.
- Volume rocker pre-popover — vol up/down on play.html toolbar work before the mixer popover has been opened.
- Immersive waveform layout — no more dead gap above the bar when the waveform paints in immersive.
- Non-Latin sort ordering — album titles in Cyrillic / Greek / CJK / Hebrew / Arabic sort under their own scripts; ASCII unchanged.
- Malformed-numeric sort — explicit Numeric sorts with unparseable values land at the end, not the top.
- CursorLock hold-time diagnostic — warn measures hold only and emits after the lock releases.
v0.5.3.3 — new parmesan
for AutoQ — the Auto-Cal loop
Auto-Cal is a MusicBee playlist you maintain by hand. It holds anchor tracks — songs you've picked as corner / archetype examples for the valence and arousal axes ("this is what I mean by maximum energy," "this is what I mean by deepest sad"). Everything below either feeds into that playlist, reads from it, or measures how well the model still agrees with it.
- Auto-Cal playlist — new
vamAnchorPlaylist setting (default "Auto-Cal") names the playlist that holds your anchors. Resolved by name on every request, so renaming in MusicBee takes effect without a restart.
- Annotations — the annotate page serves Auto-Cal tracks first and auto-flags them as anchors on commit. Pre-fill mode lets you rate or correct an existing label instead of starting blank.
- Gates — new panel at the top of the AutoQ Tuning Console. Joins the Auto-Cal playlist with your annotations and shows how well the current model scores them. Anchor in, drift out.
- Pairwise tuning, joined up — the A/B judgments from
/pages/tune.html and the anchor labels from the annotate page now feed the same calibrator. One loop: judge, anchor, measure, retrain.
- Mood Data card — the AutoQ console shows track title, artist, and genre next to the mood values, so you know which song produced the numbers while you're tuning.
- More mood signals — AutoQ reads new Essentia features (HPCP entropy and crest, HFC, spectral complexity, chord strength) and weighs them with a trained Ridge/PCA model.
- Trained model toggle — new
useTrainedModel setting (default on). When off, AutoQ uses the legacy weighted-sum formula and every slider, intercept, genre bias, and the Calibrate / Suggest buttons in the Estimation Mixer are live. The console shows the active path (model vs formula vs missing) and auto-hides the fallback sliders when they don't apply.
- Model on disk supersedes embedded — drop a fresh
mood-model.json into %AppData%\MBXHub and it wins over the copy embedded in the DLL. POST /vam/model/reload picks it up without a restart. Closes the no-rebuild iteration loop on the retraining side.
for Listen Here
- LocalQueue on play.html — Play / Queue Next / Queue Last from the play, browse, and explore iframes drive a browser-side queue in Listen Here mode instead of POSTing to MB. Room stays silent; CUE offsets ride through. Restores v0.5.0.6 behavior lost in the iframe split.
- Rating routes to local track —
POST /dashboard/rate/{n} honors ?url=; play.html passes the current Listen Here track. Album view also normalizes 0–100 / POPM star scales from non-MB taggers.
for Discovery
- SSDP banned-peers list — New ListBox under Network in the settings dialog. Listed IPs are dropped silently at the SsdpCore level before MX delay. Persisted in
mbxhub.json, admin-only.
for Now Playing
- Lyrics/Comment toggle — when a track has both a lyrics tag and a non-empty Comment tag, the lyrics panel header on
nowplaying.html swaps the static “Lyrics” label for a [Lyrics | Comment] segmented control. Click to flip the body between the two. Comment-only tracks keep their “from comment” chip. Gated by LyricsFallback; ApiDisableLyricsFallback suppresses the new field too.
- Always-show Immersive seek bar — new Dashboard setting
ImmersiveAlwaysShowProgress keeps the seek bar at full height in Immersive mode instead of fading with the rest of the chrome. Off by default; flip it on under Settings → Dashboard.
for VAM Gates
- Configurable anchor playlist — new AutoQ setting
vamAnchorPlaylist (default "Auto-Cal") replaces the hard-coded playlist name in GET /vam/gates/report. Resolved by name on every request, so renaming the playlist in MusicBee takes effect without a restart.
for History
- 1y window — the time-range chips on
/pages/history.html add a 1y option after 30d, lifting the previous 30-day ceiling for browsing recent plays.
- Always lands on Today — first load defaults to the Today chip regardless of what was selected last; small / fast query renders the page within a fraction of a second.
- Background warm — the 1y cache starts building in parallel right after the initial Today render. By the time you click 1y the cache is hot, so the longer view is instant. First-page UX no longer waits on the larger query.
- History card on the index page —
/pages/ picks up a History tile between Play and Explore.
for Browse
- Single-track album row clicks land — loose-file albums whose MusicBee auto-grouped name doesn't match the file's Album tag returned zero rows from
/library/files, so the album-row expand looked dead and Play / Next / Last silently no-op'd. Inline expand and the per-album action buttons now share the same firstTrackUrl fallback the breadcrumb drilldown already had — clicks produce a real track and the buttons play it.
- Album-subheader Play button — the per-album Play affordance in artist drilldown now renders with an explicit inline-flex style and the ▶ glyph used elsewhere, so it can't fall out of the DOM under any combination of upstream CSS.
polish
- Branch suffix on non-release builds — version chip reads
v0.5.3.x-<branch> off master / main; tag builds stay clean.
- Media drawer — wider (
min(85vw, 480px)), filter input above the list, basename in the tooltip.
- Media category visibility — recursive now, matches the scanner.
- Immersive NP small size — title cluster no longer clips or escapes the panel.
v0.5.3.2 — relentless
drive
- AutoQ mood bands — new
Relentless 💀 and Edge 🤘 channels, default channel positions and combo threshold tweaked. Existing user configs auto-migrate the new bands on first load.
- Only show local images — new Media setting blocks online artist-picture sources (last.fm and friends). Off by default. Toggle on to keep
/library/artist/{name}/pictures and /nowplaying/*-pictures on disk-only.
- Mixer charm header + mute tighten up at small sizes — the app-launcher header button is now ⅓-width and the mute button is ½-width inside the charm row, across all five charm sizes (S/M/L/XL/XXL). Frees horizontal room for the volume slider on cramped bars.
- play.html A-Z artist scrub bar — iOS-Contacts-style vertical index pinned to the right edge of the artist column. Tap a letter to jump; drag along the bar to live-scrub the artist list with a centered letter overlay. Letters with no matching artist are dimmed. Touch-first surface for tablets where the existing keyboard typeahead doesn’t reach.
- play.html search chip — magnifier button next to the album/artist toggle opens the Cmd+K command palette on tap, so tablets and touch-only sessions get the same federated search surface the keyboard shortcut already provided.
- AutoQ pairwise tuning — new
/pages/tune.html shows two tracks A/B with their current AutoQ classification; pick which is more intense or more positive per axis (1/2/3/0 keys, A/B to listen). Judgments accumulate to mbxtune-pairs.json and /autoq/tune/scores returns the Bradley-Terry ranking — raw material for fitting V/A weights against actual user judgment instead of theory.
v0.5.3.1 — bring it on home
come together
- History page —
/pages/history.html — recently played tracks with day-range chips and per-row P / L queue buttons. New dashboard footer link, disabled by default; enable via the Dashboard footer-links settings UI.
- Hubs page —
/pages/hubs.html — picker of every MBXHub instance this browser has seen on the network, plus a manual host:port box. Fed by GET /system/hub-neighbors (Shell SSDP scan) and local browser memory. New dashboard footer link, disabled by default.
- View transitions — cross-fade between shell pages in Chromium browsers.
- Tray Libraries pre-warm — first open is instant instead of a 3s “Searching…”.
- play.html transport metadata fix — was missing on narrow portrait, duplicated on widescreen + Now Playing. Now mode-driven at every width.
- Listen Here on play.html — output toggle in the transport flyout. Speakers (room / MusicBee, the default) or this device's browser (private audio via
/stream/<file>). Play/pause, prev/next, volume, mute, scrubber, and auto-advance all route to the active side. Flipping to browser pauses MB; flipping back resumes. Small 🎧 chip in the transport bar shows the current target. Persisted per-client in localStorage.
- Explore icon cycles album / detail view — same icon on the play.html transport. First click activates explore, subsequent clicks toggle the expanded hero + track-list overlay. Same hook the T / Enter keys have always exposed.
- play.html volume rocker + mute follow mixer default fader — transport
+ / − and mute on play.html now route through the mixer iframe via postMessage — the same charmCmd protocol the dashboard mixer charm uses. The active default fader (player / device / endpoint) is honored end-to-end. WS VolumeChanged no longer stomps the slider in device / endpoint mode — the iframe is the single source of truth, reporting back via charmVolume / charmMute. Prior bugs the rework displaces: rocker piggy-backed on a /mixer/volume PUT that only handled player + device (not endpoint); mute always hit the player regardless of fader.
/mixer/volume wires endpoint fader — GET + PUT now resolve the active endpoint (first entry of endpoints[]) and call GetVolumeAsync / SetVolumeAsync directly. Soft-fall-back to Player_GetVolume / Player_SetVolume if no endpoint is configured or the Devialet call fails — the actual fader hit is surfaced in the response so the client knows where the request landed. This completes the slider-drag path for endpoint mode (rocker + mute were already routed via the iframe).
- browse search expanded in iframe — the click-to-expand search icon stays only at phone widths (<700px). At desktop / tablet widths the input is always full-width so you can start typing immediately.
v0.5.3.0 — cmd and search more
- Federated search endpoint — New
GET /search?q=&buckets=&limit=&cursor= runs typed buckets in parallel (tracks / albums / artists / playlists / saved / etc.) with cursor pagination on the tracks bucket, facet counts, and a top-hit response. Backs the Cmd+K palette and any client wanting a single call instead of fanning out. ?dsl=true opt-in routes the query through the new DSL parser.
- Search DSL — Qualifier syntax (
artist:, album:, genre:, year:, rating:, fmt:, range / boolean / grouping operators) on top of the existing strict / substring modes. Opt-in per call via ?dsl=true on /library/search and /search; cheat sheet at GET /library/search/syntax. Default off so existing free-text callers are unaffected.
- Saved searches (CRUD + scheduled evaluation) — Persist a query under a name and have the server re-run it on a schedule.
GET|POST /search/saved, GET|PUT|DELETE /search/saved/{id}, GET /search/saved/{id}/results, POST /search/saved/{id}/run. Backed by mbxhub-search.json next to mbxhub.json. Background SavedSearchScheduler ticks per-saved-search interval, evaluates, diffs against last-match URLs, and broadcasts a new SearchMatched WebSocket event when matches change. Enabled by default; toggle via library.search.savedSearch.enabled. Write/mutation routes honor ApiReadOnlyMode.
- Search history —
GET /search/history?limit=N, POST /search/history (append; empty body clears), DELETE /search/history. Server-side recents log shared by Cmd+K and any other search bar; falls through to client localStorage if the endpoint is missing or 404s. Mutations gated on ApiReadOnlyMode.
- Search-engine state surface —
GET /system/search-index reports the live engine (currently mb) and its index state. FTS5 substrate dropped during the post-decouple harvest; the seam is preserved so a future engine can plug in without touching the call sites.
- Cmd+K command palette on play.html — The keyboard-driven palette that’s lived on the dashboard now drops into
play.html too. Shared cmdk-bootstrap.js loader, same actions (Play/Pause/Skip/Volume, Open Charms / Settings / Mixer / Player / Browse / Explore / ARiA, Start AutoQ radio), same federated search, same recents. Press Ctrl+K from anywhere on play.html.
- Cmd+K palette shows global keyboard shortcuts — Action rows now display the global hotkey alongside (e.g. Play / Pause → Space, Skip → →, Previous → ←, Volume up/down → ↑/↓). The cmdk doesn’t bind these — the host pages already do — the palette is just a discoverable cheat sheet.
- Track comment as lyrics fallback — When
/nowplaying/lyrics has nothing real to return, MBXHub now surfaces the track’s Comment tag in the lyrics panel with a small “from comment” chip above it. Concert setlists, venue notes, and album liner notes show up where lyrics would on nowplaying.html (and therefore on play.html, which embeds it). Configurable via the LyricsFallback settings section (Enabled, MaxDisplayChars, Label); hard-killable via ApiDisableLyricsFallback.
- Installable web app (PWA) — MBXHub ships a Web App Manifest (
/manifest.webmanifest) at root scope so every host page (dashboard, play.html, explore, browse, …) is installable to the home screen / desktop. PWA icon set at /icons/{name} — icon-192.png, icon-512.png, maskable variants, plus the 180px Apple touch icon — generated as MBXHub. Manifest name picks up the host’s display name dynamically (__HOST_NAME__ substitution); start_url is / so launching the icon opens straight to the dashboard.
v0.5.2.9 — Play On
play more more play
- play.html artist typeahead — Type a single letter into the artist column to jump to the first match (1.2s pulse-highlight); type two or more to filter the list down to substring matches. Esc, Backspace-to-empty, or selecting an artist clears. Filter mode is sticky — no idle-clear — so you can read the matches at your own pace.
- play.html parity with player.html — Reactions row in the AutoQ cluster (fire / heart / like / dislike / ban →
/autoq/react), “+ Add To Playlist” dropdown beside love and stars (last-used playlist bubbles to the top with a star marker), ARiA presets dropdown in the overflow flyout (auto-hides if ARiA isn't enabled), influence thumbs (artist + genre) on the right-column now-playing card, global media-key shortcuts (Space = play/pause, ← = prev, → = next), and a 30s position-poll safety net behind the WebSocket. Player.html's add-to-playlist + reactions + ARiA + influences are now fully mirrored on play.html.
- Browser logs go to mbxhub.log — play.html now batches
console.warn/error sites through POST /system/client-log on a 2-second flush (and sendBeacon on pagehide). Same model dashboard already uses; users running Release builds with no devtools open now see browser-side errors in the file log.
- play.html overflow flyout auto-closes after firing an action — Tablet/phone overflow popover used to linger after clicking a button inside it; now dismisses next-tick except when the click hits a sub-popover trigger (Add To, ARiA), which keep the parent alive while their menus are open.
- play.html artist drawer is sticky in tablet-landscape — In 700-1023 landscape, the slide-over drawer no longer dismisses on click-outside — you can poke around the middle pane without losing your place. Escape, the drawer-toggle button, and picking an artist are the explicit close paths. Phone / portrait-tablet keeps the original click-outside dismiss because the drawer covers most of the viewport there.
- Play charm — New first-class “Play” charm with an outline-triangle icon that opens
/pages/play.html as a webapp surface, mirroring the existing Player / Explore / Browse charm convention.
- Dashboard no longer steals focus on track change —
updateTrack now uses the soft inline-refresh path instead of a full location.reload(). The reload was raising the dashboard tab to foreground on Firefox (and some Chrome configs) every time MusicBee changed tracks, even when the user was reading in another window. Soft path covers the same content delta — rating, love, duration, progress, influence buttons, artwork — without the focus side-effect.
- Shell tray menu — Machines submenu renamed to Libraries; each enumerated peer now offers Show QR code and Show diagnostics alongside Open dashboard / Set as SMTC target, opening
/system/qr and /diag on that specific host.
v0.5.2.8 — Technologic
Harder, Better, Faster, Stronger
- SMTC Bridge target switching — Tray menu lists the local MBXHub plus discovered network peers; click to retarget the SMTC bridge to any of them. Useful when you want the Windows media flyout / lock screen / Bluetooth controls to mirror a different machine's playback.
- Headless tray toggle —
tray.disableTrayIcon: true in mbxhub-shell.json runs the Shell with no tray icon. SMTC bridge still publishes; just no UI.
- Aspect-ratio sizing — Panel and artwork scale together via CSS
aspect-ratio. Pick a ratio, get that ratio.
- New settings for dashboard nowplaying column width, height, and gutter —
ColumnMaxWidth, ColumnGutter, and ImmersiveMaxHeight in mbxhub.json. ImmersiveMaxHeight default bumped 400 → 600.
- ImmersiveArtFit setting — Pick
contain (default; whole album art with blurred-background letterbox) or cover (cropped to fill panel edge-to-edge, no bars).
v0.5.2.7 — Nothing Else Matters
Keeping what matters, removing what doesn’t
- Mood scanning removed from MBXHub — Cut all integrated mood scanning, federation, fleet aggregation, peer-sync, and MetaServer from MBXHub. AutoQ stays first-class, reading a static
mbxmoods.json populated offline by truedat.
- MetaServer endpoints removed — All
/meta/* endpoints removed from the REST surface.
v0.5.2.6 — in progress
A Plethora of Settings and More
Installation profiles — Standalone / Island / Fleet dial drives MetaServer, peer-sync, SSDP, warm-up, fallback, remote-bind. Standalone is the new default. GET/PUT /system/endpoint-type.
- MBXHub.exe tray + auto-launch MusicBee — UI-mode dispatcher (GUI/tray on no-args, CMD on subcommand,
-cli attached). Tray: Open MusicBee, Status, Reconnect, Settings, Start with Windows, Quit. Click from Start menu launches MusicBee.
- Settings — A lot of new and rearranged controls land in both the plugin’s Settings window and the browser settings page. Most changes apply live without restarting MusicBee. Profile-driven defaults make a fresh install behave sensibly out of the box.
API Access — Fleet-routing edits have their own permission now, separate from shuffle controls. New master switch on the Shell to block remote writes to its endpoints.
- Settings UX — Settings form rearranged for clarity. Bandwidth toggles grouped together. AutoQ has a single master on/off that gates the related settings. Tabs run horizontally instead of vertically. The Start Shell button got a clearer label, and the SMTC toggle moved to the API Access tab where it logically belongs.
- NP panel cap —
ImmersiveMaxHeight now honored across zoom variants and the desktop ≥1024 px @media block (was previously stomped by hardcoded ceilings).
- Diagnostics & Performance — New
/diag page with live charts of CPU, memory, threads, and GC for spotting performance issues. Detailed log lines at the most-important decision moments make future spikes easy to trace.
- Configurable transport button — The extra button in the dashboard transport row (used to be hardcoded to Explore) can now be set to open a charm or a page of your choice. Configured in Settings.
v0.5.2.5 — Worker Bee
Beekeeper’s Daughter
- play.html — new player page — Device-adaptive 1/2/3-column view for phone, tablet, and desktop browsers. Incorporates explore, browse, and now-playing surfaces, shaped after the MusicBee 3 default skin. Adapts to device and theme settings.
- Dashboard theme color picker redesign — Native browser color pickers, curated preset swatches, and an intensity (saturation) slider. Reaches pure black, pure white, and true neutral grays; background, surface, text, and accent each get independent hue/saturation/lightness.
v0.5.2.4 — Moodserver
Dynamic Range Computation
- Dynamic Range as a mood feature — Essentia LRA (BS.1770 Loudness Range in LU) now travels alongside BPM/Loudness/etc. into the AutoQ mixer. Arousal weight slider defaults to 0.05. Fallback chain for legacy entries: derive from Loudness/RMS, then genre-default (classical 17, jazz 13, rock 10, metal 6, hip-hop 5), then constant 8.
Distributed Scanning
Scanner Pool with auto-discovered workers — Master Shell's ScannerPool in scan.mode = "auto" builds a round-robin pool from local + every SSDP-discovered peer that advertises the scanner capability (i.e. has truedat.exe installed). Plugin's ScanEnqueue WebSocket events get dispatched across the pool: local scans run in-process, remote dispatches POST /meta/scan with the file's UNC share path so the worker can read it over the network. Failed nodes are marked unhealthy after 3 consecutive failures and probed every 60 s.
UNC share path resolution — Two new settings, SyncLibraryPath (e.g. D:\Music) and SyncSharePath (e.g. \\masterpc\music), let the master compute UNC paths for files when dispatching scans to remote workers. Workers receive the share form, pass it to truedat as the file path, and read the audio over SMB. Without these set, remote dispatch falls back to the local path (only useful if all nodes share a drive letter).
POST /meta/scan on Shell — New endpoint accepts {file, share, priority} and enqueues into the local ScanWorker. Responds 200 {status: "queued", file} immediately; truedat runs and ingests asynchronously. 503 SCANNER_UNAVAILABLE when the node has no truedat installed.
Merge-on-ingest federation — MetaService.IngestAsync used to be first-write-wins: any existing row with non-zero base fields caused the entire incoming observation to be dropped. That meant a peer rescanning with a richer feature set couldn't fill in missing fields. New three-tier strategy: new row → full write; all-zero garbage → full overwrite (recovery); existing with data → merge (base scalars stay first-write-wins to avoid stomping good data, nullable extended fields fill from null, DR upgrades when incoming source rank is strictly higher: essentia-lra > derived-peak-rms > fallback-genre > fallback-none). Federation now actually converges across heterogeneous peer versions.
39 Extended Essentia Features
- Full Essentia output now persisted — truedat used to extract ~15 scalars from Essentia's streaming-extractor-music output and discard the rest. 39 additional scalar features now plumbed end-to-end: loudness dynamics (momentary, short-term, replay-gain), silence profile (20/30/60dB), spectral shape (rolloff, complexity, entropy, kurtosis, skewness, spread, strong-peak, decrease, energy + 4 energy bands), HFC, full Bark/Erb/Mel band stats (crest, flatness, kurtosis, skewness, spread × 3 families), beats-loudness, chords-strength, HPCP crest & entropy. All nullable so legacy rows read as null, never 0. autoq.html Track Mood Data renders all 54 feature rows with — for fields the track lacks.
- truedat re-extract gate — Cache-reuse paths in truedat now check
!DynamicRange.HasValue; tracks from old truedat builds (no LRA) automatically fall through to a fresh Essentia pass on next run, picking up all 39 new fields in the same analysis. Cache copy preserves the full feature set across reruns once captured.
Fleet Dashboard
GET /system/fleet aggregator — Single endpoint on master plugin fans out to local Shell + every knownPeers entry in /meta/sync/status, fetches each node's /meta/health and /meta/stats in parallel (3 s per-node timeout), returns aggregated queue depth, scan status, sync state, DB size. Per-node status field flags up | down | timeout so partial outages don't fail the whole call.
Fleet panel in autoq.html — New table under MetaServer section polls /system/fleet every 5 s while the page is visible. Per-row: name, status dot, tracks, queue depth (highlighted in accent when >0), scan status, last-sync rel-time, last-sync result, DB size. Headline meta line shows N/M nodes up · X tracks · Y queued · updated Zs ago. Pauses on tab hide; manual refresh button.
Per-node worker visibility — Fleet table now surfaces the scan worker's live state per node.
Explore Enhancements
- Discography navigation inside “More Info” — Clicking an album in the related-albums grid of the expanded album view now updates the view in place instead of collapsing it and dropping you back to the top-level stack. Hero, track list, metadata, and image strip re-render for the newly-selected album; the grid’s active marker moves along.
- Arrow-key navigation of the discography grid — Left / Right arrows while the expanded view is open step through the discography grid, scrolling the target card into view and populating the expanded panel with the new album. Works the same way for both solo-artist and compilation contexts (which surface same-title-different-artist rows).
v0.5.2.3 — XL Charms
Whole Lotta Love
- Charm Bar: XL & XXL Sizes — Charm and transport button sizes now cycle S / M / L / XL / XXL (XL = 64px, XXL = 76px). The previous “Large” (52px) was too small for comfortable touch on small high-density panels — XXL lands at ~0.6″ physical, right in the sweet spot.
- Per-Charm Size Overrides — New
charmBar.sizeOverrides dictionary (charm ID → S/M/L/XL/XXL) lets individual charms break from the bar-level size. A single charm class-name override wins via CSS specificity, so you can keep the bar compact while boosting one specific charm.
- Charm Row Breaks — New
charmBar.breakBefore list of charm IDs forces a row break before any named charm. Combined with Per-Charm Size Overrides, the volume mixer can sit on its own row with XL buttons while the rest of the charms stay at M — one-handed tablet use gets easier without blowing up every button.
- NP Text Size Applies to All Styles — The
dashboardLayout.immersiveTextSize setting (S / M / L / XL) now governs metadata text size for every now-playing style, not just immersive. Classes renamed internally from immersive-text-* to np-text-*; the setting name is unchanged for backward compatibility.
- ARiA Action-Menu Charm — ARiA moved out of the toggles row into its own built-in charm (
aria.json). New display: "action-menu" charm mode: single trigger + popover of preset actions. Keyboard-navigable (Arrow nav, Enter activates, Tab/Esc closes), auto-orients above or below the trigger based on viewport position. Presets continue to come from AriaPresets in mbxhub.json; the charm's expand is populated at load time. Respects all charm-bar settings (order, hidden, size, sizeOverrides, breakBefore).
- Adjacent-Token Search (default on) — Multi-word library searches now require the query tokens to match consecutive word prefixes in a single field (title, artist, album, or genre). “St Anger” matches the album St. Anger but no longer pulls in a track whose title contains “Anger” while its album contains “Story.” Single-word queries are unaffected and still use the strict prefix + concat fallback (so “acdc” still finds AC/DC).
- New Setting:
library.disableCrossFieldMatching — Toggles the new adjacency rule. Defaults to true (adjacency required, the new default). Set to false to restore the previous cross-field behavior where tokens could match anywhere across any of the four fields. Ignored when substring search is enabled. Exposed as a checkbox in Settings (Configuration → Library) and picked up by the dashboard settings page; browse.html honors it live from /system/settings.
- Artwork Sizing Fix (zoom@67 + horizontal) — Fixed CSS.
- Explore: Queue-Next Button on Expanded Tracks — Expanded album track rows now show a “Next” button alongside the existing queue-last
+, rendered as a hover overlay.
- player.html 3-Column Transport Fix — Transport, progress, stars, and reactions were squeezed into the artwork-flanked
.meta column on FHD 3-col layouts. Controls are now lifted out to span the full .player width, and they stay visible when the NP card is collapsed.
- Split NP Layout Fix —
.np-style-split rows now include min-width: 0 so square art no longer letterboxes inside a tall column when the metadata panel shrinks.
- Footer: Settings Entry —
/pages/settings.html added to the default dashboardFooterLinks list (disabled by default). Tick it in the plugin Settings dialog to surface it in the dashboard footer.
v0.5.2.2 — Search Party
I Still Haven’t Found What I’m Looking For
- Library Search Word Boundaries — Fixed a regression where library search matched query words as loose substrings, so “St Anger” pulled in every album containing “Stranger.” Server search and browse.html inline/tab-badge filters now match each query word as a prefix of a real word in title/artist/album/genre.
- Album Artist Toggle in Search Results — Fixed: the Album Artist / Artist toggle on the Library Browser Artists tab is now honored when results come from a full-text search.
- New Setting:
library.disableSubstringSearch — Controls library search matching globally. Defaults to true (strict word-boundary, the new behavior). Set to false to restore loose substring matching library-wide. Exposed as a checkbox in the plugin Settings dialog (Configuration → Library) and picked up automatically by the dashboard settings page.
- Per-Call Search Override —
GET /library/search accepts a new ?substring=true|false query parameter that overrides the setting for a single call. The response now includes a mode field ("strict" or "substring") echoing which path was taken so clients can verify.
v0.5.2.1 — Men at Work
Refinements
- Immersive NP: Blur Fill — Immersive now-playing mode shows the full album artwork (no cropping) with a blurred, saturated version of the same image filling any letterbox gaps. Works with all aspect ratios — square, portrait, and landscape art all display correctly.
- Observability — Timing instrumentation on hot code paths. REST requests over 200ms auto-promote to Info level. Client-side search render and track-change timing in browser console.
- ES5 Compatibility — Fixed search on older browsers that don’t support ES2020 optional chaining syntax.
- MusicBee API v58 — REST and RPC endpoints for expression evaluation (
/library/evaluate), placeholder artwork (/library/no-artwork), and peak/RMS metering (/nowplaying/peak). Returns 501 on older MusicBee builds.
- Volume Gesture Setting — New
dashboardLayout.disableVolumeGesture setting. Vertical swipe on artwork for volume control is now off by default to avoid conflicts with page scroll. Track skip gestures (horizontal swipe) unaffected.
- Pinch Zoom —
theme.disablePinchZoomLock unlocks native pinch-to-zoom on mobile. Also available as a toggle in the theme drawer.
v0.5.2.0 — Version Upgrade
MusicBee API v58 Support
- MusicBee API v58 — Updated plugin interface to API revision 58. Adds delegate definitions for
MB_Evaluate, Library_GetNoArtworkUrl, and NowPlaying_GetPeak. Gracefully absent on older builds.
- Browse: Tracks Tab — New search-driven Tracks tab in the library browser. Type to search tracks via
/library/search with debounced server queries and AbortController cancellation. Full track UI with play, queue next/last, listen-here, and playlist buttons.
- Browse: Video Play/Queue — Video items in both the Videos tab and search results now have play, queue next, and queue last buttons. Previously videos rendered as name-only list items with no actions.
v0.5.1.9 — Dashboard Layout Level-Up
Dashboard Now Playing Display Modes Options
- Split NP Style — Two-column grid: album art left, metadata right. Configurable column ratio (40–70%) via
mbxh_split_ratio localStorage key.
- Immersive NP Style — Full-bleed album art with gradient-scrim metadata overlay. Progressive reveal: chrome fades in on hover/touch, fades out after configurable delay (1–10s via
mbxh_immersive_fade).
- Compact NP Style — Tighter padding, smaller artwork and text for dense dashboards.
- NP Style Picker — Header button cycles through all 6 styles (Full, Compact, Horizontal, No Art, Split, Immersive). Per-device preference stored in localStorage.
- Charm Button Sizes — Configurable charm button size via
charmBar.buttonSize setting: S (32px), M (40px, default), L (52px).
- Progress Bar Thickness — Configurable via
dashboardLayout.progressBarSize: S (4px), M (6px, default), L (10px).
- Startup Diagnostics — Log now captures version+build epoch, Windows version, plugin path, settings path, port/remote/autoQ config, .NET runtime, and mood source (MetaServer or local file) on every startup.
- Settings Page — Dashboard layout now rendered as interactive checkbox list with reorder arrows (was two separate text fields for order and hidden).
- Dashboard Search — New
search section — full library search from the dashboard. Fuzzy album matching (client-side, instant) + server-side track search with AbortController. Filter tabs (All/Albums/Tracks), inline action card (play, queue next, queue last, explore), keyboard navigation (/ to activate, arrows, Enter=play, Shift+Enter=queue), search history in localStorage. Configurable bar size via searchBarSize.
v0.5.1.8 — Crate Full of Albums
Albums Artwork Explorer
- Media Endpoint —
/media/* — browse and serve images and videos from configured folders. Rotation, categories, seeking. Disable via disableMedia.
- Projector Charm — slideshow and video player at
/pages/media. Image crossfade, video transport controls, folder browser, configurable timer. Hidden by default.
- Explore Page (v3) —
/pages/explore.html — art-first album browser. Full-bleed artwork fills the viewport. Progressive reveal chrome fades in on interaction, fades out after 5 seconds. Gallery mode with crossfade transitions, fan art integration, and artist photo gallery. Edge gestures: top touch opens search, swipe up opens tracklist, tap enters gallery, double-tap plays. Transport controls (play/pause, skip, volume wheel). Source filters (All, 1mo, 3mo, 12mo, Unheard), diacritic-normalized search, enhanced album filter, PDF booklet viewing. Hidden by default in charm bar.
- Album Discovery Endpoints —
GET /library/albums/unheard (albums where all tracks have playCount=0), GET /library/albums/with-pdf (albums containing PDF booklets). Both support ?offset=&limit=.
- Artwork & PDF Endpoints —
GET /library/file/{url}/artwork-count probes embedded artwork images (up to 20, cached). GET /library/file/{url}/pdf serves PDF booklets from album folders. GET /library/file/{url}/has-pdf checks existence.
- Fan Art API — Two new endpoints for browsing folder images alongside album art.
GET /library/file/{url}/fan-art lists all images in an album's folder (Discogs scans, booklet pages, promo photos). GET /library/fan-art/{path} serves them. Excludes thumbnail artifacts and WMP cache files. Results cached per-session.
v0.5.1.7 — Remote Control Made Easy
SMTC anywhere, scanner delegation, and multi-machine polish
- SMTC Link Charm — Dashboard charm discovers MBXHub endpoints on the network and lets you switch which one the Shell’s SMTC bridges to. Tap to re-target your Windows media controls at any machine. Preferred address list with SSDP fallback replaces manual host/port config.
- Playlist Enumeration Fix —
GET /playlists was truncated. All playlists now returned correctly.
- Mixer: Network Speaker Section — network speaker scan/connect controls collapsed into an expandable section at the bottom. Local faders stay top-level.
Preferred Remote Scanner — set scan.remoteUrl in mbxhub-shell.json to forward scan requests to a dedicated scanner via POST /meta/scan. Host disables local scanning (scan.enabled: false), remote does the work. Results flow back via PeerSync.
Scan Configuration UI — Local scanning toggle in autoq.html MetaServer section and SettingsForm. Discovered remote scanners listed with status. Shell config managed via GET/PUT /meta/config endpoints.
v0.5.1.6 — Mood Data Everywhere
How I learned to stop worrying and reuse the original scan
MetaServer — REST API in MBXHub.exe (Shell) for mood and fingerprint data backed by MBXU SQLite. Replaces the mbxmoods.json flat file. Import existing data via POST /meta/import, query features via GET /meta/features, ingest new scan results via POST /meta/ingest. Runs on port metaPort (default: REST port + 1).
Distributed Scanning — any machine with truedat can scan local files and POST results to the central MetaServer. Identity matching (hash → audioMd5 → metadataKey) resolves tracks across machines. truedat --meta-server <url> for batch scanning.
Scan Distribution — scan requests now broadcast ScanEnqueue WebSocket events. The Shell's ScanWorker picks up work and posts results to MetaServer.
Plugin Dual-Mode — MoodEstimator queries MetaServer on cache miss, falls back to mbxmoods.json when MetaServer is unavailable. Background cache fill, periodic health re-check.
MetaServer Peer Sync — MetaServer instances discover each other via SSDP and exchange mood/feature data automatically. Pull-based with delta exports (GET /meta/export?since=), zero-config via SSDP discovery. Trigger manually with POST /meta/sync, check status with GET /meta/sync/status.
Remote Scanning — host broadcasts UNC share paths in ScanEnqueue WebSocket events. Remote Shell instances (scanners) open files via UNC share, run Essentia analysis, and deliver features back via PeerSync. Scanner requires zero path configuration — host owns the mapping. Configure syncLibraryPath and syncSharePath in mbxhub.json.
v0.5.1.5 — Mobile Gestures
Touch-friendly controls and gesture navigation for mobile dashboard experience
- Mobile Gestures — touch gesture controls wherever now-playing artwork is shown. Swipe artwork left/right for next/previous track, up/down for volume ±10%. In the Now Playing charm stacked layout, container swipe left/right switches panels (Now Playing → Queue → Lyrics).
/mixer/volume Endpoint — GET/PUT routes to the active default fader (player or device). All gesture volume controls use this single endpoint.
- Library Stats — artist count uses
/library/artists (was album-artists). /library/albums supports ?albumArtist= filter.
v0.5.1.4 — Player Browse More
Consolidated browse with player for consistent experience and code simplification
- Player Browse — the library browser is now used with the player for a consistent experience and code simplification. Theme and color choices sync across both views.
Auto Mood Scan — unanalyzed tracks are automatically queued for Essentia analysis when played. Shell hosts background worker, results hot-load into mood cache. Self-disabling if Truedat not found.
Scan Status — GET /scan/status reports mood cache stats (total, Essentia, fallback counts).
- Browse Art Sizing — resizable album art thumbnails in the library browser via slider control. Size persisted across sessions.
- Unified Theme System — two-slot HSL color model persisted to
mbxhub.json. One theme config drives dashboard, player, browse, now playing, and mixer. GET/PUT /system/theme REST endpoints with partial update support. ThemeChanged WebSocket event for live sync across all pages.
- Browse & Search Improvements — album tab filter now matches artist name, not just album name. Artist drilldown returns broader results.
- AutoQ Track Info —
GET /autoq/track-mood now includes file URL and album fields for scan integration.
- Status Page — live dashboard with library stats, AutoQ state, mood cache, and feature flags. Correct album count (groups by album artist), mood cache display fixed.
On-Demand Mood Scanning — POST /scan/track enqueues a single track or full album for Essentia analysis. AutoQ tuning console shows Scan Track and Scan Album buttons when the current track uses fallback estimation. No autoScan setting required.
- Truedat Discovery — Shell automatically finds truedat.exe in the MusicBee Library folder. Fixed ScanEnqueue priority deserialization.
v0.5.1.3 — Improvements
Fun and frustration-free
- Audio Output Enumeration — new
GET /devices/audio/outputs endpoint lists all active Windows audio render devices via Core Audio (name, id, isDefault).
- Dashboard Charm Persistence — player actions no longer reset inline charm windows. Browse scroll position, drilldown state, and search are preserved across play, next, rate, love, and all other dashboard controls. Resizable inline browse window with height persisted across sessions.
- Remote SMTC — use the Windows Media control panel to remotely control a MusicBee instance on another machine. Run
MBXHub.exe --install on the remote machine, then edit mbxhub-shell.json to point at the MusicBee host. Media keys, play/pause, skip, and artwork all work across the network.
v0.5.1.2 — Mixer
Multi-fader volume control and network audio
- Default Fader — configurable default fader for quick-access controls — dashboard volume slider and keyboard shortcuts target the selected fader.
- Windows Audio Device Volume — control the system audio output device volume directly from MBXHub.
- Network Speaker Integration — Devialet Phantom support with volume control and endpoint management via REST API.
- Endpoint Source Selection — switch audio input sources on network endpoints from the Mixer charm.
- Auto-Discovery — mDNS-based discovery of network audio endpoints on the local network.
v0.5.1.0 — Taste & Discovery
Explore your library through the lens of your listening
- Taste Explorer API —
GET /autoq/taste-explorer discovers tracks adjacent to the current taste profile, grouped by genre/artist/mood. GET /autoq/similar finds tracks similar to a seed track. TasteChanged WebSocket event broadcasts profile updates.
- DJ Taste Tab — new “Taste” search tab in the DJ page showing taste-model-driven suggestions grouped by genre, artist, or mood. Similar (~) button on every track for seed-based drill-down. Vibe Filter toggle re-ranks search results by the current taste profile.
- Dashboard Connection Indicator — header shows server name with connection dot inline after the MBXHub logo. Green when WebSocket connected, dims when disconnected. Server name from discovery settings.
- Mixer Charm — expandable charm for remote audio output device switching. Lists MusicBee output devices, switch with a tap. Inline volume controls (shift-click for fine ±1). Standalone page at
/pages/mixer.html.
- Library Browser: Album Artist & Collapsible Albums — Artists tab toggles between Artist and Album Artist mode (defaults to Album Artist). Artist drilldown shows collapsible album rows with artwork, year, and track count — expand to reveal tracks. Sort drilldown albums A-Z (honoring Sort-As overrides), Newest First, or Oldest First. Search results group albums as collapsible rows. New endpoints:
GET /library/album-artists, GET /library/albums/by-artist. New ?albumArtist= filter and year-asc sort on /library/files.
- Library Browser: Album Grid Enhancements — Album cards show year and track count in subtitle. Play/queue buttons (Now, Next, Last) overlay on album artwork on hover. Sort albums from the header: A–Z, Recently Added (date added to library), Newest (release year), Oldest (release year), or Random Shuffle.
/library/albums/detailed now returns year and dateAdded per album.
v0.5.0.9 — Under the Hood
Faster everywhere, no trade-offs
- Playlist Folder Grouping — playlists in the player browse panel and search results are grouped by folder
- Root playlists listed first, then sorted folder groups with uppercase headers
- Items show leaf name only (folder prefix shown in group header)
- Matches dashboard playlist picker ordering
- Filtering hides empty groups
- Track Metadata Cache — ConcurrentDictionary with TTL eviction, invalidated on track change events. Queue listings with 100+ tracks hit cache instead of 1500 API calls
- WebSocket Serialize-Once Broadcast — events serialized to bytes once and sent to all clients, not per-client
- Router Fast Path — kiosk/party mode checks skipped when disabled, regex routes matched in single pass instead of two
- Scoring Engine — diversity penalty pre-computed maps (O(1) per candidate), single-pass filter chain, TTL-based metadata eviction, ThreadLocal RNG
- Startup & Lifecycle — lazy handler initialization, lock-free rate limiter cleanup, immutable WebSocket subscriptions, bounded log queue (10K cap)
- Dashboard Degraded Browser Support — comprehensive
var()/clamp() fallbacks, :focus-visible fallback, emoji detection with text substitution, ES5-compatible JS, form-based volume controls for no-JS mode
- Live Settings Page (
settings.html) — Firefox about:config-style editor for dashboard, AutoQ, and shuffle settings with search, category filters, and inline editing
v0.5.0.8 — Search & Queue
Search smarter, play everywhere
- Library Browser (
browse.html) — standalone browse-and-queue webapp
- Seven tabs: Albums, Artists, Genres, Playlists, Podcasts, Radio, Moods — drilldown + breadcrumbs
- Live search with grouped results across all categories
- Album card grid with lazy-loaded artwork
- Play Now / Queue Next / Queue Last / Add to Playlist
- Batch selection via long-press, playlist picker overlay
- Light/dark theme, dashboard charm integration
- Diacritic-Aware Search — “bjork” finds Björk, “cafe” finds Café — fuzzy bigram scoring and accent-insensitive matching in Browser, Player, Guest, and the REST API
- Responsive Player — three layouts, zero compromise: mobile tab bar (single-column, swipe between NP/Browse/Queue), tablet portrait (2-column browse+player grid), desktop landscape (full 3-column with resizable panels)
- Guest Page Refresh — all 7 browse tabs, fuzzy search with diacritics, mood/podcast drilldown
- Queue Batch Add —
POST /queue/add accepts urls array for multi-track queuing
- Playlist Create with Files —
POST /playlists accepts files array to create and populate in one step
- Sort by Track Number —
?sort=track for disc/track order (CUE-aware)
- Mood Browse —
GET /autoq/moods/browse returns tracks scored by mood similarity
- Player & Now Playing Charms — charm manifests + home button on standalone pages
- Upgrade Housekeeping — stale pages detected and updated automatically on startup; legacy plugins removed
v0.5.0.7 — AutoQ Tuning
Smarter moods, transparent confidence
- Genre-Aware Weight Adjustment - Per-genre multipliers adapt mood estimation to each genre’s acoustic norms
- 8 built-in genre profiles: Electronic, Metal, Jazz, Classical, Hip-Hop, Folk, R&B, Pop/Rock (reference)
- 14 multipliers per profile (8 arousal, 6 valence) — weights are scaled then renormalized so total stays constant
- BPM downweighted for EDM (uniformly high), chord changes upweighted for jazz, brightness boosted for metal
- Genre matching: exact tag match first, then first-word fallback (e.g. “Progressive Rock” → Rock)
- Custom profiles via
autoQ.genreProfiles in mbxhub.json — override or extend built-in profiles
- Toggle:
useGenreAdjustment (on by default), controllable from Tuning Console
- Confidence Scoring - Every mood estimate now carries a confidence score (0–1)
- Formula:
confidence = sourceBase × channelProximity
- Source bases: Essentia (0.9), fallback+genre (0.45), fallback-only (0.2) — all tunable
- Channel proximity: how close the V/A point lands to its nearest mood channel (1.0 = dead center)
- Color-coded badges on Dashboard, Player, and Tuning Console (green/yellow/red)
- Confidence gate: mood tags only written when confidence ≥
confidenceMinForTag (0.3)
- REST API:
confidence, confidenceLabel, genreProfile in GET /autoq/track-mood
- Mood Combo Labels - Multi-channel mood descriptions
- Tracks near channel boundaries get composite labels (e.g. “Upbeat + Energetic”)
moodLabel and moodMatches array in API responses
- Tunable via
moodComboMaxResults (3) and moodComboMinScore (0.85)
v0.5.0.6 — Play Here
Your music, your device
- Audio Streaming Endpoint -
GET /stream/{path} — serve any library file over HTTP with full seek support
- Phone, tablet, laptop — open the player, tap Play Here, and the music comes out of that device
- Perfect for podcasts: listen at your desk while MusicBee manages the library on another machine
- HTTP Range support (
206 Partial Content) — seek anywhere instantly
- Library-gated: only files in MusicBee can be streamed. Path traversal and extension whitelist enforced.
- Formats: mp3, flac, m4a, ogg, wav, opus, aac, aiff (browser codec support varies)
- Kill switch:
disableStreaming setting, off by default
- Listen Here 🎧 - Per-track streaming button in player.html
- 🎧 button on every track, album, podcast episode, and radio station in search results
- One tap starts local playback — no mode toggle needed
- Full transport sync: play/pause, next/prev, seek bar, volume all drive the local
<audio> element
- Client-side queue: play now, queue next, queue last from search, albums, playlists
- CUE track offset support — seeks to correct position, shows track-relative progress, auto-advances at track end
- Buffering/error feedback, auto-advance on error, “Streaming locally ×” indicator to exit
- Respects
/system/features — 🎧 buttons hidden when streaming disabled server-side
- Radio Stations - Browse and play radio in the player
- New Radio tab in the player browse panel — lists all stations from MusicBee’s Radio node
GET /radio/stations endpoint — returns station name and URL
- Play on MusicBee or Listen Here directly in the browser
v0.5.0.5 — Phantom
Your speakers, one tap away
- Phantom Webapp - Full Devialet Phantom control at
/pages/phantom.html
- Transport, volume slider, mute, source switching — all from the dashboard or standalone
- Dynamic source enumeration with friendly name mapping (Spotify, AirPlay, Optical, Roon…)
- Namespace-aware: systems, devices, and groups all supported
- Auto-polls every 22s for now-playing updates
- Zero dependencies, single HTML file, works offline on LAN
- Charm Manifest System - Drop-in JSON manifests for custom dashboard controls
- Three action tiers: HTTP (LAN device APIs), Exec (local CLI tools), Webapp (embedded pages)
- Manifests seeded on first run from embedded resources
- Charm bar renders in the dashboard with configurable order and visibility
- Cross-origin actions auto-routed through the device proxy — manifest authors don’t deal with CORS
v0.5.0.4 — Podcasts
Your subscriptions, everywhere
- Podcast REST API - Full access to MusicBee’s podcast subscriptions over the network
GET /podcasts — list subscriptions with title, genre, description, download counts
GET /podcasts/{id}/episodes — episode list with dates, duration, play/download status
GET /podcasts/{id}/artwork — subscription artwork
- Aggregated views (Recent, Unplayed) attribute episodes back to their parent podcast
- Pairs naturally with Play Here — stream a podcast episode directly to your phone
v0.5.0.3 — Charms & Device Proxy
The dashboard becomes a control surface
- Device Proxy -
POST /api/proxy — generic HTTP proxy for controlling LAN devices from the browser
- Forwards requests to any private-IP device (speakers, receivers, home automation)
- Bypasses browser CORS restrictions that block direct LAN device access
- Safety: only proxies to RFC 1918 private IPs, never to the public internet
- 5-second timeout, passthrough error responses
- Charm Bar - Extensible action strip on the dashboard
- Compact icons that fire actions on tap — one button per device control
- Expand menus for multi-option charms (volume +/−/mute, source picker)
- Webapp charms embed rich UI inline (Phantom control page, future device panels)
- JSON manifest format: drop a file, get a button — no code, no rebuild
v0.5.0.2 - 2026-02-14
Added
- mDNS/DNS-SD Discovery - MBXHub now advertises via Bonjour/zero-conf alongside SSDP and WS-Discovery
- Uses Windows native
DnsServiceRegister API (Win10 1809+, graceful fallback on older)
- Registered as
MBXHub (Name)._http._tcp.local with TXT records
- Visible via
dns-sd -B _http._tcp or Bonjour Browser
- Configurable Discovery Name - New
discoveryName setting replaces cryptic hash identifiers
- Friendly name pattern:
MBXHub (Name) across SSDP, WS-Discovery, and mDNS
- Empty = machine name (e.g. “MBXHub (PANDABOX)”)
- Settings UI text field on General tab, configurable via
PUT /system/settings
- Host Identity -
GET /system/version now returns host field; player status bar shows “Connected to {host}” instead of generic “Connected to MBXHub”
- RemoteApp - Publish MusicBee as a Windows RemoteApp over RDP
- New MBXR library for Windows RemoteApp registry configuration
GET /remoteapp/status — check edition, RDP enabled, configured state
GET /remoteapp/rdp — download .rdp file with audio-optimized defaults and query param overrides
- Shell CLI:
MBXHub.exe remoteapp setup|remove|status|rdp with auto-elevation
- Dashboard footer RDP download link (visible when RemoteApp enabled)
- Settings:
remoteAppEnabled, remoteAppApiDisabled (General and API Access tabs)
- Detects Windows edition (Pro/Enterprise/Server required) and RDP enabled state
- File Info Badge - Dashboard now-playing shows codec and sample rate/bitrate (e.g. “FLAC 96kHz”). Hi-res icon appears when sample rate exceeds CD quality (44.1kHz). Controlled by
hideFileInfo setting.
- Dashboard Footer Links - Customizable footer links
- New
dashboardFooterLinks setting: array of {label, url, enabled} objects
- Default links: Player, Pages, QR (disabled), RDP, API
- Settings UI: reorder, add, remove, and toggle visibility in Dashboard tab
- Add dialog discovers pages from the pages folder
- Conditional visibility: QR requires REST, RDP requires RemoteApp
- Footer is a dashboard layout section (
footer) — hide/show via dashboardLayout
v0.5.0.1 - 2026-02-11
Added
- MBXHub.exe - Standalone Shell for Windows SMTC notifications, firewall configuration, and system identity
- Windows media transport controls (play/pause/next/prev from taskbar, lock screen, Bluetooth)
- Registered App User Model ID (
HALRAD.MBXHub) for proper Windows notification identity
- Auto-reconnect with configurable retry — survives MusicBee restarts
- Single-instance enforcement with existing-instance activation
- Enabled/disabled via the MBXHub plugin settings — plugin manages the Shell lifecycle
- Built-in firewall CLI:
MBXHub.exe firewall add|remove|check|status|open (replaces standalone firebug.exe)
- AutoQ Pick Mode - Choose how AutoQ selects tracks: Off, Favorites, Weighted, or Random
- Queue Diversity Enforcement - Hard artist and genre quotas prevent same-artist or same-genre streaks in the queue
- Reaction Vibes - Reactions automatically create influences: fire/heart boost the artist, like boosts the genre, dislike/ban reduce them
- DJ Activity Feed - Reactions now appear in the party activity feed in real-time alongside requests and votes
- Artwork Folder Fallback - Album art discovery from folder images when embedded artwork is missing
- Mood Channel Editor - Visual editor in the AutoQ Tuning Console for customizing mood channels
- 2D scatter plot showing all channels in valence/arousal space
- Editable table with name, emoji, arousal, and valence for each channel
- Add, remove, and reset-to-defaults controls
moodChannels now included in GET/PUT /autoq/settings
- WS-Discovery - MBXHub now appears automatically in the Windows Explorer Network folder
- Hello/Bye/ProbeMatch on UDP 3702 alongside existing SSDP on UDP 1900
- Metadata exchange at
POST /wsd provides "Device webpage" link to dashboard
- Same
discoveryEnabled setting controls both SSDP and WS-Discovery
- Mood Estimation Retuning - Improved default mood classification accuracy
- Intense channel moved to (a=0.85, v=0.25) to prevent center-space vacuum effect
- Valence weight for mode increased (0.35) — major-key tracks get stronger valence lift
- Dissonance weight reduced (0.20) — less penalty for harmonically complex music
- Mode score for major keys increased (0.85) — better major/minor discrimination
v0.4.9 - 2026-02-03
Added
- AutoQ - Vibe-based automatic track selection for parties
- Learns from party reactions and influences to queue tracks
- Uses MusicBee's Similar Artists API to discover related music
- Configurable scoring weights and thresholds
- REST API:
/autoq/status, /autoq/start, /autoq/stop, /autoq/vibe-list
GET/PUT /autoq/settings - Read/write all tunable parameters at runtime
- Tuning Console (
/pages/autoq.html) - Mixer-style UI with vertical faders for estimation weights, horizontal sliders for scoring/behavior, live stats
- Tiered Reactions - Now playing reactions with different score weights
- Fire (+3), Heart (+2), Like (+1), Dislike (-1), Ban (-100)
POST /autoq/react - Submit reaction with nickname attribution
GET /autoq/reactions - Reaction history with optional track filter
- Floating Reactions - Teams-style emoji animations on Display page
- Reactions float up with smooth animations
- Respects
prefers-reduced-motion for accessibility
- Leaderboard - Party stats page showing guest engagement
- Top guests by reactions and requests
- Top tracks by score
- Reaction breakdown (fire, heart, like, dislike, ban)
GET /autoq/stats for custom UIs
- New page:
/pages/partymode/leaderboard.html
- Similar Artists Integration - AutoQ expansion via MusicBee
- Configurable similarity threshold (default 0.5)
- Bonus score for tracks by similar artists
- Mood Channels API -
GET /autoq/moods and POST /autoq/mood for mood-based track selection
- 10 default channels (Energetic, Dance, Intense, Upbeat, Morning, Chill, Mellow, Night, Emotional, Relax)
- Custom channels via
autoQ.moodChannels in mbxhub.json
- Estimation Settings - All AutoQ normalization parameters now tunable via
autoQ.estimation in mbxhub.json. See AutoQ Configuration for details.
- MetadataChanged WebSocket Event - Dashboard updates when rating/love changes in MusicBee UI
- Player Add To Playlist - Dropdown to add current track to any playlist
- Mood Tag Writing - Write mood labels to MusicBee custom tags
- Only writes for Essentia-analyzed tracks (real audio analysis, not BPM/rating fallback)
- Configurable target field via
autoQ.moodTagField (e.g. "Custom1")
POST /autoq/retag-moods - Bulk retag all analyzed tracks
- Tag format:
"😌 Chill" (emoji + channel name)
- Panel Mood Display - MBXHub panel shows current track's mood
- Mood label displayed for Essentia-analyzed tracks only
- Adaptive layout: single row (wide) or two rows (narrow)
- QR Code Sharing - Scan-to-connect from any page
GET /system/qr - General-purpose QR code endpoint (accepts ?url= override)
- Dashboard header QR button; party-aware (shows guest join URL when party active)
- Guest page QR button for viral guest-to-guest sharing
- DJ page Guest + DJ QR buttons for inviting from the booth
- Configurable:
disableGuestQr / disableHostQr in Party Mode settings
- Dashboard Layout Settings - Configurable panel order, visibility, and collapse grouping
- Dashboard tab in settings with drag-order and visibility checkboxes
- Collapse threshold groups less-used sections behind an expand toggle
- CUE Track Resolution - Centralized per-track metadata for CUE-backed audio files
- All surfaces (REST, dashboard, WebSocket, now-playing) show correct CUE track info
- Position-based track lookup from parsed CUE sheets
- Encoding detection: BOM, UTF-8 validation, Windows-1252 fallback
- Optional CueSharp.dll soft dependency for enhanced parsing
- Cache avoids re-parsing on every request
- Full logging via
[CUE] logger category
Changed
- Display page now shows floating reaction animations
- Reaction system integrated with AutoQ scoring
- Dashboard theme toggle collapsed to single cycling button (light → dark → midnight)
- Dashboard XSS hardening: theme whitelist validation, emoji/icon escaping
v0.4.8 - 2026-02-01
Added
- Dashboard Playlist Selector - Play any playlist directly from the dashboard
- Dropdown selector with all playlists (alphabetically sorted)
- Play button to queue and start playlist
- Located above ARiA section
- Dashboard Player Link - Quick link to player.html in dashboard footer
- Disabled when API docs are hidden
- Footer now shows: Player | API | refresh | version
- Server-side Sorting - Library endpoints support
?sort= parameter
- Options:
alpha (default), artist, album, title, date, name
- Applies to:
/library/files, /library/artists, /library/albums, /library/genres, /library/search
Changed
- Pagination Limit Increased - Maximum limit raised from 500 to 10000
- Allows fetching complete libraries in single requests
- Default limit remains 50 for efficiency
- player.html Updates
- Removed artificial 100-item limit on browse/search results
- Removed 50-item limit on playlist list
- Removed 100-item limit on track rendering (3 places)
- Track fetching limit increased from 100 to 5000
- All albums now visible including CUE-based albums at end of list
- Album Search - Removed 20-album limit in SearchAlbumTracks
v0.4.7 - 2026-01-30
Added
- PartyMode - Web-based party music system for group listening
- Guest Page (
/pages/partymode/guest.html) - Browse library and request songs
- Album, Artist, Genre, Playlist browsing with search
- Queue songs with one tap - requests attributed to nickname
- See Up Next queue (5 tracks)
- Vibes voting (thumbs up/down) on now playing and queued tracks
- DJ Page (
/pages/partymode/dj.html) - Full queue control
- Full playback controls (play/pause, prev/next, volume, seek)
- Drag-and-drop queue reordering
- See guest requests with attribution
- Guest Vibes panel showing current influences
- Display Page (
/pages/partymode/display.html) - TV-friendly display
- Large artwork with glow effect
- Live scrolling lyrics
- Request feed showing joins and song requests
- QR code overlay for easy guest access
- Current Vibes panel
- Join Page (
/pages/partymode/index.html) - PIN entry with nickname
- PartyMode API Endpoints
GET /partymode/status - Check if party is active
POST /partymode/start - Start party with PIN
POST /partymode/stop - End party session
GET /partymode/validate - Validate PIN and register join
POST /partymode/verify-dj - Verify DJ PIN for DJ page access
POST /partymode/vote - Submit vote with attribution (persisted in feed)
POST /partymode/request - Submit song request with attribution
GET /partymode/requests - Get recent requests
GET /partymode/feed - Get feed (joins, requests, votes, reactions)
GET /partymode/qr - Generate QR code image
GET /partymode/role - Get caller's role (host/dj/guest)
- QR Code Generation - Server-side QR codes via QRCoder library
- API Access Control - Granular read-only mode for REST API
- Master read-only toggle disables all write operations
- Granular controls: Player, Queue, Library, Playlists
- PartyMode endpoints exempt (always functional)
- Returns 403 with
READ_ONLY error when blocked
- Configurable in MBXHub Settings panel
v0.4.6.1 - 2026-01-28
Added
- llms.txt - AI-friendly API documentation at
/llms.txt
- Complete API cheat sheet with all endpoints
- Anatomy of a Player - UI regions mapped to APIs
- Sample code patterns (seek bar, shuffle toggle, playlists, etc.)
- Usage rules and gotchas
- Further reading guide to other docs
- Spec: llmstxt.org
v0.4.6 - 2026-01-28
Added
- Static Pages Server - Serve custom HTML pages from a configurable directory
- Routes:
/pages/, /pages/{filename}
- Serves HTML, CSS, JS, images, fonts with correct Content-Type
- Configurable via
pagesPath in settings (default: %APPDATA%\MusicBee\MBXHub\pages\)
- Falls back to embedded resources if files not found on disk
- Extracts default pages on first run (won't overwrite customizations)
- Embedded Player Page - Desktop 3-column player UI at
/pages/player.html
- Now Playing with artwork, live WebSocket updates
- Player controls: play/pause, prev/next, shuffle (Off/Shuffle/DJ cycle), repeat, volume, seek
- Browse: Artists, Albums, Genres, Playlists tabs with search
- Queue: Now/Next/Last buttons for tracks, albums, playlists
- Influence thumbs (hidden when AutoQ disabled), ARiA presets, Love/Ban, Lyrics
- Responsive layout for desktop and mobile
- Index Page - Landing page at
/pages/index.html
v0.4.5 - 2026-01-19
Added
- Influence System - Pandora-style thumbs up/down for AutoQ track selection
- Target by Genre or Artist metadata
- Negative influences (
--) hard exclude matching tracks from shuffle
- Dashboard thumbs up/down buttons (only shown when AutoQ enabled)
- REST API:
GET/POST /influences, DELETE /influences/{target}/{value}, POST /influences/clear
- Network Discovery (SSDP/UPnP) - MBXHub advertises itself on the local network
- SSDP server announces presence via multicast (239.255.255.250:1900)
- UPnP device description at
/device.xml
- Clients can find MBXHub automatically
- Rate-limited M-SEARCH responses (security)
- Firewall Configuration UI - Settings form includes firewall management with Check/Add/Remove/Open/Script buttons (delegates to
MBXHub.exe firewall)
- Web Dashboard - Full-featured browser-based remote control
- Live WebSocket updates (progress bar, track info, play state)
- Shuffle/AutoDJ three-state toggle (Off, Shuffle, AutoDJ)
- Repeat mode toggle (cycles off → all → one)
- ARiA preset buttons (collapsible section)
- Single Port - WebSocket now uses same port as REST (no separate 8081)
- ARiA Presets - Named automation scripts for quick execution
- Remote Exit & Restart -
POST /app/exit gracefully closes MusicBee, POST /app/restart schedules a restart via Task Scheduler (enable in settings)
- Dashboard Controls - Toggle buttons (Off/Shuffle/AutoDJ/Repeat) fully interactive
- Repeat Mode - Clickable cycle through off → all → one
v0.4.2 - 2026-01-18
Added
- ARiA Input Simulation - Remote keyboard/mouse control for PC wake scenarios
/aria/status - Check if ARiA is enabled
/aria/wake - Quick wake: move mouse + send Shift key
/aria/send-keys - Send keyboard input (SendKeys format)
/aria/mouse/move - Move mouse (absolute or relative)
/aria/mouse/click - Mouse click (left, right, middle)
- Security: ARiA disabled by default, returns 403 when disabled
v0.4.0 - 2026-01-13
Added
- WebSocket Events - Real-time event streaming for player state changes
- TrackChanged, PlayStateChanged, VolumeChanged, PositionChanged
- QueueChanged, ShuffleChanged, RepeatChanged events
- Subscribe/unsubscribe to specific event types
- WebSocket test page at
/test/websocket with editable URL
- AutoQ - TrueShuffle and banlist management
- Shuffle endpoints:
/shuffle/status, /shuffle/reset, /shuffle/played, /shuffle/remaining
- Banlist endpoints:
/banlist, POST /banlist, DELETE /banlist/{url}
- Library Sync (MBXS) - Multi-device library synchronization
- Sync status, config, and control endpoints
- Device discovery and pairing
- Conflict resolution
- Settings Form Improvements
- Remote connection configuration dialog
- Developer mode unlock (7-click easter egg)
- API docs link in settings panel
- API Documentation Updates
- Added WebSocket section explaining events vs REST
- Added Shuffle, Banlist, Sync sections
- Expanded metadata fields (Rating, RatingLove, etc.)
Changed
- HTML docs at
/docs now cover 120+ endpoints
v0.3.2 - 2026-01-11
Security
- CORS restrictions: only localhost and local network IPs allowed
- Request body size limits: 1MB max to prevent DoS attacks
- Content-Type validation for JSON endpoints
- Improved error handling: no stack trace leakage to clients
Added
- Full API specification document
- Complete MusicBee API coverage via RPC (~100 methods)
v0.3.1 - 2026-01-10
Added
- Full MusicBee plugin API coverage via REST
- AutoDj endpoints (start, stop, status)
- Audio processing endpoints (equalizer, DSP, crossfade, replay gain)
- Artist pictures (full size and thumbnails)
- RPC mode for direct API access (
POST /rpc/{method})
- 74 total REST endpoints
v0.3.0 - 2026-01-09
Added
- Extended IMusicBeeApi interface (~30 new methods)
- NowPlayingHandlers, QueueHandlers, LibraryHandlers, PlaylistHandlers
- SystemHandlers (settings get/set)
- Dynamic route handling with path parameters
- 54 REST endpoints (100% SPEC coverage)
v0.2.0 - 2026-01-08
Added
- MusicBee plugin entry point
- HttpListener-based REST server
- Basic player control endpoints (play, pause, stop, next, prev)
- Volume, position, shuffle, repeat endpoints
- Now playing endpoint
- CORS support for web clients
v0.1.0 - 2026-01-07
Added
- Core interfaces (IModule, IMusicBeeApi)
- HubSettings configuration
- Module stubs (REST, MBRC, WebSocket)
- Project structure