Settings-Music-Video-Backgrounds-Plugin

Music Video Backgrounds Configuration

Music Video Backgrounds settings

Music Video Backgrounds is an optional plugin: install it from the Plugin Browser (Media Library → Plugin Browser). It installs yt-dlp and deno with it, and goes live the next time you restart QUP.

Disclaimer: the first time you tick "Enable music video backgrounds" you are asked to agree that you have the rights to use the songs you play. If you click Cancel, the box stays unticked and the plugin stays off.

Automatically downloads music videos from YouTube to play as backgrounds behind CDG karaoke lyrics. Instead of a plain black background, singers get the actual music video playing behind their words. Only the picture is downloaded: the room always hears the karaoke track, never the video's own sound.

Its settings are in Preferences → Plugins → Music Video Backgrounds (Preferences is Ctrl+P).

Choose it as your background

Only one background can be drawn behind the lyrics at a time, so make sure this one is picked. Either:

  • In Preferences, click the Plugins heading and choose Music Video Backgrounds under Background Visualization, or
  • In the Media Library, open Plugins → Backgrounds → Music Video Backgrounds and select Use this background.

The Backgrounds page also has a Dim slider. It is a master control on top of this plugin's own brightness, and the preview shows what the projector will show.

Music Video Backgrounds in the Media Library Backgrounds list

Setup

Repair yt-dlp — yt-dlp and deno are installed with the plugin, so you normally never need this. If one of them has gone missing, this downloads them again (about 50 MB) and fills in the yt-dlp path.

Cancel — Cancels a repair in progress.

Enable music video backgrounds — Turns the feature on or off. When it is on, QUP looks for and downloads a matching music video for the song that is playing and for the songs coming up next, so most videos are ready before the singer is.

Start videos with audio — On by default. Holds the video on its first frame until the karaoke audio actually starts. Many karaoke tracks open with a second or two of silence; without this the video starts with the file and stays that far ahead of the music all song.

yt-dlp path — The path to the yt-dlp program. This is set automatically but can be changed if you have yt-dlp installed somewhere else.

YouTube Settings

Cookies from browser — Choose a browser (chrome, edge, firefox, brave, opera or vivaldi) for yt-dlp to borrow YouTube cookies from, or leave it on none. Helps with age-restricted or region-locked videos. Chrome and Edge must be fully closed before their cookies can be read.

Cookies file — Path to a cookies.txt file exported with a browser extension. When set, it is used instead of the browser option above.

Cache

Cache directory — The folder where downloaded music videos are stored. By default this is a music-videos folder inside the plugin's own data folder. If you type a folder that is not a full path, QUP puts it back in that default place.

Max cache (MB) — The most disk space music videos can use. Default 5000 MB (from 500 up to 50000). When the cache is full, the oldest videos are removed to make room for new ones.

Cache — Shows how much space the music video cache is using now.

Video

Video quality — The highest resolution to download: 480, 720 or 1080. 480 is the default and is plenty for a dimmed video behind CDG lyrics; 720 or 1080 look better on large screens but use more disk space and bandwidth.

Video brightness — How bright the video appears behind the lyrics. Default 50%. Lower makes the lyrics easier to read; 100% is full brightness. The projector follows the slider as you drag it.

Save Settings — Saves your settings. They are also saved when you close the Preferences window.

Test yt-dlp — Checks that yt-dlp runs and shows its version above the Enable box.

Clear Cache — Deletes everything in the cache folder and frees up the disk space.

Updated on version 2.35.0, October 31, 2026