Settings-Plugin-Manager
Plugin Manager

QUP's optional features ship as plugins: self-contained add-ons for things like OBS recording, Discord integration, internet radio and visualizations. Some come with QUP; more are free downloads from the Plugin Browser. Manage Plugins is where you choose which ones load.
Open Preferences (Ctrl+P) and click the Plugins heading itself in the left tree, rather than one of the entries beneath it.
Turning plugins on and off
Each installed plugin has a checkbox, with its version beside the name. 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. A plugin you untick keeps running until you restart.
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.
A plugin marked (EXPERIMENTAL Not production quality yet) (currently CDG Enhancement) starts switched off. Tick it and restart if you want to try it.
Background Visualization
Below the plugin list, Background Visualization picks what is drawn behind the lyrics. Only one can be active at a time: None — plain lyrics, or one of the visualization plugins (Audio Visualizer, MilkDrop (projectM)). The choice takes effect when the next song starts.
Getting more plugins: the Plugin Browser
The Plugin Browser is in the Media Library under Plugins → General → Plugin Browser. It lists every plugin in the QUP catalogue, with its size and the platforms it runs on, and the downloadable skins too. A skin is ready as soon as it's installed (choose it in Preferences → Display → Skin & Layout); plugins need a restart.

- Search by name, author, description or tag, or use the filters (All, a type, Installed, Not installed, Tools).
- Press Install, Update or Uninstall on a plugin's row. The row changes to Pending; nothing happens yet. Click Pending again to take it back out.
- Press the Apply button at the bottom right, which sums up what you picked (for example "Apply — 1 plugin: 169 KB"; with nothing picked it reads "Nothing staged"). QUP shows exactly what will be downloaded or removed and asks you to confirm.
- Restart QUP when your show allows. Nothing goes live until then, so it's safe to use mid-show.
A newly installed plugin shows up in Manage Plugins after the restart. A row marked Off in Preferences › Plugins (the row's own wording) is installed but unticked here.
Uninstalling removes the plugin itself, never your own files or the plugin's settings. Plugins that come with QUP can't be deleted: Uninstall on one of those just switches it off, the same as unticking it here.
If an update to QUP stops including a plugin you were using, QUP tells you at startup ("Plugins moved to the Plugin Browser") and puts it in the browser ready to install. Your settings for it are kept. Press Open Plugin Browser, then Apply at the bottom, then restart. Tick Don't remind me about these if you don't want it back.
Safe Mode

If QUP won't start properly and you suspect a plugin, start it in Safe Mode: on Windows use the QUP Karaoke Safe Mode shortcut in the Start menu, or start QUP with --safe-mode. Every plugin is skipped for that session only, and your saved on/off choices are left alone, so a normal restart brings back whatever you had.
The title bar shows SAFE MODE (plugins off), so you can't leave it on by accident. The Plugin Browser still works in Safe Mode, so you can uninstall the plugin that's causing trouble.
Where plugin settings live
Each plugin keeps its configuration and data in its own folder under plugins/data/ in QUP's data folder (on Windows %LOCALAPPDATA%\QUPKaraoke, on a Mac ~/Library/Application Support/QUPKaraoke, on Linux ~/.local/share/QUPKaraoke), separate from the plugin itself. That separation is deliberate: updating or reinstalling QUP or a plugin replaces plugin code but never touches your data. Your mappings, caches, credentials and preferences survive upgrades.
Plugins with their own settings pages
Plugins that have settings appear under Preferences → Plugins with their own page. Of the plugins that come with QUP:
- Audio Visualizer
- CDG Enhancement (when switched on)
- Discord Party
- Internet Radio
- LRC Lyrics
- Metadata Editor (a short how-to; nothing to set)
- MilkDrop (projectM)
- OBS Recording
- Sound Pads
Most plugins from the Plugin Browser add a page too, for example Music Video Backgrounds, SongShop, Karaoke Maker, KaraFun, MIDI Karaoke, LAN Queue and Credit Top-Up (singers add credit from their phone; see Credit top-ups).
Some plugins keep their controls in the Media Library (under Plugins) instead and have no page under Preferences → Plugins: QUP Cheer, AutoFiller, Genre Tagger and File Management. (Cheer's display settings are QUP's own, under Preferences → Display → Cheer.)
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 is listed in the Plugin Browser but is not installed by default. It does nothing unless asked, but there's no reason to install it for normal use.
Updated on version 2.36.0, November 5, 2026