Settings-Plugin-Manager
Plugin Manager
QUP's optional features ship as plugins — self-contained add-ons for things like music video backgrounds, OBS recording, MIDI karaoke and Discord integration. The Plugin Manager is where you choose which ones load.
Open Config → Plugins and click the Plugins heading itself (rather than one of the entries beneath it).
Turning plugins on and off
Each installed plugin has a checkbox. Unticking one stops it loading.
Changes take effect after restarting QUP. Plugins hook into playback and the interface as the app starts, so they can't be safely pulled out from under a running show.
Reasons to disable one:
- You don't use it, and would rather it wasn't running at all.
- It needs setup you haven't done, and you're tired of seeing it.
- You're troubleshooting and want to rule it out.
Disabling is remembered between restarts. Nothing is deleted — the plugin's settings and data stay where they are, so re-enabling picks up exactly where you left off.
Safe Mode
If QUP won't start properly and you suspect a plugin, launch it with --safe-mode. Every plugin is skipped for that session only, and your saved enable/disable choices are left alone — so a normal relaunch restores whatever you had.
The title bar shows that safe mode is active, so you can't leave it on by accident.
Where plugin settings live
Each plugin keeps its configuration and data in its own folder under plugins/data/, separate from the plugin itself. That separation is deliberate: updating or reinstalling QUP replaces plugin code but never touches your data. Your mappings, caches, credentials and preferences survive upgrades.
Plugins with their own settings pages
Plugins that need configuring appear under Config → Plugins with their own page:
- Music Video Backgrounds
- OBS Recording
- SongShop
- Discord Party
- AutoFiller
- Genre Tagger
- Internet Radio
- MIDI Karaoke
Others — like the Metadata Editor — add a right-click action to the media library rather than a settings page, and need no configuration.
QA Harness
The QA Harness plugin is a testing tool used to verify QUP builds — it can take screenshots, capture diagnostics and run audio test signals on demand. It does nothing unless asked and is safe to leave enabled, but there's no reason to enable it for normal use.