Main-Interface-Overview
Main Interface Overview

A new install opens with each part of QUP in its own window, laid out as above. The windows snap to each other and to the edges of the screen, and QUP remembers where you put them and whether you hid one.
- One window or many: right-click any window's title bar and choose Dock to put everything in one window; choose Undock to split them again. Docked, QUP keeps the same arrangement.
- Show or hide a window: the Windows submenu of the same right-click menu has a tick for each window. Alt+W shows or hides the Player windows, Alt+E the Playlist, Alt+L the Media Library.
- Start over: Windows → Reset layout puts every window back where a new install has it.
- Save a layout: arrange the windows for a kind of night, then Windows → Save layout as… (on a Mac, the Window menu) and give it a name. Windows → Layouts switches to it straight away, with no restart, even while a song plays.
Saved layouts
A saved layout keeps where each window sits, its size, and whether it is docked, open, rolled up or always on top. It never moves the singer screen and never changes a setting. Karaoke, DJ and Media Player modes each have their own layouts.
Manage layouts… (in the same Windows menu) lists them with when each was saved, and has Switch to, Rename…, Delete…, Export… and Import…. Export saves a layout as a file you can take to another computer. Saving over a name you already have, or deleting a layout, always asks first.
In Preferences → General → Hotkeys you can give Switch to saved layout 1 to 5 a key (the first five in the Layouts list). None has a key until you set one.
Status
The strip across the top shows the session at a glance: how many more singers there is room for before closing time, how many songs are in the queue, the total time of the queue, and how long a new singer would wait. It reads "We're ready for singers" before the first song and "SOLD OUT" once the queue reaches closing time.
Karaoke and Filler
Two players. Karaoke plays the singers' songs and Filler plays background music between them. Each has a VFD-style timer and scrolling title, volume and balance sliders, a waveform of the track with the play position, and Previous, Play, Stop, Pause and Next buttons. EQ shows or hides that player's EQ window; the Karaoke player also has AGC (automatic gain control). See Crossfader for how the two hand over, and Filler Playlist for where filler comes from.
Karaoke EQ, Filler EQ and Mix
Each player has a 10-band EQ window; see Equalizer. Mix sits between them: Pitch, Tempo % and CDG offset for the current song, the CUT slider, and the CROSSFADER with its Silence / No Karaoke / Manual modes.
CDG Preview
A small copy of what the singer screen shows: the CDG lyrics, the video, or the LRC lyrics, as the song plays. The singer screen itself is a separate window you put on your projector or TV; Alt+Enter makes it full screen.
Playlist
The song queue, with Playlist, Filler and History tabs, a search box, and Open kcombo under it. See Playlist, Filler Playlist and History.
Media Library
Everything else lives in the Media Library's tree:
- Local Library → Karaoke is your song library: search it, double-click a song to queue it (Queuing Songs). The count at the bottom says how many songs are in the library, and Add to Library adds a folder, files, or a song for a singer. Filler and Playlists sit beside it.
- Singer Management → Rotation is the singer rotation (Rotation), with Tonight's Singers and the Singers Database beside it.
- Plugins holds the panels of the plugins you have: Mic Effects, the MilkDrop and Audio Visualizer backgrounds, the Plugin Browser, Internet Radio, Cheer, and any you add. Optional plugins (Karaoke Maker, SongShop, File Management and others) add their own entry here once you install them from the Plugin Browser.
The right-click menu
Right-click any window's title bar (or any empty part of a window) for QUP's menu: Dock / Undock, Send Message, New Session, Preferences, Singer Database, About, Help…, Report a problem…, the Windows submenu, and Exit. These replace the row of icons older versions had in the top right corner; see Quick Access Buttons.
Hotkeys
Hotkeys work out of the box. A few to start with: X play, C pause, V stop, B next (add Shift for the Filler player), Ctrl+P Preferences, F1 Help, Ctrl+F1 About, F6 next window. The full list, and the place to change them, is Preferences → General → Hotkeys (see Hotkeys).
Updated on version 2.37.3, November 13, 2026