Settings-Database
Database Configuration

Open it from Preferences → General → Database (main menu → Preferences, or Ctrl+P).
Song Name Formatting
Tells QUP how your karaoke files are named, so it can read the disc and track number, artist and title from each file name. Pick the format that matches your files. The default is the first one, the Autokdj standard.
\DISC\TRACK - ARTIST - TITLE.EXT(Autokdj standard): a folder per disc, then track, artist and title in the file name.\DISC\TRACK - TITLE - ARTIST.EXT: the same, with the title before the artist.\DISC-TRACK - ARTIST - TITLE.EXT: disc and track together in the file name, no folder per disc.\DISC-TRACK - TITLE - ARTIST.EXT: the same, with the title first.\ARTIST - TITLE.EXT: no disc or track number.\TITLE - ARTIST.EXT: no disc or track number, title first.\TRACK - ARTIST - TITLE.EXTand\TRACK - TITLE - ARTIST.EXT: a track number but no disc.\ARTIST - TITLE (DISC-TRACK).EXTand\TITLE - ARTIST (DISC-TRACK).EXT: the disc and track in brackets at the end.\ARTIST - ALBUM\TRACK - TITLE.EXT: a folder per album, named "Artist - Album".
Custom: for files that match none of these, type your own pattern. The fields are $disc, $track, $artist, $title, $album and $skip (a part to ignore). Everything else is a separator, matched as typed; a space matches any number of spaces. Write a field with # instead of $ to read it from the folder name: #disc - $track - $artist - $title reads \SC8125\03 - Artist - Title.zip. Use \ for more folder levels, as in #artist\#album\$track - $title. The line under the box shows how QUP reads your pattern, or why it can't use it yet. Hover over Custom: for these notes in the app.
Choose the format before you scan. If you change it after scanning, press CLEAR MEDIA DATABASE and then Rescan All (under Preferences → General → Media) so every song is read again.
Files named differently from the rest can be read with their own format, without changing this setting, using the File Management plugin's Import Format (see File Management).
Database Backup Options
Backup on shutdown: when QUP closes normally, it saves one checked backup of its databases (your singers and song statistics among them). If a session ends in a crash, the next launch makes the backup instead. The newest 5 backups are kept in the data/db/backups folder. Leave this on.
Clear a song's bad mark when it plays to the end: a song you marked bad (Note Bad File), or that QUP marked after a failed scan or play, loses its mark once it plays all the way through. On by default.
Database Actions
Every action asks you twice before it runs.
VERIFY MEDIA DATABASE: checks that every song in the media database still points to a file on disk. It can take a long time on a big library: don't run it during a show.
CLEAR MEDIA DATABASE: removes every song from the media database. No files are deleted. Rescan your folders afterwards.
EXPORT SINGER DATABASE: saves your singer database to a CSV file in the export folder.
IMPORT SINGER DATABASE: reads singers from a CSV file. It was made for moving from an old Autokdj + MySQL setup to QUP.
CLEAR SINGER DATABASE: removes every singer from the database. This can't be undone: export a copy first if you want to keep them.
EXPORT SONG STATS: saves how often each song was played to a CSV file in the export folder, handy for finding your most popular songs.
RESET ALL PINCODES: clears every singer's PIN. Singers use their PIN to identify themselves on the kiosk, so each one sets a new PIN on their next visit.
Updated on version 2.35.0, October 31, 2026