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

1. Delete `mb_clouseau.dll` from MusicBee Plugins folder
2. 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