MusicBee Clouseau

Download MusicBee Clouseau

Latest Version

v1.0.26.1 RC - Remarkably Close

Full coverage: panels, artwork, visualizers, audio metrics, spectrum/waveform capture, command registry.

Tools: App Spy Overlay, Method Invoker, Event Inspector, Menu Inspector.

Package	Contents	Download
Plugin DLL Ready to use	mb_clouseau.dll	Download
Source Code Build it yourself	Full source	Source

View Changelog

Installation

Step 1: Download

Download the ZIP file above and extract it.

Step 2: Copy Plugin

Copy mb_clouseau.dll to your MusicBee plugins folder:

Default: C:\Program Files (x86)\MusicBee\Plugins\
Portable: [MusicBee folder]\Plugins\

Step 3: Restart MusicBee

Close and reopen MusicBee to load the plugin.

Step 4: Enable Plugin

Go to Edit > Preferences > Plugins and enable Clouseau.

Step 5: Get Started

Go to View > Arrange Panels, find Clouseau in the list, and add it to your layout to see the live event log.

Or use the Tools > Clouseau menu to quickly access the Dashboard, Live Log, or Settings without adding the panel.

For configuration options, see the Documentation.

System Requirements

Component	Requirement
Operating System	Windows 7/8/10/11
MusicBee	MusicBee 3.1 or later
Framework	.NET Framework 4.8 (included with Windows 10+)

Data Location

Logs and settings are stored in:

%AppData%\MusicBee\mb_clouseau\

Log Files:

clouseau.log - Human-readable main log
clouseau.json - Structured JSON log
events.log - Pipe-delimited event log
events.jsonl - JSON Lines with ALL context data (best for parsing)
metrics.log - System/process metrics
performance.log - API call timing
settings.json - Configuration

Troubleshooting

Issue	Solution
Plugin not showing	Verify DLL is in correct Plugins folder. Check MusicBee error log.
No events logged	Ensure plugin is enabled in Preferences > Plugins
Panel not visible	Enable via View > Arrange Panels
Missing events	Check category filters in settings

Uninstall

Delete mb_clouseau.dll from MusicBee Plugins folder
Optionally, delete %AppData%\MusicBee\mb_clouseau\ to remove logs and settings

Dependencies

Package	Author	License	Purpose
Newtonsoft.Json	James Newton-King	MIT	JSON serialization for event logging
NLog	NLog Contributors	BSD-3-Clause	Structured logging framework
System.Diagnostics.PerformanceCounter	Microsoft	MIT	Performance metrics collection
System.Management	Microsoft	MIT	System information gathering

Attribution

MusicBee: Steven Mayall - The ultimate music manager and player for Windows

MusicBee Plugin API: This plugin implements the MusicBee Plugin Interface to integrate with MusicBee. The MusicBeeInterface.cs file is provided by Steven Mayall and is not covered by this project's GPL license.

Inspector Theme: The Clouseau name and detective theme are inspired by the classic Inspector Clouseau character - we investigate what's happening inside MusicBee with the same determination (if not quite the same grace).

Other HALRAD MusicBee Projects

MBXRemote - Windows desktop remote client
MBXCast - Google Caster for MusicBee
MusicBee TrueShuffle - True shuffle plugin
MBRC Plugin - MusicBee Remote Control server plugin

License

GPL-3.0 with MusicBee Linking Exception

This license includes a linking exception allowing dynamic linking with MusicBee player, as per the GPL FAQ on plugins.

MusicBee Clouseau