Changelog
QUP Karaoke Engine — Changelog
What's new in QUP Karaoke Engine
QUP Karaoke Engine — Changelog (v2.0.42 onwards)
QUP Karaoke Engine — v2.37.5
Fixed
- Karaoke on an output that only plays 48 kHz. On Windows, a chosen output set to 48000 Hz in shared mode (many USB audio interfaces) could refuse karaoke songs, and QUP fell back to the default output with "Chosen output not working". QUP now asks Windows to convert the rate, so karaoke plays on the output you chose. If an output still can't be used, the message names it and says why.
- Cheer with stacked strips. With the karaoke scroller in stacked mode (not overlaid on the picture), chat, reactions, stickers and shout-outs were never shown, on the singer screen or in OBS. They now draw on the singer screen in both modes and reach the OBS overlay on their own. When Cheer can't show on the singer screen (it isn't open), the Cheer panel says so once a night, with a Hide button.
- Plugin Browser: tool updates. Updating Karaoke Maker could claim a full download of its Python tools (hundreds of MB) when they only needed updating in place. The row now says "Updates in place" and no download size is counted.
New
- Where online viewers' Cheer shows: Preferences > Cheer > "Online viewers" picks the stream only (the default) or the singer screen and the stream. It applies to the next message, with no restart.
QUP Karaoke Engine — v2.37.4
Fixed
- Big background-music folders. Adding a large folder (tens of thousands of tracks) could freeze QUP for a long time, and closing the frozen window left only part of the folder in your background music. Add folder…, the folder list's Scan and Rescan All now work in their own small window, "Adding background music", which counts the tracks as it finds and adds them. QUP stays usable while it runs, and folders with ordinary-size tracks are added about ten times faster.
- Stop in that window keeps the tracks added so far; Rescan adds the rest, with no duplicates.
- When the scan ends, QUP says how many tracks it added, how many were already there, and how many folders it couldn't read (an offline share, a folder you don't have access to, or a shortcut to a drive that's unplugged). The log names them. Before, those folders were skipped without a word. A folder that links back into itself no longer stops the scan.
New
- More background-music formats: .opus, .aif and .aiff files are now added to background music.
QUP Karaoke Engine — v2.37.3
New
- Saved window layouts. Arrange your windows, then right-click a window (on the Mac, the Window menu) and choose Windows ▸ Save layout as…. Windows ▸ Layouts switches to a saved layout straight away, with no restart, even while a song plays. A layout keeps where each window sits, its size, and whether it is docked, open, rolled up or always on top. It never moves the singers' screen and never changes a setting. Layouts are kept per mode (Karaoke, DJ, Media Player). Manage layouts… renames, deletes, exports and imports them. Saving over an existing name, or deleting a layout, always asks first. In Hotkeys you can give "Switch to saved layout 1–5" a key; none has one by default.
- Cheer on your stream. The Cheer panel has a new OBS overlay… button. Turn on "Show Cheer on the stream", then add the link as a Browser Source in OBS (1920×1080). The room's chat, shout-outs, reactions and stickers then appear over your stream, at the same moment the room's screen shows them. Anything you take off the room's screen comes off the stream too. The overlay is off until you turn it on. It runs only on this computer, and its link stops working when you press New URL….
- Add the overlay to OBS in one click. In the OBS Recording plugin's settings, Add the Cheer overlay to OBS puts it in the scene that's live in OBS now, or updates the one that's already there. OBS draws a Browser Source only while its scene is live, so add it to each scene you stream from.
- "Hosted by" on the singers' screen. Preferences ▸ General ▸ KJ
profile has a place for your KJ or stage name, and two switches that are
off until you tick them. One shows "Hosted by
" on the singers' screen between songs. The other shows it on the Cheer stream overlay. The other parts of the KJ profile are for KJ pages, which aren't open yet.
KaraFun
- Download everything (Pro accounts). The KaraFun plugin can have KaraFun save its whole catalogue for offline use, most-played and popular songs first, using KaraFun's own offline save. Before it starts, it shows the size and the free space. It stops 2 GB short of a full disk, and you can set a limit. Remove QUP's saved songs leaves the songs you saved in KaraFun yourself.
- If KaraFun is waiting to install its own update, QUP now says so ("Open KaraFun once on its own to let it finish") instead of just failing to start it.
Fixed
- Opening QUP while an update installs. Opening QUP again while an update was still installing could leave the splash screen up with no window. QUP now waits for the install to finish, then starts the new version. If QUP can't start for any other reason, it says so and closes, instead of leaving the splash up.
- When you choose Update when I close, the exit question now says the update is installing and asks you to wait a moment before opening QUP again.
- Report a problem now includes the log from the session before, too.
Plugins
- Cheer 1.3.0 and OBS Recording 1.2.0 (both need QUP 2.37.3 or later), YouTube 1.1.4, Genre Tagger 1.0.3, KaraFun 0.5.9.
- For plugin developers: the new
WindowLayoutsAPI lists, switches to and saves layouts, and moves, shows and docks the workspace windows. See the Plugin API page.
QUP Karaoke Engine — v2.37.2
New
- Plugin updates come with the QUP update. If you pressed Update before the list of plugin updates had appeared, QUP used to update itself and skip the plugins. Now it installs every plugin update it offers (the same as the rows, which are ticked by default). If you untick rows, your choice is kept as before.
- QUP tells you once when plugins are still behind after an update. On the first start after an update, if some of your downloaded plugins have a newer version, QUP says so once and offers Open Plugin Browser.
Fixes
- LRC and MIDI lyrics keep their shape on the projector. They were laid out at CD+G's shape and stretched to a widescreen projector, about 28% too wide. They're now laid out at the projector's own shape. CD+G is unchanged and still fills the window.
KaraFun
- A music video background behind a KaraFun song no longer freezes. With the KaraFun app, the background video and the projector countdown could play a second or two, then hold for about two and a half seconds. The song clock now runs smoothly between KaraFun's position reports.
Plugins
- KaraFun 0.5.8 (needs QUP 2.37.1 or later), MIDI 0.1.1.
QUP Karaoke Engine — v2.37.1
New
- Check for updates… is in the app menu (under Help…), in the Help pane and in the About window. It tells you if a newer QUP is out (and offers Update now), says "You're up to date" if not, and says so plainly if it couldn't reach us.
- A copied data home asks before it shares your venue. If you copy QUP's data folder to another computer, both copies used to run as the same cloud venue. Now the copy asks at its first start: Use as a new venue here (the default: your old venue keys are backed up, the cloud is switched off on this copy and Preferences > Cloud opens so you can register it) or Keep as the same venue (both computers stay one venue, and it doesn't ask again). Songs, settings and the singer database are never touched. The same computer, an upgrade or a copy with no cloud venue never asks.
- One switch for the whole scroller. The Scroller page has Enable all scroller features: untick it and the scroller, up-next, countdown and QR overlays all leave the singer screen, without losing your settings. Ticked (the default), everything works as before.
- Docked windows stretch. In the docked layout, dragging the main window's right or bottom edge (or its corner) now widens or lengthens the stretchable panes on that side (Media Library, Playlist, Queue), instead of leaving empty space. The Player's sections keep their size.
- QUP tells you when the output falls back. If the output you chose for karaoke or break music won't open and QUP plays on the computer's default output instead, it now says so: "Chosen output not working, outputting to default output" (once per device, shown and spoken).
- Graphite Deck is the starting skin for new installs, and now ships with QUP. Existing installs keep the skin they have. Graphite Deck can still be updated from the Plugin Browser.
- New installs start with no background visualization (plain lyrics on black). You can pick one in Backgrounds as before; existing installs keep theirs.
KaraFun
- KaraFun on the projector is much smoother on older computers. QUP now shows KaraFun at its own shape, drawn 1:1 (it was stretched about 28% too wide), and does far less work per frame. On a 2012 MacBook Pro the projector went from about 9 to about 20 frames a second.
- A KaraFun green screen is keyed out in the web player too, so the lyrics sit on QUP's black or your background instead of a green band.
- QUP closes the KaraFun player when you quit QUP, instead of leaving it running. A new KaraFun setting, Keep the KaraFun player open when QUP quits, keeps the old behaviour.
- Older computers can play KaraFun. The plugin now finds a browser this computer can actually run (Chrome, Edge, Brave or Chromium), skips ones that are too new for the system (older Macs, Windows 7/8.1), and if none will do, says which version to install.
- KaraFun's messages now appear in QUP's own log, which makes problem reports easier to follow.
Fixes
- An audio device that stops answering no longer freezes QUP. Some
interfaces (seen with a PreSonus AudioBox on a Mac) can stop responding
when QUP opens them. QUP now gives up on the device after a few seconds,
marks it for the session and tells you: "
" isn't responding. Unplug and replug it, or pick another output in Preferences > Input/Outputs. Song starts, Sound Pads and quitting no longer hang on it. - Video songs play on your chosen output at its own rate. On Windows, a video song could drop to the default output on an interface running at 48 kHz. It now opens at the device's own rate.
- ASIO: one connection per driver. If something else in QUP (headphone cue, guide vocal) asks for the ASIO driver your mains already uses, QUP now refuses it with a clear message instead of failing silently.
- Lower CPU on Macs (and on Windows with GL off): plain CD+G, the scroller, the VFD timer and EQ dots, skinned meters and plugin pictures (KaraFun, MIDI, LRC) all cost much less to draw. MilkDrop 1.0.2 no longer copies audio while nothing is shown.
- Docked: overlapping sections are moved apart. A saved layout whose windows overlapped could hide part of the EQs behind the transport in the docked view. They're now laid out side by side.
- Reset layout in DJ mode puts the Player's parts back where a new install has them.
- The Playlist pane's first tab now says Karaoke, beside Filler and History.
- BPM detection reads video files (avi, mp4) and zips with accented names, and logs one short line for a file it can't read, once per session.
- Fewer cloud requests at start: QUP no longer re-asks for the shared KaraFun catalogue when it already has a fresh answer.
Plugins
- KaraFun 0.5.7 (needs QUP 2.37.1), MilkDrop (projectM) 1.0.2, Sound Pads
1.1.2. Plugin developers: see the Plugin API page for
effectsSinkRate()and three newSourcePlayerhints (keepsOwnShape(),setBackgroundUnder(),pictureSerial()).
QUP Karaoke Engine — v2.37.0
New
- Update now. When a new version is out, the notice now has an Update now button. QUP downloads the update, checks that it is really ours (the file's checksum and our publisher signature), installs it and reopens. During a show the button reads Update when I close QUP: the update downloads now and installs when you close QUP yourself, so a show is never interrupted. If a plugin you downloaded from the Plugin Browser has a newer version for the new QUP, the notice offers it too. On Linux, QUP downloads and checks the update, then opens its folder for you to install. This takes effect from the next update after 2.37.0.
- Pause between songs. A new karaoke setting, Pause Between Songs, holds the break music for up to 5 minutes before the next singer starts (Off, the default, works exactly as before). A countdown, "Next singer in 1:24", has Start now and Cancel. Whoever is next when the pause ends is the one who starts, so moving or removing a singer during the pause is honoured. Pressing Play or picking a song yourself is never held back.
- Merge two singer accounts into one. When a singer ends up with two accounts (a forgotten PIN, a new phone sign-up), right-click one in the Singer Database and choose Merge with another account.... The account you right-clicked is kept. The list puts the same name first, then likely duplicates ("Sarah 2"), and each line shows the ID, the card's last 4 digits, phone yes/no, the balance and the last visit, so two "Sarah"s are easy to tell apart. A preview shows what the merged account will look like. Credits and visits are added together, history and favourites are joined, and the card and the phone sign-in move to the kept account if it has none. A ban on either account stays. Tonight's rotation and queue follow the kept account. QUP won't merge two different phone accounts or two different cards. Every merge is backed up and can be undone for 90 days (Undo a merge...).
- Likely duplicates are marked in the Singer Database: "Sarah", "sarah", "Sarah 2" and "Sarah_2" show "(possible duplicate of Sarah, ID 12)" next to the name.
- Reset PIN reaches the phone. For a singer who signs in from their phone, the singer editor's Reset PIN... now also changes the PIN on QUP Cloud, so the new PIN works on the phone too and the singer doesn't make a second account. Phone PINs are 4 digits. QUP tells you whether the phone PIN changed.
- Cheer: Unmoderated. A new switch in the Cheer panel turns Cheer's filter off for the show: everything singers send can appear on your screen, and Cheer is free while it's on. It asks before it turns on, shows an amber UNMODERATED badge while it's on, and is off every time QUP starts (it also ends within 10 minutes of QUP closing). Hiding and blocking still work.
Fixes
- Break music and internet radio play on your mains device. With Mains set to an output that isn't the computer's default (an audio interface, say), break music and internet radio played on the default output instead. They now play where karaoke plays, on Windows and Mac. With an ASIO mains, internet radio now goes through ASIO too, like break music already did.
- A singer added this session can be edited and deleted at once. Before, a singer added since QUP started could only be deleted or edited after a restart.
- Each row in the Singer Database opens its own account. With two accounts of the same name, Edit and double-click could open the other one.
- Report a problem no longer sends your e-mail address or registration details. Four settings stored in a coded form slipped past the report's privacy filter. They are now left out, and any setting that decodes to an e-mail address or a key is removed.
- A plugin that comes with QUP and is newer than a copy you downloaded earlier now loads the newer one. Your downloaded copy is kept on disk.
Also new
- Kiosk Security says when the kiosk and bar server is off (it is on unless you turned it off in Preferences > Network), with a Turn it on button. The pairing windows say so too, instead of showing a code nothing can reach.
- Internet Radio 1.1.3: a station sync never empties the station list. The old list stays in use until the new one has fully arrived, and a sync that fails part-way leaves it exactly as it was.
- QUP Cloud traffic: an idle QUP now checks QUP Cloud every 5 seconds after 2 quiet minutes (every 1.5 seconds while anything is happening, and straight back to that at the first phone request), and each check is one request instead of up to four. Phone requests still arrive within a few seconds.
- Plugin updates already in the Plugin Browser:
- YouTube 1.1.3, Music Video Backgrounds 2.0.3, Karaoke Maker 2.0.4: when Chrome's cookies can't be read (Chrome on Windows locks them), a plain hint says to sign in to YouTube in Firefox and pick firefox, or to use a cookies.txt file. On Windows, firefox is now listed first. YouTube downloads work on Windows 7 again.
- KaraFun 0.5.3: phones at your venue see KaraFun songs only while a KaraFun account is signed in on the player (the web player signed in and not preview-only, or the KaraFun app with a subscription that allows offline songs).
- Credit Top-Up 1.0.1: top-ups still in progress (waiting for payment or for your approval) follow a singer-account merge to the kept account, and go back if you undo the merge. Needs QUP 2.37.0.
- Plugin API:
QUPPlugin.onSingersMerged(SingersMerged)andonSingersMergeUndone(SingersMerged, int), so a plugin that keeps anything by singer can follow a merge and its undo.
QUP Karaoke Engine — v2.36.1
Fixes
- Deleting a singer deletes only that singer. In the Singer Database, a delete now removes exactly one account. Before, deleting one of two accounts with the same name (a singer who forgot their PIN and made a new one) removed both, and the window could lose the singer listed below the deleted one until QUP was restarted.
- Two singers with the same name keep their own credits. Credits, paid queueing, song purchases, bribes and visits now change only the account in use. Before, a change to one of two same-name accounts was also made to the other. When QUP can't tell which account is meant, it changes nothing and notes it in the log.
- Break music fades out as soon as a karaoke song starts, however quietly the song begins. Before, in the Silence crossfade mode, a quiet intro, a silent lead-in or a soft song could leave the break music playing under it.
Also new
- Playlist: an Artist column, on by default next to Song Title. A column layout you saved before keeps its columns; right-click the header to show or hide Artist.
- Start-up: the singer screen now opens together with the operator windows, not seconds before them.
- KaraFun 0.5.1: KaraFun songs saved for offline use (KaraFun app). With the KaraFun app as the player, QUP saves every KaraFun song in the rotation for offline use in KaraFun as soon as it is queued, so it still plays if the internet drops. On by default, kept under 5 GB (Settings > Plugins > KaraFun): the least recently played go first, never a queued or playing song, and never a song you saved in KaraFun yourself. QUP keeps 2 GB free on the drive. It also saves the venue's most-played KaraFun songs ahead of time, between songs, into the room the limit leaves (counted from the songs played here from this version on).
- Phone cards show only when something costs credits: a singer's phone card (the QR the bar scans to add credits) now needs the "Phone cards" switch, Database mode AND at least one paid feature on: charge to sing, bribes, song purchases (Song Store or Tricerasoft) or Credit Top-Up. With none on, phones show no card and a bar scan answers "Phone cards are off".
- Plugin API: a plugin that spends singer credits as a feature adds
spends_credits: trueto its cloud state while it is on, so phone cards show. Taking credits alone (takeSingerCredits) does not count.addSingerCredits/takeSingerCreditscan now answerok() == falsewitherror()ambiguous_singer(CreditResult.AMBIGUOUS_SINGER): two or more accounts share that singer hash, and nothing moved.
QUP Karaoke Engine — v2.36.0
Credit Top-Up (new plugin)
- Singers can buy credit from their phone, and the money goes straight to
the KJ's own account. Pick one way per venue: PayPal checkout, a
PayPal.me link (you approve each one), or Stripe (card, Apple Pay and
Google Pay). Credit Top-Up 1.0.0 is off until you set it up. Install it from
the Plugin Browser. See Credit top-ups.
- You set the packs and prices. A phone only picks a pack, so it can't change what it pays.
- A payment adds credit once, and only when the payment provider confirms the full amount. A phone that closes right after paying still gets its credit on the next check.
- A refund or dispute shows you a notice. Credit is only taken off when you click to take it off.
- Your PayPal secret and your Stripe key are kept in your system's secure store (Windows, macOS Keychain, Linux Secret Service), never in a settings file. Stripe takes only a restricted key, and Test connection names any permission the key is missing.
Credits
- Credits change in one step everywhere: songs, the bar, the kiosk, bribes, top-ups and the singer editor. The singer editor saves a balance only when you changed it, and if the balance moved while the record was open, it asks which amount to keep.
Cheer and OBS
- Reaction counts on the OBS lower third. It adds the current singer's top three reactions, for example "Alice ♥ 12 Fire 5 Clap 3". Plain symbols are on by default, because OBS's text source draws emoji as empty boxes. (OBS Recording 1.1.0)
- The Cheer panel has a "Tonight" row listing singers by the reactions they got tonight, each with their top reaction. New Session starts the count again. (Cheer 1.1.0)
Start-up
- A start-up splash with a progress bar shows while QUP loads, naming the plugin it's loading.
- QUP starts about half a second sooner. It no longer builds five buttons that were never shown.
Faster and lighter
- Big song lists refresh at once. A sorted Tricerasoft list or Singer Database used to freeze QUP for many seconds while it refilled (23 seconds for 2,000 sorted songs), and the sorted Singer Database could fail to refresh at all.
- QUP uses less processor time while it sits idle: the countdown, meters and spectrum don't redraw when nothing has changed, and the now-playing display draws its dot pattern from a saved picture.
Fixes
- A song marked bad shows red again in the Media Library, and a screen reader says "marked bad" there.
- Intel Mac build on an Apple Silicon Mac: QUP now says to use the Apple Silicon download before any audio opens, because the Intel build crashes at the first song there. You can continue anyway, and turn the notice off.
Developers
- Plugin API: singer credits for QUP's own payments plugins (
singerCredits,addSingerCredits,takeSingerCredits), answering a cloud command later (answerCloudCommand), and a secure store for plugin secrets (secrets()). See the Plugin API page.
QUP Karaoke Engine — v2.35.1
Fixes
- The installer asks you to close Q-Up if it's running, instead of failing with "file in use" errors. Close it the usual way (so it saves your settings), then click Retry. Cancel stops without changing anything. The uninstaller asks the same.
- Play works again at the end of the queue. When the last song ends and nothing else is queued, the now-playing line says "Queue empty. Play replays “Title”", and Play plays that song again. Before, the song stayed on the deck and Play did nothing.
- A maximised QUP stops at the taskbar on Windows, instead of covering it.
- Internet Radio: Sync shows what it did. Closing Preferences no longer starts a sync. A sync's progress and "Sync complete — N stations cached. Last sync: …" show in the pane, also when Preferences is opened again during or after it. (Internet Radio 1.1.2)
- Filler fades no longer get stuck. A fade that started just as another one finished could leave the break music at the wrong level.
- About → OBS shows the OBS Recording plugin's log when the plugin is loaded. It always said "OBS plugin not loaded." (OBS Recording 1.0.1, which needs QUP 2.35.1.)
- A selected radio button shows its dot under the default skin. It used to look unselected: a black dot in a dark ring.
- The Windows installer no longer adds a "W Console" shortcut to the Start menu, and removes the one an older version added.
- The Cheer panel's people list starts at a readable width instead of a sliver. (Cheer 1.0.1)
- Spelling and layout: the Singer Database header, the Database pane's confirmations, and the "Check your email" window, whose text no longer runs off the side and whose buttons stay readable on a dark skin.
- Preferences → General → Input/Outputs in QUP Karaoke no longer shows the DJ decks' Headphone mode.
- Kiosk's Enable DEBUG starts off in a new profile.
Kiosks and Party mode
- Party mode kiosks no longer ask for a card. With "Use ID Cards" left ticked, a kiosk in Party mode said "Scan keyfob to begin" and then refused every card. Kiosks now ask for cards only in Database mode. The Party line in Preferences → Display → Kiosk says what Party mode is: no accounts, credits or chat moderation, for home parties.
- QUP tells the cloud when the venue is in Party mode, so Cheer is free there.
- Kiosk Security shows only what works. Settings that nothing ever used (operator approval, submissions per hour, the token grace window, the backstop rotation, filter strictness, the name length and auto-pause limits, and the two "Paranoid" placeholders) are gone from the pane, with the banner that promised them. Their saved values are kept.
Scroller
- The Scroller pane's lists show words instead of setting names: "Opening Crawl", "Rainbow Cycle", "Bottom Right". Your saved choices are unchanged.
Report a problem: Email me back
- Report a problem has an optional "Email me back" box. Fill it in if you'd like a reply. The address is sent beside the report, not inside it, and is shown in "What's included". Addresses in the logs and in what you wrote are still taken out.
Sound Pads 1.1.1
- Play pads from the keyboard. Each pad is a hotkey action in Preferences → Hotkeys, under Sound Pads ("Pad 1: Applause" and so on, named after your labels), plus Stop all pads.
- A built-in sound shows its name in the pad's row ("Happy birthday"); point at it for the full description.
- The "no audio output" note points to Preferences → General → Input/Outputs, and Browse lists every file type it takes (wav, mp3, ogg, flac, m4a, aac, aif, aiff).
Plugins
- KaraFun 0.4.1 (KaraFun app on Windows):
- The green screen setting sticks. If KaraFun took more than a minute to start under QUP, QUP lost track of it on the next song, and turning the green screen on or off was only saved, never sent to KaraFun. QUP now picks its own KaraFun back up. While KaraFun isn't running under QUP, the panel says the choice is saved and applies when it next does.
- A KaraFun tab in the Media Library with a Green screen: ON / OFF button, and a hotkey for it in Preferences → Hotkeys. It is the same choice as "Enable Green Screen" in the plugin settings, and the two always agree.
- SongShop 1.0.4 keeps a saved card and the Party Tyme password in your system's secure store (Windows, macOS Keychain, Linux Secret Service), and a card used "for this session" is never written to disk.
- Audio Visualizer 1.0.1: "Reactivity" is now "Bar hang time": it sets how long the bars hold their peaks.
- MilkDrop 1.0.1: the preset note now says QUP ships a starter set.
- Karaoke Maker 2.0.2: wording only ("Repair Tools").
- The Plugin Browser no longer says the MilkDrop visualizer is missing on Apple Silicon Macs; it works there.
Developers
PluginContext.registerAboutLog(Supplier<String>)(@since 2.35.1): a plugin can hand QUP a log for the About box. See the Plugin API page.- Plugins that stop karaoke now bring the break music back, like the Stop button. A plugin's Pause and resume also move the break music as the buttons do.
QUP Karaoke Engine — v2.35.0
New: Preferences > Display > Cheer
- Choose how Cheer looks on the singer screen on a new Cheer page under
Preferences > Display. Each kind has its own choices:
- Shout-outs: an overlay at one of nine spots and the width you choose (it may cover the picture), a band of their own at the top or bottom (the picture shrinks out of the way and comes back after), or on the scroller as before. Fade in, pop in, scroll across once, or none; the font, size, colours, edge and backing; how long each one stays.
- Chat: its band at the bottom (as before) or at the top, or an overlay; how many lines and how long each stays, with the same look choices.
- Stickers: which corner and how big. Reactions: the left and right columns on or off, their size, float up or pop, and how long each stays.
- Preview puts a sample of each kind on the singer screen, so you can see a change before the room does. Nothing goes to the phones and no credits are used. The singer screen must be open.
- Shout-outs now land at the top centre of the picture by default, where they used to run along the scroller. To keep the old look, choose "On the scroller (as today)".
- Your Cheer choices from 2.34 (chat on or off and its lines, shout-outs, stickers, Roast and reactions) come across by themselves. They are now kept in one file, Cheer.properties; the old files are left as they were, so an older QUP still reads them.
- With the singer screen's animations off, Cheer items come and go without fading or scrolling.
New: the KJ joins in from the Cheer panel, free
- Say something in the room's chat as the KJ (up to 160 characters), React... with any of the room's eight reactions, and send any Sticker... on offer, all from the Cheer panel. The KJ never pays credits.
- What the KJ sends is marked with a KJ pill on the singer screen, in the KJ's colour (sky blue unless you change it in Display > Cheer, where the pill can also be turned off).
- If the room can't take it right now (chat or reactions off, say), the panel tells you why and keeps what you typed.
- The panel scrolls when it's too short for everything, such as docked at a large text size.
New: Open kcombo turns on the web server
- Open kcombo with QUP's web server off now asks to turn it on. Turn it on starts it and opens the page; before, the browser opened a page that couldn't load. If the server can't start, QUP says so.
- Preferences > Network's box now reads "Enable HTTP Server (kcombo, the singer queue page)".
Mac
- QUP for Mac needs macOS 11 (Big Sur) or later. The app now tells macOS so, so an older Mac says it can't open it instead of trying.
QUP Karaoke Engine — v2.34.1
New: Help > Report a problem
- Report a problem… is in the app menu and on the Help pane. Say what happened, and QUP gathers what we need to look into it: this launch's log and the one before, the settings that matter (never your venue name, ticker messages, PINs, passwords or licence), and the last few hundred things QUP did (songs started and ended, break music fading, audio changes, errors). E-mail addresses, keys and your Windows or Mac user name are taken out before anything leaves your computer.
- The window lists every file that will go; open any of them to see exactly what is sent. You can add a picture of the window you were using.
- Send sends it to QUP and tells you its report number. Save to desktop keeps it as a zip file on your desktop instead; if sending fails, QUP saves it there for you and says where.
- Ctrl+Shift+M marks the moment something goes wrong, so we can find it in the report later (change it in Preferences > Hotkeys). Opening Help or Report a problem marks the moment by itself when you haven't marked one in the last 10 minutes.
Fixes
- Crossfade "Silence": break music comes back up after a song a plugin plays, such as a KaraFun song. Since 2.31.0 it stayed down until you pressed Play.
- "No karaoke": break music comes back at the end of the night even when the queue still holds a song that can't play (a missing or bad file, shown in red).
- A plugin panel you popped out (such as Cheer) opens in its own window again after a restart in the karaoke layout where the Media Library is a window of its own (2.34.0 only did this with the Media Library docked).
- The floating Karaoke window is never too narrow for its controls at large text sizes (on Linux at 150 % the AGC button was cut off).
QUP Karaoke Engine — v2.34.0
QUP Cheer: the room's chat and reactions, run from QUP
- A new Cheer panel (Media Library > Plugins > Cheer; right-click it to Pop out into a window of its own) for venues linked to QUP Cloud. The room's chat from phones scrolls in the middle, with the singers' karaoke names, and marks for what is on screen, sweetened or flagged. Everyone in the room tonight is listed on the right; whoever is up now is marked.
- What the room may send: turn reactions, chat, stickers and shout-outs on or off, and set the venue's moderation level (Family, Bar, Roast) and the highest level a singer's "Roast me" may reach. Turning reactions off here also stops the singer screen from drawing them.
- Right-click a line to pull it off the screen, remove it from the screen and every phone, clear a flag ("Looks fine"), or jump to who sent it. Right-click a person to mute them for the night, read what they said tonight, or report them to QUP.
- The room's votes: where phones can vote on chat, shout-outs and stickers, each line shows its counts, e.g. [+3 / -1]. A line the room voted down says "voted down: off the phones" until you choose "Looks fine". Someone QUP itself muted shows why ("Muted by QUP: for a week") and can't be unmuted from the panel.
- Pull all off the screen with one button, or Ctrl+Shift+P, which also works with the Cheer panel in its own window (change it in Preferences > Hotkeys, "Cheer: pull everything off the screen").
- Announcements from the KJ (up to 160 characters, with a counter beside the box, and saved templates), and Happy hour: one hour a night of +25% credits on packs bought at the venue, with a countdown. Happy hour isn't offered yet: its button stays hidden in the Cheer panel until it is.
- Not linked to QUP Cloud: the panel says how to link the venue.
- House credits (where the venue has them on): choose who pays for Cheer, the audience, the house, or both, and how many credits the house pays for each person tonight. Pause house credits at any time. The room's pool shows its balance and warns when it runs low (under 2,000 credits by default). Buy credits for the room lists the packs on offer; after you confirm, the payment page opens in your browser, the receipt goes to the venue's email, and the credits arrive in the pool once it's paid. Each person in the list shows what the house paid for them tonight.
- Text limits are 160 characters everywhere: shout-outs (were 80) and KJ announcements (were 80), the same as chat. A long shout-out crosses the karaoke ticker once, whole, and scrolls in the Host TV's bar with its holds at both ends.
Plugin panels can pop out into their own window
- For plugin authors (plugin API):
registerMediaTab(title, panel, category, true)adds Pop out to the panel's right-click menu in the Media Library. The panel moves into a window of its own that floats, resizes, keeps its place and size, and goes back into the Media Library when closed. QUP's hotkeys keep working while it has the focus, and it opens popped again next time if it was out, when the Media Library is docked in the main window; the undocked layout is fixed in 2.34.1. In the Host face, the drawer's plugin list opens the same window. No bundled plugin uses it yet; the Cheer panel will.
Stickers on the singer screen
- Animated stickers from phones play once in a top corner of the singer screen, with the sender's name under it: clear of the ticker, the countdown and the QR (Host TV: beside the picture, under the brand). A quick one holds its last frame so the name can be read, about 3 seconds in all, then fades. It pops in (a quick grow just past its size and back) and fades out. One at a time: the next waits its turn, and the sender is charged only once theirs has started.
- 301 stickers are built in (CC0, the licence beside them). Nothing is downloaded: phones are only offered the set this QUP has.
- The emoji reactions on that side go round the sticker's corner, at the same size.
- Pull in the Cheer panel (or its hotkey) takes a sticker off at once.
- The singer screen's right-click menu has "Stickers From Phones" (on by default). Turned off, phones are told they aren't offered here.
- New setting: "Animations on the singer screen" (Settings > Display > Scroller, on by default; turn it off for slower computers). Off, a sticker shows as one still picture for its time, reactions appear and fade without floating up, the ROAST MODE fire stands still, and the karaoke chat band opens without easing the picture. The ticker, shout-outs, lyrics, countdown and video are unchanged. It takes effect at once.
Shout-outs and "Roast me" on the singer screen
- Shout-outs from phones cross the ticker once, right to left at 2.4 times the ticker's speed (a 160-character one takes about 25 seconds), as "Name - message" with the name in the accent colour. The ticker stops while one crosses and carries on from where it was. One at a time: the next waits its turn, and the sender is charged only once theirs has actually started.
- Host TV (both editions): the shout-out takes the top row of the chat in the bottom bar, with a SHOUT-OUT tag; a long one scrolls within the row. The chat keeps the three rows under it.
- Roast me: while a singer who bought it is singing, a ROAST MODE badge framed by the same animated fire the KJ combo page shows for a first-time singer sits beside their name (Host TV: beside the big name, which is cut short if it would reach the badge; karaoke screen: at the left of the countdown row, with the name). It goes the moment the next song starts.
- Pull in the Cheer panel (or its hotkey) stops a shout-out at once.
- The singer screen's right-click menu has "Shout-Outs From Phones" and "Roast Me Badge" (both on by default). Turned off, phones are told they aren't offered here, so nobody pays for one.
The room's chat on the singer screen
- Chat from phones shows on the singer screen, IRC style:
<Name> message, the karaoke name in the accent colour and the message in white, with a small "translated from ..." tag when it was translated. A line QUP Cloud rewrote more kindly carries no tag on the room's screen; the Cheer panel still marks it "sweetened" for the KJ. The newest line is at the bottom and every line leaves after 15 seconds. A long message wraps; an older one that only partly fits is cut with "...". - Karaoke screen: while the chat has lines, the picture shrinks smoothly (about 72 % with 4 lines) so the chat sits in a band below it, above the countdown and beside the QR, and never covers the lyrics. When the chat has been empty for a few seconds the picture eases back to full size.
- Host TV (both editions): the chat sits in the bottom bar between "Up next" and "Scan to sing"; the picture keeps its full size. A very long next name is cut with "..." while the chat is up.
- The singer screen's right-click menu has "Chat From Phones" (on by default; off, the cloud stops sending chat to this screen) and "Chat Lines On Screen" (2, 3 or 4; 4 by default).
- Pulling a line in the Cheer panel takes it off the screen at once.
Emoji reactions from phones on the singer screen
- Singers' phones can send emoji reactions to the singer screen (a clap, heart, fire, party popper, star-struck, music notes, thumbs up or mic, in Microsoft's Fluent Emoji). Each one floats up the side of the screen for about two and a half seconds, and when the room sends the same one several times it shows once with "x5". They stay at the sides: never over the middle of the picture, the countdown or the QR. At most 12 are on screen at once.
- The singer screen's right-click menu has "Reactions From Phones" (on by default). Turned off, none are shown and phones are told reactions aren't open here, so nobody pays for one.
- The Playlist's right-click menu has "No Reactions On This Song" for a singer who doesn't want them; phones are told before anyone pays.
- QUP tells the cloud whether it can show reactions, so the phones offer them only at venues on this version or later, with the switch on. A reaction that couldn't be shown is reported back and refunded by the cloud.
Forgot PIN on the singer's phone page (ready for the cloud)
- QUP can now apply a PIN reset from QUP Cloud. When a singer who has forgotten their PIN proves who they are on the singer's phone page (by an email code or a passkey) and picks a new one, the new PIN reaches the venue without the old one and works at the kiosk straight away. QUP tells the cloud it can do this, so the cloud offers "Forgot PIN?" only at venues on this version or later; older venues keep "Ask your KJ". The PIN is never written to the log.
Allow typing the venue code (off by default)
- Preferences > Kiosk Security > "Allow typing the venue code" lets a singer join by typing the short code shown under the QR instead of scanning it, for a singer who can't scan. It is off by default, and off for existing venues after the upgrade: a typed code can be texted to someone who isn't at the venue.
- While it is off, the Scan-to-sing card shows only the QR, and a typed code is refused the same way as a wrong one.
Windows that hang off the screen come back onto it
- The first launch fits the screen at 125 % and 150 %. The classic layout is drawn for a 1080p screen at 100 %; at 125 % the Media Library opened with its bottom 118 px below the screen, at 150 % 358 px. The whole layout now moves up (and left, at 150 %) only as far as it must, and the Media Library and the Playlist are cut back to the screen's edge, so every window is on screen and none overlaps another. Windows > Reset layout does the same.
- A window that fits the screen but hangs off an edge comes back onto it. A restored window that fits its screen but runs past an edge is moved back onto that screen, not shrunk, by the least it takes. It stays on its own monitor, and a window spread across two monitors is left where it is.
Phone cards: a singer's phone is their card at the bar
(The bar side, scanning and Recall, arrives in the next QUP Bar for Android update.)
- QUP Bar can scan a singer's phone to add credits (Database mode). A singer signed in on the QUP app or the web singer page shows a QR code that changes every 30 seconds; QUP Bar scans it and shows the singer's name, photo (when they have one and allow it), balance and status before the bartender adds an amount. The bartender PIN applies as for a balance edit. The code works once, only at this venue, and needs no internet to check: the key reached QUP when the phone signed in. A bad scan says why: expired, already used, not a QUP card, the phone's clock is N minutes off, banned, or phone cards off.
- Preferences > Kiosk Security > "Phone cards", on by default.
- QUP Bar: "Recall last transaction". A terminal can recall its last top-up or balance change (for 12 hours, the same night) and take off or add to it: a mistaken $20 for $5 is corrected in two taps and a confirm. Only the newest can be corrected, never below $0 or over $500, with the bartender PIN when the venue has one; the night's "Bar added" figures net the correction. Older changes are the KJ's, in the singer editor.
- Every change to a credit balance is logged in data/logs/credits-YYYY-MM.log (the bar's phone cards and balance edits, the kiosk's add credits, the KJ's singer editor): when, which terminal, the bartender PIN, the singer, before and after. Kept 12 months. The bar's night figures add what each terminal added, and how much by phone card.
- Needs QUP Cloud with the phone-card relay.
Kiosk only: song requests from phones can be turned off
- Preferences > Kiosk Security > "Song requests from phones": Allowed (default) / Kiosk only. An operator option, never forced on; a venue that never sets it keeps taking requests from phones exactly as before.
- Kiosk only: singers' phones (the QUP app and the web singer page) still show the queue, and say "This venue takes requests at the kiosk."; Find a Song and Change Song are hidden. QUP Cloud refuses a request from a phone, and QUP refuses one already on its way when the switch changed. Bribes still work on songs already in the queue. Needs QUP Cloud migration 028.
Fixes
- A singer with a missing date no longer stops QUP from starting. A singer row without its last card scan or name change date (one written by an old seed or by hand) made start-up stop after the singer screen opened. Such a date now reads as "never", the row is noted in the log by its number, and the singer is found by name, card and phone again. The singer list's "last song queued" column now shows that date, not the last card scan.
QUP Karaoke Engine — v2.33.0
Unlock a singer's phone sign-in
- After 10 wrong PINs on a phone, the singer's name is locked at the venue for up to 15 minutes, and the singer's phone page now says "Go see the KJ to unlock your account".
- The KJ can unlock it at once: right-click the singer in the Singer
Database, the Rotation or the Host face's rotation list and choose "Unlock
phone sign-in". QUP asks first, then says "Unlocked
's phone sign-in.", " 's phone sign-in wasn't locked." or "Couldn't reach the cloud. Try again in a moment." - The item is there only when the venue is linked to QUP Cloud. The venue kiosk's own card + PIN check, and its lockout, are unchanged.
Dialogs follow the skin
- With a skin chosen, QUP's dialogs now wear it. Message boxes, the file choosers and dialogs such as "Plugins moved" or the update notice kept the default EAD Ovation colours (blue text on black) under any skin, even a light one. They now take the skin's colours, and their text is made readable on them where a skin's own colours would not be.
- Preferences and About keep their own looks, as before, so a skin can never make the place you change it hard to read. With no skin or under High Contrast nothing changes.
Guide vocal for blind and low-vision singers
- Preferences > Outputs > Guide Vocal, for songs made with the lead vocal
alone on the right channel and the music on the left. Both settings are off
until the KJ chooses them, and they are saved in their own file.
- Main speakers: "Left channel on both speakers (music only)": the room hears the music without the guide. "Stereo" plays the song as it is.
- Guide vocal device: a second output (headphones, an in-ear monitor) that plays the right channel, the vocal, in both ears.
- With Stereo and no guide device, the karaoke sound is exactly as before.
- It applies to songs QUP plays itself (MP3+CDG, MP3+LRC, video), not to songs a plugin plays (KaraFun, MIDI).
Sound pads: a stop bar on each pad, and Duck Music
- A red bar above each sound pad stops it, for a pad pressed by mistake. The
bar turns red while its pad plays; a click on it silences that pad only. From
the keyboard, Escape on a focused pad stops it; a screen reader hears "Stop
" and the pad has a "stop" action. Action pads have no stop. - "Duck Music" at the start of the pad row: while a pad plays, the karaoke and the break music dip under it (the karaoke used to play on at full level). Untick it and nothing dips. It is the same setting as the Sound Pads panel's "Dip the karaoke and break music while a pad plays", kept in the plugin's settings file. Songs a plugin plays (KaraFun, MIDI) dip too.
- For plugin authors (plugin API):
PluginContext.setKaraokeDuckducks the karaoke music, assetFillerDuckducks the break music. A playback source'sSourcePlayer.setCrossfadeGainnow gets the crossfade times that duck, sent again whenever either moves. - The SOUND PADS row on the Host face is 14 px taller to make room for the bars.
- This is Sound Pads 1.1.0.
Manual crossfade: the crossfader is the mix from the first song
- The break music no longer stays up under the first karaoke song when the crossfade is on Manual. After a start, the crossfader showed its saved spot (say, the karaoke side), but the karaoke and the break music both played at full until the KJ nudged the crossfader. With a radio station as the break music, it played on under the singer. The saved position now applies from the start.
- Choosing Manual (the Manual button, or turning off "Auto-fade between singers" on the Host face) puts the crossfader back on the KJ's last manual spot and applies it at once. Before, nothing changed until it was moved.
- The automatic modes (Silence, No karaoke) are unchanged.
Dialogs open on the screen, and the Outputs notes wrap
- A dialog no longer opens partly off the screen. At 150 % on a 1080p screen, Preferences opened with its lower part below the taskbar, out of reach. Any dialog that opens partly off the screen is now moved onto the screen it is mostly on, and shrunk only if it is bigger than that screen. A dialog on a second monitor, or across two, is left where it is; so are floating panes, which keep their own rules.
- The long notes in Preferences > Input/Outputs wrap to the window's width instead of being cut off mid-sentence.
The main window fits the screen, and its edges resize
- The first launch no longer opens bigger than the screen. The Host face's first window is laid out for a 1920x1080 screen; on a smaller one, or one at 125-150 % scaling, it ran off the bottom and right. A restored or first-run window that is bigger than its screen and hangs off the desktop is now shrunk to the screen's usable area (less the taskbar) and moved onto it. A window spread across two monitors on purpose is left alone.
- Dragging a window's top or bottom edge resizes it. It sometimes moved the window instead: the resize arrow showed over the top of the title bar, but a press there went to the title bar. Every edge and corner now has its own resize area, and the arrow shows only where a drag resizes.
Internet Radio: the Sync button says what it is doing
- Internet Radio 1.1.1: "Sync Station Directory Now" shows its progress in its own window ("Syncing… 5000 stations", then the result), and the button is off while a sync runs. A click while a sync is already running (the first-run sync, for example) now says so.
- A plugin's notification is a short message near the bottom of QUP's window, also said to a screen reader. It used to replace the karaoke song's title.
- The plugin catalogue offers Internet Radio 1.1.1 only to QUP 2.33.0 and later: on older versions its messages would still replace the song's title.
Polish from the 2.31.0 checks
- The Host top bar's "Host" tab reads under every skin pack. Under Graphite Deck (and other dark packs) its text went pale on the amber tab: the skin measured the text against the dark bar behind the tab, not the tab's own amber. Any label that paints its own background is now measured on it.
- Escape closes Preferences and the "Plugins moved" notice, as their close buttons do (Preferences still saves as it closes; Escape on the notice is Later). A hotkey field being set keeps Escape to cancel the new key.
- "Open kcombo" says what it opens: screen readers now hear "Open kcombo, the singer queue page", and its tooltip adds that it opens in the web browser.
- Text size 150 %, the last clips: the Host rotation list fits its pane, so a long song title shortens instead of pushing each singer's wait, key and NEXT out of sight; the empty deck's "DECK A — empty" starts after the deck letter instead of under it; a table heading wider than its column ends in "..." instead of being cut at both ends; the Player's section titles get the height their larger text needs.
KaraFun: the Integral Catalog, for venues that hold the rights
- KaraFun plugin 0.4.0 adds an "Integral Catalog" box, off by default. It is about 2,600 extra songs KaraFun lists but doesn't license for public performance. Ticking it is the KJ's agreement: "By checking this box you agree you have obtained the rights to use these songs", asked once more before it takes. It needs the KaraFun desktop app (on the web player the box says so and stays off), and KaraFun's own "Use the Integral Catalog" option on the KJ's KaraFun account: QUP reads that option when KaraFun starts under it and warns under the box while it is off.
- The songs are listed only while both are on, badged "KaraFun Integral" in the library (the source filter offers them on their own) and on singers' phones. QUP Cloud keeps the list (updated daily); QUP fetches it when it changes. They never go into the shared KaraFun list other venues search.
- A song KaraFun won't play is refused before KaraFun is asked: an Integral song is looked up in KaraFun first, and one KaraFun lists as restricted for the account fails into the red entry with Replace and the fix ("turn on 'Use the Integral Catalog' in your KaraFun account"); a singer requesting one from a phone hears it isn't available at this venue right now.
- Any KaraFun song KaraFun refuses at play time is caught: its "The song you are trying to play is not available" box (QUP closes it), or, for a song QUP loads, KaraFun stopping on it with "Something went wrong. (code E100-605)" (QUP looks it up after 2 s instead of waiting out the load). The entry fails with the same fix, and QUP remembers the song so it is refused at once next time.
- The No-fly list (KaraFun plugin 0.4.0):
- Reports: every song KaraFun refuses at play time is reported to QUP Cloud. The report is the song, how it was refused, KaraFun's version and the Integral option; no personal data.
- The list: QUP downloads the shared No-fly list daily and refuses those songs before KaraFun is asked.
- Greying: songs refused here or on the list are greyed in the library, with the reason.
- Phones: listed songs no longer show up in singers' search.
- The verifier: a weekly tool,
tools/nofly-verifier, rechecks the list read-only on one machine with KaraFun signed in.
- The singer is told: when KaraFun refuses their song at play time, the QUP app and the singer's web page say "Sorry,
couldn't be played here. Pick another song to keep your place.", with Change Song. They also get one push notification. The entry stays failed across a QUP restart, so it isn't tried again. - For plugin authors (plugin API): a song source's song can carry its own
badge (
SourceSong.EXTRA_BADGE), a playback source can refuse a song at queue time (PlaybackSourcePlugin.unavailableReason), and a plugin can fetch a list QUP Cloud keeps for its source (PluginContext.cloudSourceList).
QUP Karaoke Engine — v2.32.0
A venue removed from QUP Cloud: QUP says so, and comes back by itself
- When QUP Cloud support archives a venue, QUP stops its cloud connection at the first refusal and shows the KJ one notice: phone requests and the join QR are off, and karaoke keeps working. Preferences > Online Service says "Removed from QUP Cloud". Before, a QUP started while its venue was archived kept retrying (and logging) every 1.5 seconds.
- When the venue is restored, QUP reconnects within 15 minutes without a restart, and says so.
Mac: closed windows come back from the menu bar, and right-click works everywhere
- A Window menu in the Mac menu bar: Dock / Undock Windows, Show All Windows, a tick per window and Reset layout. Before, a closed window could only come back through a right-click menu (or the QUP icon in the menu bar).
- The app menu says "QUP Karaoke", not "Main". Its About, Settings (Cmd+,) and Quit (Cmd+Q) are QUP's own: Quit asks first and saves, as Exit does.
- Ctrl+click on a window's title strip opens its menu on a Mac. It used to start a window drag that closed the menu straight away.
- Right-click on any empty part of a window (Karaoke, Filler, the EQs, Mix, the docked main window's title bar and edges) opens the window menu, not only on the thin title strip.
QUP Karaoke Engine — v2.31.0
Stop, Play and Vault downloads say what happens
- A Vault song still downloading says so on its row ("Downloading 42%... plays when ready"). Pressing play on it now starts it when the download finishes, instead of doing nothing. Stop cancels that.
- After Stop, QUP says what Play and Next do. Play starts the stopped singer's song again (as it always has); Next now moves on to the next singer, and the stopped singer sings right after. Before, Next after a Stop replayed the same singer too.
- These messages are spoken by screen readers and kept in the Announcements log (Ctrl+Shift+L).
KaraFun app: its green screen, over QUP's own background
- "Enable Green Screen" in the KaraFun plugin's settings turns on KaraFun's own green screen (applied at once, no restart). QUP then shows KaraFun's lyrics over its own background or visuals instead of KaraFun's. Clear it for KaraFun's visuals. KaraFun app only. Needs KaraFun plugin 0.3.0: Plugins offers it as an update.
- QUP now shows what KaraFun sends to a projector (its Dual-Screen), not the small lyrics preview in KaraFun's window. That's why turning on KaraFun's green screen made no difference before.
- KaraFun is never left off-screen. If QUP closed without putting KaraFun's window back, KaraFun opened invisible. QUP now moves it back onto the screen the next time it starts KaraFun, and puts KaraFun's second screen back as you had it.
Lyrics in .txt files and zips, paste on a Mac, tempo in percent
- Lyrics in a .txt file. An LRC lyrics file saved as .txt (lines that start with a time, like "[00:12.50]") now counts as lyrics. A WAV or MP3 with one beside it imports as karaoke, not Break music, and plays with its lyrics. A .txt without times still doesn't count.
- LRC lyrics inside a zip. A zip holding an MP3, WAV or OGG and an .lrc (or an LRC .txt) now plays with its lyrics, even when the lyrics file has a different name from the song.
- Imports say why a song went to Break music. When dropped files have no lyrics, the import now says so ("12 files had no .cdg/.lrc lyrics, so they were added as Break music.") and lists each file with its reason.
- Paste works on a Mac. Cmd+C, Cmd+V, Cmd+X and Cmd+A now work in every text box, the Vault sign-in too. Right-clicking a text box offers Cut, Copy, Paste and Select All (only Paste in a password box).
- Tempo shows as a percent ("+2%", "0%"). Each step is 1% faster or slower, and screen readers say "Tempo +2%".
- Fixed: songs played 1% fast at tempo 0 after the key was changed, and a tempo of +1% was ignored when set mid-song.
KaraFun songs: break music and "add to queue"
- Break music now fades out under KaraFun songs in the No karaoke and Silence crossfade modes, as it does under QUP's own songs. Before, it could keep playing at full volume for the whole KaraFun song.
- KaraFun songs play when KaraFun is set to "add to queue". KaraFun could stop at its start screen; QUP now starts the song itself, and tells you to set KaraFun to "Play now" if it still can't.
KaraFun songs in phone and kiosk search
- At venues using the KaraFun app, patrons now find KaraFun's catalogue in the song search on their phones and the kiosk, under "From KaraFun", and can queue those songs like any other. QUP keeps the catalogue up to date in the background. It's switched on per venue.
Every song at the same loudness (AGC)
- AGC levels each karaoke song as it starts, so a quiet track and a loud one come out about the same. QUP measures a song's loudness while it draws its waveform, and the next song in the Playlist ahead of time, then sets one fixed level for the whole song (never more than 12 dB either way, and never louder than the song can go without clipping). It never changes the level mid-song, and it remembers each song's measurement.
- The first time a song plays it plays as it always did; from then on it is levelled. KaraFun songs are not levelled.
- Turn it on or off with the AGC chip by the karaoke player's EQ button (it shows the level it set, "AGC -3.7 dB"), in Preferences > Input/Outputs > Levelling, or with a hotkey you assign in Preferences > Hotkeys ("AGC on / off"). It is off unless you turn it on.
Screen readers: tours, row state, the hotkey field
- Guided tours speak. Each step's title and text go to the screen reader, with the keys that stand in for its buttons: Ctrl+Enter for the step's main button (Next, Done) and Escape to end the tour. Before, a tour's callout was only painted, so a screen reader user heard nothing.
- A Playlist or library row says its state: "played", "failed to load" or "marked bad" is read with the row, with the longer explanation as its description. Before, these were shown only by the text colour.
- The hotkey capture field (Preferences > Hotkeys) lets Tab go. Tab and Shift+Tab move on instead of being captured, so the keyboard is no longer stuck there; Escape still cancels and Ctrl+Tab can still be bound.
Orca can read QUP on Linux
- Orca, the Linux screen reader, can now read QUP when the java-atk-wrapper package is installed (Debian and Ubuntu: libatk-wrapper-java and libatk-wrapper-java-jni) and Orca or the desktop's accessibility is on. Before, it could not reach QUP at all. Without the package, QUP starts exactly as before.
- Preferences > Accessibility (new) turns it off or back on. If QUP ever stops during a start with it on, the next start leaves it off and says so; tick it there to try again.
Bigger text follows Windows' text size
- Windows' "Make text bigger" (Settings > Accessibility > Text size) now really reaches QUP. Before, QUP's own look kept its text at the normal size, so most of QUP did not grow at all. Now the menus, lists, tables, tabs and buttons grow, and so does the text QUP's panels style themselves: the Host face's deck titles, buttons, chips, Sound Pads and library.
- Rows and boxes that hold text grow with it, so nothing is cut off: the Host face's decks, library and sidebar, the Status line, the Playlist and its column headings. At a large size the karaoke deck's AGC and volume move to a second line, and Deck B's heading reads "BREAK MUSIC" if "B - BREAK MUSIC" will not fit.
- The singer screen and the DJ visuals keep the size set for the TV. Symbol buttons (stop, restart, the key and tempo steps), the logo and the window title strip keep their size too.
- Fixed: Deck A's countdown in the Host face was cut off to "-" on most screens. It now shows in full.
Tab reaches everything (keyboard and screen readers)
- On a Mac, Tab no longer stops in the middle of the Host face. After the karaoke deck's "Tempo up" it went into the live preview and stayed there, so the crossfader, the break music, the pads, the library and the rotation could not be reached from the keyboard. The preview is no longer a Tab stop (on any computer).
- F6 goes straight to a pane's first control (it used to land on the pane itself, so one more Tab was needed), and it skips the Status and CDG Preview panes, which have nothing to operate. Ctrl+Shift+T still reads the status line.
- Tab moves on from the Playlist and the Media Library's song lists instead of staying in them; the arrow keys still move between rows.
- No more invisible stops: Tab used to land three times on hidden scroll bar buttons in the Playlist.
- After "Welcome to QUP", focus goes to the Playlist (Up next), not to the Status bar.
Text you can read on every skin
- The library's song rows and the "room for N more singers" status are readable on every bundled skin. On most skins they were too faint (some under 2:1, the status green on beige 1.2:1). QUP now keeps each skin's colours and only lightens or darkens text that would be hard to read, to at least 4.5:1: the library, the Playlist, played and missing-file rows, and the status line.
Screen readers and the keyboard, more of QUP
- A yellow ring shows where the keyboard focus is while you use the keyboard (most controls showed none); it goes away when you click.
- Ctrl+Shift+T says what is on and the time left ("Now singing: Sam, Auld Lang Syne. 2 minutes 31 seconds left").
- The time, the now-singing display, the meters and the song position can be read by a screen reader; the song position, the cut threshold and the knobs can be moved with the arrow keys.
- In High Contrast, title bars and column headings read clearly: the windows' and panes' title bars and the lists' column headings are solid black with yellow titles. They were yellow on light grey.
- Windows High Contrast now switches QUP to black, white and yellow, and Windows' text size setting enlarges QUP's text.
- High Contrast wins over a skin pack. With a bitmap skin chosen, its own colours and images used to cover the high-contrast colours in the operator windows. Now the skin waits: QUP says so once, your skin choice is kept, and the skin comes back when High Contrast is off.
Screen readers hear what happens on stage
- QUP now tells a screen reader when a singer starts ("Now singing: Sam, Auld Lang Syne"), when a song ends, when a request arrives from a phone or the kiosk, and anything it shows as a toast ("Not played: ...", Vault downloads). Before, these were only on screen. Requests you enter at the desk are not announced.
- Ctrl+Shift+L opens the Announcements list (the night's messages, newest selected), and Ctrl+Shift+R says the last one again. Both can be changed in Preferences > Hotkeys.
Removing a singer keeps their history
- Dequeue All Songs and Remove from Rotation now take only the singer's waiting songs. Songs they have already sung stay on the History tab, and the song on stage is never removed by these (stop it first if you mean to). Before, both also deleted the singer's sung songs from tonight's history. The same goes for the Rotation pane's Remove From Rotation. The questions now say so.
Screen readers name QUP's controls
- Icon buttons, sliders, search fields and lists now have names a screen reader can say. Before, 60 of 140 controls on the main windows had none and NVDA guessed from tooltips; now every one a KJ can Tab to is named (the play / stop glyph buttons, the volume and balance sliders, "Search", "Up next", "Rotation", "Library songs", the Media Library sections). A label in front of a field is now tied to it, so the field says what it is for.
- The Mix window's steps say their row ("Pitch +2", "Tempo -1%", "CDG sync 0", not "+2"), and the title bars' buttons say Minimize, Maximize and Close instead of their symbols.
Bar terminal 2.31.0
Update it together with the engine (Download page). It still works with engine 2.22.0 or newer.
- The bar terminal works from the keyboard and with a screen reader. Tab reaches every button and field, and each one says what it is; Enter presses the focused button, Alt+S saves and Alt+C cancels. After a card swipe, the account is read out. A save's result stays on screen, in readable colours, until the next card.
- The card reader no longer steals the keyboard. A swipe is told apart from typing by its speed, so you can type in the fields while the terminal waits for a card.
- A slow card reader can be set up. If a reader's swipe is not picked up,
CARD_READER_GAP_MSin the terminal's config.properties allows more time between its keys (README: "A slow card reader"). Re-pairing keeps the setting.
QUP Karaoke Engine — v2.30.0
Adding a media folder asks what is in it
- Preferences › Media › Add Folder now asks whether the folder holds karaoke songs or background music (filler). It looks inside first: a folder with audio but no CD+G, lyric or karaoke video files comes up as background music. Before, every folder went in as karaoke unless you found and ticked the Filler column.
- Background music titles: pick how the file names read (Artist - Title, Title - Artist, with a track number, or your own format, the same as the karaoke song name format) and see a preview of the first few files before you add the folder. "Title format..." changes it later. Folders you already have keep their titles until you choose a format.
Joining a venue: a short code beside the QR
- Every venue QR now shows a 6-character code (for example K7Q 4MX) and where to type it, for anyone who can't scan: under the QR on the projector and kcombo, and on /karaoke/qr. Screen readers hear it spelled out.
- A new QR reaches the screen within seconds of the old one being used, not up to two minutes later.
- Privacy fix: the QR pictures on /karaoke/qr and kcombo were drawn by an outside web service, which received the venue's join link. QUP now draws them itself.
First launch: the evaluation reminder no longer locks QUP
- The reminder on an unregistered QUP counts down by itself and closes with one click or Escape. It no longer sits always-on-top over a minimized QUP, which could leave a first-time user with no way in.
- Importing a key: paste it into the box and press Import. An empty clipboard is no longer a dead end, errors are explained in the box, and a key that works closes the reminder.
- The update notice's download button now downloads the installer for your computer.
Moving around QUP from the keyboard
- Hotkeys now work in every QUP window, including Status, Mix, the EQs, Filler and CDG Preview when they float. Before, no hotkey (not even Play or Next) did anything while one of those windows had the focus. They still do nothing while you are typing in a text box there, or while a dialog that needs an answer is open.
- F6 moves to the next window, and Shift+F6 to the previous one. It goes through every QUP window that is showing (Karaoke, Status, Mix, the EQs, Playlist, Media Library and the rest) and wraps around, docked or not. Before, Tab stayed inside one window, so the keyboard alone could not get from the library to the rotation.
- Ctrl+1 goes to the library's song list, Ctrl+2 to Up next, Ctrl+3 to the rotation and Ctrl+4 to the karaoke player. All six keys can be changed in Preferences > Hotkeys > Windows. If you had already set F6 or Ctrl+1..4 to something else, your key is kept.
- QUP's main window and the singer screen now have names. Screen readers and Alt+Tab used to show them as untitled.
- The license box's buttons are easier to read in the dark skin, and the button with keyboard focus is outlined.
Filler: 24-bit WAV files play, and a file that can't play no longer loops
- Filler music in 24-bit WAV (for example 48 kHz / 24-bit) now plays. On Windows such files never started: the filler jumped from file to file, many times a second, and nothing was heard. The filler now plays them the way the karaoke player always has.
- A filler file that can't be played is skipped, and if many in a row fail, the filler stops and says so: "Filler stopped: 12 songs couldn't be played. They may be in a format QUP can't play yet." Turning the filler off and on again tries them once more.
Kiosk 2.30.0
Update it together with the engine (Download page). The bar terminal is unchanged (2.29.0).
- The kiosk's idle screen now shows the venue's join code, for patrons who can't scan the QR: "Blind or low-vision? Scan the QR on the TV, or enter code K7Q 4MX on your phone, in the QUP app or at qupkaraoke.com/k." It is the same code the engine shows under the QR on the projector and kcombo. With an engine older than 2.30.0, or with cloud features off, the line is not shown.
QUP Karaoke Engine — v2.29.0
MP3+G lyrics no longer black on black
- CD+G songs that use only the first eight colours now show them. On those discs the lyrics, the colour wipe and the title card stayed black, often for the whole song. The colours were read but not shown until the disc changed its other eight, which these discs never do. Since 2.1.2.
Screen readers: QUP starts again after NVDA has been used
- QUP now starts on a Windows PC where NVDA has ever run. NVDA leaves a
settings file in your user folder (
.accessibility.properties) that asks Java programs to load the Java Access Bridge, and the file stays after NVDA is closed. QUP's built-in Java did not include the Access Bridge, so QUP stopped before its first window appeared, with nothing on screen to say why. QUP now includes it: QUP starts, and NVDA can read its standard controls. - On macOS and Linux, a copied
.accessibility.propertiesfile can no longer stop QUP from starting. VoiceOver is not affected.
Kiosk timeout 0 now means "never"
- Setting the kiosk timeout to 0 now turns it off on kiosks that know about it: the next desktop kiosk and Android kiosk 1.0.1. The countdown disappears, and a patron's screen stays put until they finish. Before, 0 quietly became 30 seconds. (Issue #6.)
- Older kiosks still get 30 seconds when the setting is 0, as they always have, so nothing changes for them until they're updated.
Kiosk Security: headings you can see
- Preferences › Display › Kiosk Security showed its section headings and notes ("Enrolled kiosks", "Kiosk devices", the bar terminal and bartender PIN notes) at the far right of the pane, off screen unless you scrolled sideways. A normal-sized window showed a blank gap above the Kiosk devices table. They now start at the left, where you read them.
Kiosk 2.29.0 and bar terminal 2.29.0
Update these together with the engine (Download page).
- Kiosk: a kiosk timeout of 0 now means no timeout, as the setting says (with engine 2.29.0; an older engine keeps 30 seconds). If the engine's certificate changes while someone is using the kiosk, it now says "This is not the venue's engine" instead of "ERROR WITH SERVER". The kiosk now starts on a PC where the NVDA screen reader has been used; before, it closed before its first window.
- Bar terminal: now starts on a PC where the NVDA screen reader has been used.
QUP Karaoke Engine — v2.28.0
Cards and sign-up at the kiosk
- A card that asked to sign up again now works. A new card swiped at the kiosk and then signed up used to end up with a second, nameless account, so the card kept asking for a name, and credit loaded on it at the bar went to the nameless account. Signing up now completes the card's own account.
- Duplicate card accounts are merged once, automatically, with a backup. The first start of 2.28.0 does it, after backing up your database.
- A card can't be given to a second account from the kiosk's sign-up or profile screens; the kiosk says "That card is already in use. Ask the KJ."
Kiosk money settings survive a restart
- "New card starting credit" is kept. It was saved but never read back, so after a restart new cards started at $0 and the setting was then wiped.
- "Cost to sing" applies from the start. Until the Kiosk page was saved again, the kiosk charged the built-in $1.00 instead of your price.
Settings that were quietly overwritten
- Your audio devices are kept (Preferences › Output). Closing QUP while a device was unplugged, or before the device list had loaded, used to reset mains, phones and ASIO to the defaults. The ASIO device now also survives a restart.
- Your crossfader position is kept in Media Player and Simple Player modes and in the automatic crossfade modes. It used to be saved as 0 or 100 at every exit.
- The five messages in Send Message are kept at the next save.
- Your media folders are kept if the settings file can't be read: before, one bad read emptied the folder list and the next save wrote it out empty. An unreadable file is now set aside, not replaced.
- A one-night port clash no longer becomes your setting. When the web or secure port was busy and QUP used the next one, that port was saved as your setting.
- The video window opens where you left it, at its size, and fullscreen again on the projector if it was fullscreen and that screen is still attached.
Kiosk Security: paired kiosks, and buying songs
This lays the groundwork for the upcoming Android kiosk. Desktop kiosks work exactly as before, with the kiosk code.
- Kiosk Security › Kiosk devices lists every paired kiosk. Pair a kiosk… shows a QR code and a short one-time code (it works once and expires after ten minutes); Forget this kiosk cuts off just that one and frees its row. Each paired kiosk has a code of its own.
- New code… now leaves paired kiosks working. Replacing the kiosk code still stops every kiosk that was set up with the code, including ones signed in right now. Paired kiosks have their own credential, so they keep working; forget one to stop it.
- Two paired kiosks behind one router now always get their own rows.
- Song purchases (SongShop): desktop kiosks now get the venue's current song store catalog, and the engine can search the store for the upcoming Android kiosk. Patrons are only charged once a bought song has arrived.
Fixes
- Stop on an idle deck no longer puts the song that just finished back in the queue. Stopping a song partway through still puts it back, as before.
- When the secure (HTTPS) server can't start, the log now says it is off, and why, instead of announcing a port nothing was listening on. A connection that closes without a request no longer upsets the server.
- The Mac app no longer modifies its own files. On its first run it copied two files into its own app bundle, which broke the app's signature check (macOS could then refuse to open it). It no longer writes anything into its install, on any platform; on Linux AppImage the scrolling message also gets its proper font back.
Plugins
- CD+G Disc Ripper and Karaoke Maker install again on Windows and Linux. The ffmpeg download they need had moved; it now comes from QUP's own copy, checked before it's installed. This was fixed in the plugin catalog on 19 October, so it already works with 2.27.0.
Mac: the engine now has its own security certificate
- On a Mac, QUP was using the same built-in certificate as every other QUP install, because the tool it ran to make the venue's own certificate never ran inside the Mac app. A kiosk or bar terminal that checks the engine's certificate was therefore checking something every QUP shares. QUP now makes the certificate itself, on every platform.
- Mac venues: after this update, paired kiosks and bar terminals see a new
certificate and must be paired again (Kiosk Security › Pair a kiosk… /
Pair a bar terminal…). They refuse the new certificate rather than
quietly accepting it; that is what makes the check worth having.
What each one does:
- Desktop kiosk: update it to 2.28.0 first, so it explains the change
and lets you confirm the new fingerprint. An older desktop kiosk only
shows "No Server Found"; to recover one, delete
data\config\engine-pin.propertiesin the kiosk folder and restart it. - Desktop bar: restart it if it was running during the update, then choose Forget the saved engine and set up again and confirm the new fingerprint.
- QUP Bar (Android): tap Set up again and confirm the new fingerprint.
- Android kiosk: staff corner › Set up again.
- Desktop kiosk: update it to 2.28.0 first, so it explains the change
and lets you confirm the new fingerprint. An older desktop kiosk only
shows "No Server Found"; to recover one, delete
- Windows and Linux: nothing changes. The certificate you already have is kept exactly, so nothing needs pairing again.
- If QUP ever has to fall back to the built-in certificate, it says so in the log and on the Kiosk Security certificate row.
Kiosk 2.28.0 and bar terminal 2.28.0
Update these together with the engine (Download page).
- Kiosk: a changed engine certificate is explained, and the KJ confirms the new
fingerprint against Kiosk Security, instead of the kiosk asking for the server
address over and over. A banked bill now shows on the patron's balance straight
away. A song the venue already owns is queued instead of showing an error, and a
store download no longer goes wrong. A server address typed without a port uses
ENABLE_PHOTOS=falsein a kiosk's own settings turns photos off for that kiosk (for a PC with no camera), and the engine no longer overrides it.
- Bar terminal: if the engine's certificate changes while the bar is running, it now says so and lets you confirm the new fingerprint, instead of freezing.
QUP Karaoke Engine — v2.27.0
The projector goes idle when nothing is playing
- After the last song ends, or after Stop, the projector and the Karaoke window stop showing that song. They used to keep scrolling it as "now singing" and keep its time ("-3:45") until something new was queued. Now the time reads 0:00 and the projector shows an idle message. The web playlist page agrees. (Forum report; issue #10.)
- You can write your own idle message. Preferences › Display › Scroller has a new Idle Message box. By default it says "Nobody is singing, Queue up a song!". Leave it blank to keep the default. It replaces the old "Initializing" text.
Bar terminal
This release lays the groundwork for the upcoming Android bar terminal. Your desktop bar terminal works exactly as before.
- Kiosk Security › Bar terminals lists every paired terminal. Forget this terminal cuts off just that one.
- Pair a bar terminal… shows a QR code and a short one-time code, so a new terminal never needs the long bar code typed in. The code works once and expires after ten minutes.
- "Bar added" counts only money added. Lowering a card's balance at the bar still saves the new balance, but it no longer takes money off the night's "Bar added" total.
Security
- Replacing the kiosk or bar code now signs out everything that used the old code. Kiosks and bar terminals need the new code after you replace it, as you'd expect. Forgetting a kiosk signs that kiosk out.
- Wrong PINs and wrong codes are counted more strictly, per device and per network address.
Fixes
- Running a second copy of QUP no longer steals the first one's kiosks. When the secure (HTTPS) port was already taken, the second copy announced that port anyway, so kiosks and bar terminals scanning its QR code reached the other copy. It now moves to the next free port, as the web port always did. (Issue #11.)
Kiosk 2.27.0 and Bar Terminal 2.27.0
Both are on the download page.
- Kiosk 2.27.0 works with QUP 2.25.0 and newer. A kiosk older than 2.25.0 stops at "Failed to initialize database. Exiting" against QUP 2.25 or later; this is the update it needs.
- Going back to the start screen signs the singer out. The next person at the kiosk is no longer treated as the last singer (their balance and favourites) until they sign in.
- Card + PIN sign-in shows the singer's real balance, so a singer with credit can queue. It used to show $0.
- Browse-only kiosks: touching the start screen goes straight to search instead of asking for a name.
- The desktop bar terminal supports the bartender PIN. If you set one in Kiosk Security, the terminal asks for it before changing a balance, deleting a singer, changing closing time or restarting the night. The PIN needs QUP 2.27.0; against an older QUP the terminal works as before.
QUP Karaoke Engine — v2.26.1
Security
Everyone should update. Nothing changes in how you run your show.
- QUP no longer makes an outbound remote-relay connection at startup. The
old relay code was never used for anything and has been removed. An
undocumented
/ms:command-line option that went with it is gone too; it did nothing. - Five old kiosk commands that answered without any sign-in are now refused. Kiosks from 2.22.0 on, the bar terminal and the Q-Up phone app already use the secured connection, so nothing changes for them. Kiosks older than 2.25.0 already needed updating for 2.25.0.
Fixes
- The playlist, rotation and singer lists no longer misdraw while kiosks and the bar terminal are busy. Requests from them could update those lists at the wrong moment, giving a briefly wrong row and drawing errors in the error log.
- Saving a genre works on MP3s made by ffmpeg, including the built-in Sound Pads. The save used to fail silently. Fixed in Metadata Editor (included with QUP) and in Genre Tagger 1.0.2 (update it from the Plugin Browser).
- Plugin Browser: a switched-off plugin now says "Off in Preferences › Plugins", which is where you turn it back on. It used to point at a "Plugin Manager" that QUP doesn't have.
QUP Karaoke Engine — v2.26.0
KaraFun songs from the KaraFun desktop app
- QUP can now play KaraFun songs through the KaraFun app for Windows (tested with KaraFun 3.13), instead of the web player in Chrome. In the KaraFun plugin's settings, set "Play KaraFun songs with" to KaraFun app (Windows). The web player stays the default. Needs version 0.2.0 of the KaraFun plugin; update it from the Plugin Browser.
- Songs you saved for offline use in KaraFun play without internet. A song that isn't saved shows the usual red error within 15 seconds, so you can replace it.
- QUP asks before it closes a KaraFun that is already open, and you can't switch between the app and the web player while a KaraFun song is loaded.
- KaraFun is left as it was. When QUP closes, even if it crashes, its songs leave KaraFun's queue and, if KaraFun was open before, it reopens normally.
Add songs for a singer in one step
- Media Library > Karaoke > Add to Library > Add for singer lists the singers in rotation. Pick one, choose the file(s), and they are added to your library and queued for that singer, in the order you picked them.
- New singer... at the bottom of the list adds the singer first, then the songs.
- Files the scan rejects are not queued; they show in the usual "Add Files Complete" list.
Internet Radio stays on the air
- A station that drops reconnects instead of skipping to the next thing in the queue. It retries for up to 30 seconds; if nothing else is queued to play, it keeps trying (after 8, 16 and 32 seconds, then every minute) until the station is back or you change it.
- Station names survive a restart. A station you queued no longer comes back as a bare web address.
- Stations you add with "Add to Playlist" reconnect too, and keep their names.
Removing songs never deletes your files
- Delete Song From Database (and Delete Songs From Database, for a selection) now removes the songs from your library only. It used to offer to delete the file from your disk as well, with Yes already chosen. Your files now always stay where they are.
- Removing thousands of songs no longer freezes QUP. It runs in the background with a progress bar, and the removed songs leave the phone and kiosk search straight away.
- A selection that includes a song from a catalogue plugin such as KaraFun no longer stops the whole removal. Your own songs are removed, and the catalogue songs are left alone.
Music Video on Windows 7
- Music Video now works on Windows 7 (64-bit). QUP fetches a Windows 7 build of its download helper automatically. Windows 7 needs update KB2999226; QUP names it if it is missing.
Also in this release
- No more "NULL" artists. A karaoke file whose name gives no artist now shows no artist, instead of the word NULL. Your library itself is unchanged.
- QUP always finishes closing. If closing ever takes too long, QUP now writes a diagnostic file and closes anyway, and it never cuts short saving your settings or your database.
- Windows: no more error-log flood from the tray icon. Moving the mouse over QUP's tray icon used to write an error to the log every time.
- The greyed-out "Enable UPnP for Kiosks" box is gone from the network settings. It never did anything; kiosks are unaffected.
- Confirm dialogs work from the keyboard. In Confirm Exit and QUP's other confirmation dialogs, Enter picks the highlighted answer and Esc the safe one. Space no longer answers No by pressing the dialog's minimise button.
- Songs from a plugin you turned off leave the library. If you turn off or uninstall a song-catalogue plugin such as KaraFun, its songs no longer show in the Media Library or in search, so nothing gets queued that cannot play. They come back when you turn the plugin on again.
- Songs queued from phones no longer cause an occasional error while the playlist, rotation and singer lists redraw.
- Saving tags can no longer lose a song file. Metadata Editor now writes the new version beside the song and swaps it in only once it is complete, so a failed save leaves your file as it was. The same fix is in updates to Genre Tagger, File Management and YouTube; update them from the Plugin Browser.
For plugin developers
- Library lists (new API). A plugin can register a list of its own that appears in the library, under Break music, with its own columns and search. See the Plugin API page.
QUP Karaoke Engine — v2.25.0
Update your kiosks before you update the engine
- QUP 2.25.0 closes the old way kiosks fetched the song catalogue. That route had no password on it: anything on the venue's wi-fi could download the whole catalogue, including every song's play count. Kiosk 2.25.0 uses an authenticated route instead.
- A kiosk older than 2.25.0 will not start against a 2.25.0 engine. It shows "Failed to initialize database. Exiting" and closes. Nothing is damaged and nothing is lost — it starts again normally once the kiosk is updated.
- Kiosk and engine are published separately, so both need updating this time. A 2.25.0 kiosk started against an older engine says so itself and asks you to update the engine.
- A kiosk keeps its place when its network address changes. The engine knows a kiosk by the machine, not by its address. A kiosk the engine has not heard from is marked stale, and you can forget it.
- A kiosk never reads half a catalogue. The catalogue is replaced in one step, so a kiosk that asks while it is being rebuilt gets the old one or the new one, never a mix.
Old mobile catalogue downloads retired
- Two catalogue downloads meant for an old mobile client are gone, along
with everything else the engine served from its
/temp/folder. Neither had a password. No version of QUP's own phone app, kiosk or bar ever used them, and one of the two had never worked at all: its name was spelled differently from the file the engine wrote, so it always answered "not found". If a third-party tool of yours downloadedmobiledatabase.zipfrom the engine, it will stop working.
Sound Pads (new)
- Eight pads for stingers and sound effects, each with a built-in sound: applause, air horn, drum roll, a "Next singer!" call, happy birthday, last call, rimshot and a show intro.
- The break music dips while a pad plays and comes back smoothly after. The dip is -9 dB by default; turn it deeper, or off, in the Sound Pads settings. Pads never reach the singer's track: the karaoke output is the same with or without them.
- Use your own sounds. Pick a WAV or MP3 for any pad. It is copied in, so moving or renaming the original does not break the pad. Built-in and Tone buttons put a pad back.
- Tap pads from Preferences > Plugins > Sound Pads.
LRC lyrics (new)
.lrclyric files play as karaoke. Two lines, the sung part in amber and the next line dimmer. Works for a local MP3 with an.lrcfile beside it.- MIDI karaoke files keep the last line of each page, and Chinese (GBK) lyrics are no longer mistaken for Japanese.
Also in this release
- macOS: the 10-band EQ is no longer clipped, and the CROSSFADER and CUT labels show in full.
- The licence screen says why a key was rejected: an old key that has been retired, a bad signature, a damaged key, or text that is not a key at all.
- The singer database counts visits: one per singer per night.
QUP Karaoke Engine — v2.24.0
Singer PINs are no longer stored as readable text
- PINs are stored scrambled now, not as text anyone can read. Nothing changes for a singer: they sign in with the same PIN as before. Existing PINs are converted quietly in the background as singers sign in, so there is nothing to do and nothing to wait for.
- You can set a singer's PIN, but you can no longer read it. In the Singer Database the PIN box is now a Set PIN… / Change PIN… button, and the PIN column says only whether one is set. If a singer forgets their PIN, give them a new one — nobody can look the old one up, including us.
- Tools that read the database directly will no longer find a PIN there. If you use anything of your own that reads the singer table expecting a readable PIN, it will stop seeing one.
- Exporting singers to CSV now writes the scrambled PIN, so treat that file as sensitive. It is enough to sign in as those singers if someone gets hold of it. The recommended way to move to a new PC is to copy your database using the backup, not to export and re-import.
- If you roll back to an older version after upgrading, singer PINs will not work and singers may be able to sign in without one. Set PINs again, or stay on 2.24.0 or later.
Security: older request commands retired
- Nine older kiosk and mobile request commands accepted a singer's identifier on its own and acted on that singer's account. They are retired and now refuse. Nothing in QUP Karaoke's own kiosk, mobile or bar apps used them, so there is nothing for you to do; a third-party or custom client that did will need updating.
- Singer photo links now change with each show. A link to a singer's photo stops working once a new session starts. The rotation and now-singing screens are unaffected.
- Checking whether a singer name is already taken now answers only that.
A singer's queued count is their unplayed songs
- The number beside a singer in the rotation is how many songs they still have waiting, not a counter that drifted. It used to keep counting songs that had already been played, so a singer could look busier than they were and lose their turn.
Saved settings that quietly did not save
- A migration that fails now says so instead of looking like it worked. The engine adds columns to its databases as it upgrades. If one of those failed — a full disk, a locked file — the engine carried on as though it had succeeded, and whatever that column held was then written nowhere. Cue points, a manual BPM and a beat grid could all silently not stick. They now either save or tell you why not.
DJ and mic metering
- Two VU meters on the master output, so you can see the level that is actually going out.
- Mic strips show their own meter, and their knobs and input selector read from the strip they belong to.
- The filler list shows a BPM column.
Vault
- Getting songs from the Vault survives a restart. A download is no longer cut off if the engine is closed mid-transfer, and starting again after an interrupted download picks up cleanly instead of failing to open.
No kiosk or bar update this release
- Your existing kiosk and bar terminal work with engine 2.24.0 as they are. Neither changed since 2.23.0, so there is no kiosk or bar download to look for.
QUP Karaoke Engine — v2.23.0
October 6, 2026
Singers can change their PIN from the phone app
- A singer who knows their current PIN can set a new one from the app. The venue's copy is the one that counts: if the PIN was changed at the kiosk in the meantime, the kiosk's PIN stands and the app says so rather than leaving the singer with two different PINs.
- This needs the companion app update that follows this release. Until that lands, the app still tells singers to change their PIN at the kiosk — so there is nothing for you to do, and nothing changes at the venue.
Bar terminal 2.23.0
- The green clock is a clock. It used to restart the session if you clicked it, which is not what a clock should do. RESTART SESSION is now the one button that restarts the session, and it still asks twice before it does.
- Bar 2.23.0 works with engine 2.22.0 or newer. There is no kiosk update this release — your existing kiosk works with engine 2.23.0 as it is.
QUP Karaoke Engine — v2.22.1
October 6, 2026
Security: OSC could end the night without being asked
If you use OSC, update. If you have never switched OSC on, nothing here affects you and nothing changes.
- Anyone who could send the engine a message could end your session. OSC messages carry no password — that is how the protocol works — and QUP accepted a "restart session" message from anybody who could reach it. There was no confirmation step. That single message cleared the playlist, cleared the rotation and zeroed the evening's takings, with no way to undo it, which is the one thing QUP otherwise always asks you to confirm.
- It now has its own switch, and it is off. Network > OSC Messages > "Allow OSC to restart the session". Existing setups come up with it off, so if you have OSC on for a Stream Deck, a foot pedal or a lighting desk, your transport, volume and filler controls carry on working exactly as before and only the restart message is ignored.
- If you genuinely drive "new session" from a control surface, tick that box and it works as it always did.
- The bar terminal's RESTART SESSION button no longer uses OSC at all. It goes through the same authenticated connection as the rest of the terminal and asks you to confirm twice.
No other change. The rest of 2.22.0 is untouched.
QUP Karaoke Engine — v2.22.0
October 6, 2026
Update your bar terminal at the same time as the engine
Engine 2.22.0 removes the old bar-terminal commands. Update QUP Karaoke Bar to 2.22.0 at the same time, or the bar screen stops working. The two now talk over an authenticated connection instead of the old open one, and neither half works with the other version. A 2.22.0 bar terminal also refuses an older engine, so this is one update, done together, not two.
If you do not use the bar terminal, there is nothing to do.
New: Vault songs play in QUP
This is the first release with Vault support. If you have a Vault subscription, your approved songs now play in QUP like any other song in your library:
- MP3+G, MP3+LRC and MP4 all play through QUP's own player, so everything you already use works with them: the lyrics window, the projector, pitch and tempo, the waveform strip, and the queue.
- You can scrub and jump within a Vault song, the same as a song on your own drive.
- Nothing is written to your disk. Vault songs are decrypted in memory while they play and never land in a folder or a temp file.
- If an approval is withdrawn, the song stays red in the playlist, you are told why, and the rotation moves on to the next singer. It is not marked as a bad file, so nothing in your library gets flagged because a subscription changed.
- Each song you actually perform is reported once. Songs that never played, or that failed to open, are not reported — and drawing a waveform or scrubbing through a song is not a play either. Only performing it counts.
Set it up under Misc > Vault. If you do not have a Vault subscription, nothing changes for you.
Security: the kiosk protocol no longer hands out PINs
- Anyone on your venue's network could read a singer's PIN. The old protocol answered three commands — a card number, a singer's name, or an internal id — with that singer's whole record: their real name, their card number, their credit balance, and their PIN in plain text. Nothing had to be proved first; being able to reach the kiosk port was enough. All three are gone, along with a fourth that handed out singers' internal ids, and the eight bar-terminal commands — one of which answered the night's takings to anybody who asked.
- What the kiosk does instead. It signs in over an authenticated connection and can only read the singer it has signed in as. No reply contains a PIN in any form — a screen that needs to know whether a PIN is set is told yes or no, never the number.
- Nothing to do, as long as the kiosk and bar terminal are on 2.22.0.
Fixed: banning a singer now actually stops them
Banning a singer only stopped them at the kiosk's own swipe screen. Nothing in the engine refused them afterwards, so a banned singer could still be put into the rotation. Banning now refuses them at sign-in and blocks any further requests, including for a singer banned mid-session who is already signed in. (Singers who sign in through qupkaraoke.com were already refused there.)
Fixed: swapping two of your own songs did nothing
A patron who swapped two of their queued songs saw the old order forever. The swap reported success and changed nothing, so they would swap again and undo it. The songs now actually change places.
Fixed: a kiosk could overwrite a singer's PIN with the wrong one
Saving any account detail at the kiosk sent whatever PIN the kiosk happened to be holding — which, after a mistyped sign-in, was the PIN that had just been rejected. A singer could be locked out of their own account by somebody else's typo. The kiosk no longer sends a PIN unless the singer is deliberately changing it, and changing an existing PIN or card now asks for the current PIN first, so a kiosk left signed in cannot be used to lock somebody out.
Photos: taken at the kiosk, published only if you use the website
A photo taken at the kiosk stays on the venue's own machine. It is uploaded to qupkaraoke.com only when that singer later signs in on the website, which is taken as permission to use it there. Using the venue's own phone page on the local network is not permission and never uploads anything. A new photo replaces the old one the next time they use the website.
Also
- The kiosk's "We have room for N more singers" could read "room for NULL more singers" when the engine was unreachable.
- A kiosk keeps its row on the Kiosk Security screen when its network address changes; it used to appear as a second, phantom kiosk.
- "This venue already has 4 kiosks registered" now says that, instead of reporting an authentication failure.
QUP Karaoke Engine — v2.21.3
Released October 5, 2026 · Previous version: 2.21.1
Security: a card swipe asks for the PIN when your venue requires one
- At a venue with PIN codes switched on, swiping a card signed the singer in without asking for the PIN. The card was treated as proof of identity by itself, so the second factor the venue had deliberately turned on was skipped for every carded sign-in. A card says who someone is; it does not say that the person holding it is them, and a card is the thing that gets left on the bar. Swiping now asks for the PIN whenever Use PIN codes is on; with it off, a card alone signs in exactly as before. Party mode is not affected and never was: it has no accounts and does not use cards — everyone types their name.
- Why it matters: a signed-in session spends that singer's credits, on
bribes and on song-shop purchases. Card numbers are not secret either — the
old
/karaoke.txtprotocol still answers anyone on the network and will hand one over. That protocol is unchanged in this release and is removed once every kiosk has moved off it. - Nothing to do. The rule is read from the setting you already have. If you want two-factor sign-in at the kiosk, turn Use PIN codes on in Preferences > Kiosk.
2.21.3 is 2.21.1 plus this one fix. Nothing else changed. (2.21.2 was tagged but never published: the release refused to go out until its announcement was written, so no build under that number ever reached this page.)
QUP Karaoke Engine — v2.21.1
Released October 3, 2026 · Previous version: 2.21.0
- 2.21.0 was announced but never reached the download page. Its Windows, Mac and Linux installers were built but not published: the release build's new runtime check assumed the Windows folder layout and failed on Linux, and the plugin-catalog step could not describe the new LAN Queue plugin without the engine jar. The forum post went out before that was known. 2.21.1 is 2.21.0 with those two build steps fixed; the check now finds the runtime wherever the packager put it. No change to the program.
QUP Karaoke Engine — v2.21.0
Released October 3, 2026 · Previous version: 2.20.0
Security: the kiosk talks to the engine over an authenticated protocol
- A kiosk now identifies a singer the way the phone app does: name and PIN,
checked by the engine, over a connection pinned to this venue's own certificate.
The old
/karaoke.txtprotocol answered anyone on the network and, asked by name for a singer who holds a venue card or account, returned their PIN, card number, email, phone and credits in plain text. That protocol is still served in this release so an existing kiosk keeps working; the new kiosk uses the new one. Removal comes once every kiosk is moved over. - Every install now has its own TLS certificate, generated on first run into its data folder (2048-bit RSA, SHA-256, twenty years), replacing one shared, expired 2011 key that every copy of QUP carried. Nothing you use checks the old one, so nothing changes for you; a kiosk pins the new one. Preferences > Kiosk Security shows the fingerprint and can issue a new certificate (every kiosk then re-enrols).
- Kiosks enrol with a venue code, not by IP address, and the claim is rate-limited.
- Patron mode for a kiosk: the phone flow on the kiosk screen (name and PIN, PINs required).
Fixes
- Accented and non-Latin singer names, song titles and search terms arriving from a kiosk were corrupted (each byte became its own character). Fixed in both web servers. A singer who registered from a kiosk under a corrupted name is still found under the right one, with their history, favourites and PIN.
- A singer could be kept out of the show because a window was not open: the singer database updated its table unguarded, so creating a singer from a kiosk failed with "That name can't be used here" whenever the Singer Database window was closed.
- An empty PIN sent by a kiosk no longer wipes a stored one.
- Queuing the same song twice by accident no longer adds it twice (a tapped twice confirmation or a retrying phone lands exactly one song and says so); a sold-out venue no longer tells the kiosk it can take another song; the queue cannot be flooded from the network by claiming the KJ's own override.
- An unreadable preferences file no longer stops QUP from starting when nobody is at the screen; it is logged, and the notice waits until the windows are up.
- Crashed sessions of the Media Player and Simple Player no longer leave their extraction folders behind: the next start sweeps them.
- On a Mac whose Java reports itself as "Darwin" rather than "Mac OS X", QUP used to put its data in ~/QUPKaraoke instead of ~/Library/Application Support/QUPKaraoke. The folder now resolves the same either way; a library already living at ~/QUPKaraoke is kept where it is and used, never moved; and every start logs which folder was chosen and why.
- The Windows installer now removes stale plugin jars on upgrade (the delete lines carried stray control characters since 2.13.0).
For plugin authors
- Plugins can offer singers a song queue of their own: search the library,
check whether a singer may queue another song (with a real reason when not),
queue, read the queue and a singer's place in it, favourites and history, and
change or remove their own entries.
QueueResult,QueueReason,QueueEligibility;PlaylistEntryInfogains unplayed position, songs ahead and entry hash. See qupkaraoke.com/plugin-api. - Plugins can put their own QR code on the singer screen (
setQrUrlOverride). - LAN Queue (singers queue from their phones over the venue's own network, no cloud) is in the Plugin Browser as a download.
QUP Karaoke Engine — v2.20.0
Released October 3, 2026 · Previous version: 2.19.0
New: two more ways to run QUP
- Media Player mode. One player, one ordered playlist, no singer rotation: a Winamp-shaped set of windows (Player with Shuffle and Repeat, EQ, Key/Tempo, Playlist, Media Library, Video) that snap together, dock as one arrangement, and come back where you left them. Double-click a library row to add it to the playlist, Shift+double-click to play it now. Winamp's playlist menu (ADD / REM / SEL / MISC / LIST OPTS) on the Playlist, drag to reorder, Del to remove. The playlist survives a restart. The Video window is the singer display: double-click it (or the Video fullscreen hotkey) for fullscreen on its own monitor. Settings → Display → Ticker: your own title format for the Player's display, in the WACUP style.
- Simple Player mode. One KaraFun-shaped window: Search, Home, Playlists, Genres, New, Top, Favorites, History and My Playlists down the side; your whole library (karaoke, filler and KaraFun) as one flat list; album art tiles (generated for every song, real covers looked up online when the Settings switch is on); curated playlists resolved against what you own; the player, now-playing strip and playlist in a column on the right, as wide as you drag it; the EQ opens under the transport; a Projector button for the second display.
- Choose a mode in Preferences → Startup Mode. Hotkeys: the transport, key, tempo and application actions work in both new modes.
For plugin authors
PluginContext.runMode()andhasFeature(String): gate on what the running mode builds (rotation, filler, decks …) rather than on which mode it is. See the Plugin API page.
Also
- Reset layout no longer shrinks the Media Player's Video window to the projector's own size.
- A profile saved before a window existed gets that window its shipped place, and the one window sitting exactly in that slot moves down to make room.
- The CDG preview keeps moving while the projector window is hidden: the Simple Player's preview with its TV off (and the Karaoke preview while a KaraFun song has the projector stepped aside, or after Alt+F4 on it) used to freeze until the window was shown again.
- Skin packs can carry previews of the two new faces; the Plugin Browser shows one per mode. brushed-steel ships both.
- The exit path is checked in all four modes by CI.
QUP Karaoke Engine — v2.19.0
Released October 2, 2026 · Previous version: 2.18.2
New: Help
- Press F1 (or right-click any title bar → Help…) for QUP's new Help. 22 topics on running a show: replacing a singer's song, queueing, how the rotation decides who sings next, moving and removing songs, songs that won't play, key and tempo, the singer screen, filler, starting and ending the night, searching, phone requests, Tonight's Singers, the singer database, kiosks, paid singing and bribes, speakers and mics, backups, keyboard shortcuts, windows and plugins. Search finds a topic by any words in it.
- "Show me how" guided tours. 15 tours, on 13 of the topics, spotlight the real controls and move on as you do each step. Click a column name on the rotation page to see that column in your Playlist. Pages show your own keyboard shortcuts, even if you've changed them.
- Help has its own window, whether the rest of QUP is docked or not.
New: Custom song-name format
- Preferences → Database → Song Name Formatting → Custom: type your own
layout with $disc $track $artist $title (and $album, $skip). Write a field
with # to read it from the folder name, e.g.
#disc - $track - $artist - $titlereads\SC8125\03 - Artist - Title.zip. The line under the box shows how QUP will read your files, or why the layout won't work.
New: "Compatible graphics" option
- Preferences → Skin & Layout → "Compatible graphics" (Windows) turns off Direct3D, for computers where dialogs paint blank until you move the mouse over them. Restart QUP after changing it.
Fixes
- Changing Windows' display scaling no longer scrambles QUP's window layout (e.g. 100% → 175% → 100%), and the damage doesn't survive a restart any more. Windows → Reset layout is now always in the menu and puts every window back where a fresh install puts them.
- The update notice and the "Welcome to QUP" question no longer open on top of each other. Welcome waits until QUP's windows are restored if QUP started minimized.
- Importing a license key from a saved file no longer freezes QUP. The file picker used to open behind QUP's windows, and the "License key accepted" message can't hide behind the About box any more.
QUP Karaoke Engine — v2.18.2
Released October 1, 2026 · Previous version: 2.18.1
Fixes
- The About box is back to the classic Star Wars text crawl. The 3D scene (planet, starfield, Star Destroyer) caused problems on some computers, so the About page uses the original scrolling crawl again on every platform.
QUP Karaoke Engine — v2.18.1
Released September 30, 2026 · Previous version: 2.18.0
Fixes
- Updating a plugin in the Plugin Browser installs the new version. The Update button used to stage a removal instead, and nothing new was downloaded. Installing a plugin also switches it back on.
- The Windows installer clears out plugins it no longer ships. Plugins that became download-only stayed behind at their old versions after an update, looked built in, and could be neither updated nor removed.
- Music video backgrounds stay smooth with the Backgrounds page open. Its preview made the video skip to a frame every second or two on the singer display.
KaraFun (plugin 0.1.3)
- The spectrum analyser and MilkDrop see KaraFun pre-fader, like any other karaoke song.
- KaraFun's player starts with QUP (when the plugin is on), so a signed-out account shows up before the show rather than on the first song.
- Lighter on the CPU while KaraFun's lyrics are on the singer display.
QUP Karaoke Engine — v2.18.0
Released September 30, 2026 · Previous version: 2.17.0
New skin: 1997 Mp3 Player
- A second built-in skin beside Brushed Steel: navy faceplates, lavender bevels, grey buttons and green-on-black LCD readouts, in the style of a late-90s desktop MP3 player. The analyser runs green to red in flat bands and the knob rings follow the same colours. All-new artwork, drawn by QUP's own generator.
Skins in the Plugin Browser
- Skins have their own chip in the Plugin Browser. Built-in skins read Built in; skins published later can be installed and removed there.
- Click a skin's picture for a preview: QUP wearing it at full size, with a Karaoke / DJ switch. The preview closes when you close it, press Escape, or click anywhere else.
- The Plugin Browser keeps one look, the qupkaraoke.com colours, whatever skin is in use, so it always stays readable.
- A skin is ready as soon as it is installed — no restart to install it. Choose it in Preferences → Skin & Layout; it applies the next time QUP starts. The skin in use can't be removed until another is chosen.
QUP Karaoke Engine — v2.17.0
Released September 30, 2026 · Previous version: 2.16.1
New: bitmap skins
QUP's windows can now wear a skin pack: images for the buttons, knobs, faders, meters, title bars and panels, not just colours. QUP ships with one, Brushed Steel.
- Preferences → Skin & Layout → Bitmap Skin. Pick a pack; it applies the next time QUP starts. One choice covers karaoke and DJ mode.
- Quality: Basic, Standard, Full (adds gentle pulses and fades) or Auto, which steps down to Basic by itself if the show needs the computer's time.
- Meters and knob rings take the skin's colours: gradients, or LED segments where the skin has them.
- Preferences and the About box never change, and nothing the audience sees (the singer display) is ever skinned.
- For skin authors: put a pack in your own skins folder (Open My Skins Folder in the same place) and it appears in the list. A developer overlay (a hotkey action, no key by default) outlines every control and lists any problems the pack has.
The Player comes apart
- Undocked, the Player is separate windows: status, the two transports, the EQs, Mix and the CDG preview in karaoke mode; the decks, their strips, the mixer, the waveforms and the visuals in DJ mode. They snap to each other and to the screen edges, and remember where you put them.
- Windows → Reset layout puts them back, and each one has a show/hide hotkey action.
- Docked mode uses your undocked arrangement, so setting things up once covers both.
- A new install starts undocked. Floating windows remember being hidden or shaded.
Smoother video on the singer display
- On Windows the singer display now draws with the graphics card, in step with the monitor it is on: music-video backgrounds, the scroller, the countdown and the floating QR code.
- MP4 videos no longer jump back and forth. Video now decodes on the CPU by default; hardware decoding was delivering some frames out of order.
DJ mode
- The waveforms scroll smoothly, one step per screen refresh (144 steps a second on a 144 Hz monitor), and no longer shimmer.
- Zoom with the mouse wheel over the waveforms (2 to 32 seconds across), or with hotkey actions. The lanes grow when you make the Waveforms window taller, and quiet tracks are drawn taller so their shape shows (drawing only; the audio is untouched).
- EQ knobs light from the centre, towards cut or boost, and so do the FX knobs while their effect is Filter, Flanger or Phaser.
- Cue level and QUANTIZE belong to each deck. The deck strips sit at the transports' height with the cue level on them, and DJ Decks and Perform are one window per deck. STOP FX is back beside the FX rows.
- DJ Visuals keeps time with the monitor it is on.
Also new
- KaraFun integration.
- The transport's countdown and spectrum share their panel evenly, and the spectrum has 40 bands, all the same width, with the bass no longer moving in blocks.
- Faster on older computers: the level meters cost far less to draw (a 2012 MacBook Pro's display work mid-song fell from 58% to 37%).
- Evaluation copies stay minimized until you choose Still Evaluating.
QUP Karaoke Engine — v2.16.1
Released September 27, 2026 · Previous version: 2.15.0
2.16.0 was announced but never published: its installers had CDG Repair built in, when it is meant to be a download you add from the Plugin Browser when you need it. 2.16.1 is the same release with that corrected. Everything below is what is new in it.
New: rip your CD+G karaoke discs into the library
A new plugin, CD+G Disc Ripper, in the Plugin Browser. Put a karaoke disc
in the drive and it comes out as one MP3+G zip per song, graphics included,
named the way your library already is — SC8513-01 - Artist - Title.zip — and
added to the karaoke library as it goes.
- Media Library → Plugins → General → Disc Ripper. Pick the drive, press Read disc, check the names, press Rip ticked tracks.
- It names the disc for you where it can: from text on the disc, from the CUETools and MusicBrainz databases, or from the disc id you type off the label. Every name can be edited before ripping, and "Last, First" is a tick-box per song, never a guess. Check the names against the label: the online databases are typed in by people, and some entries are wrong.
- Several drives at once. The Drive list switches between drives; each one keeps its own disc and its own rip, so you can start a second disc while the first is still going.
- Speed and Benchmark. Drives are often slower at their top speed — they outrun the computer, stall and spin up again. Benchmark tries each speed on the disc in the drive (about a minute and a half) and keeps the fastest steady one. On the drive it was built with, a whole disc went from about 17 minutes to 12.
- File layout at the bottom offers the same naming patterns as Preferences → Database, so ripped songs read back the way the rest of your library does.
- Graphics are checked, not assumed. Every graphics packet carries a checksum; damaged ones are repaired where that is certain, and parts the drive skipped are read again. Discs with an audio section and a computer section (Windows shows these as data discs, not Audio CDs) rip correctly.
- Not every drive can do this. CD+G graphics live in a part of the disc many drives will not read. Read disc checks the drive first and says so if it cannot. It was built and tested on a Dell DW316 USB drive; it has not yet been tried with a drive on a Mac or on Linux.
The plugin downloads the disc-reading tool it needs (redumper) the first time, checked against a known fingerprint, as it does for the video tools.
New: find out why a song won't play, and repair its graphics
A new plugin, CDG Repair, in the Plugin Browser. When a song won't play or its lyrics come up garbled, right-click it in the Media Library or the Playlist and choose Diagnose / Repair.... It tells you what is actually wrong, and fixes the graphics where it can prove the fix is right — never a guess.
- Rip errors — damage baked in when the disc was ripped — are corrected from the checksum every CD+G graphics packet carries. Only corrections the checksum confirms twice are made. A stronger mode that can fix more is there as an option, off by default, because it is occasionally wrong.
- A zip that decayed on disk is detected from the zip's own checksum and repaired from another copy of the same song that is still intact — anywhere in your library, or in a folder of spares you point it at. When no intact copy exists, the song goes on a re-source list, grouped by disc.
- Every repair can be undone. The original is kept, byte for byte, in a folder next to your library (named so QUP never imports it), and Plugins → General → CDG Repair → History undoes or redoes any repair. Nothing is written while a song is playing or paused.
- Scan the whole library from the same panel, repair everything that can be repaired in one go, and save the results as a spreadsheet.
- A manual editor for the rest: it lists the damaged graphics packets, shows each one at the moment it draws, and lets you fix a tile's colours, position or pixels, copy a good tile over a bad one, or delete a packet. Edits are saved through the same undoable repair.
Also in 2.16.0
- Playlist right-click: Note Bad File / Unmark Bad File, as the Media Library already had.
- Fixed: Note Bad File in the Media Library could mark the wrong song after the columns had been rearranged, and it blanked Times Played, Date Added and BPM on the row it marked.
- Fixed: a song that was briefly locked — by antivirus, or while a tool was repairing it — was permanently marked bad by the background length check. It is now tried again.
- For plugin authors: plugins can add to the Playlist's right-click menu, read and set the bad-file flag, and hold a song file while rewriting it. See qupkaraoke.com/plugin-api.
QUP Karaoke Engine — v2.15.0
Released September 25, 2026 · Previous version: 2.14.0
New: QUP shows you how to get started
A new KJ opening QUP for the first time had no idea where songs come in. One tester went to Add to Playlist, lost the dialog that followed behind another window, and reported QUP as frozen. Now QUP shows the way.
- "Would you like to see how to import media into QUP?" When the karaoke library is empty, QUP asks once, after the evaluation notice closes. Yes / Not now / Don't ask again. A KJ with songs in the library is never asked.
- Import tour. Preferences → Database: pick the filename pattern that matches your files. Then Preferences → Media: Add Folder and Rescan All. Each step dims the window, points an arrow at exactly what to click, and moves on when you do it. The last step shows your real song count and a few songs as QUP read them, so a pattern that swapped artist and title is obvious straight away.
- Queue-a-song tour, offered when the import tour finishes: search the library, double-click a song, type the singer's name and press Enter, and QUP points at the new entry in the playlist.
- Both are always in the app menu under Help, and every step has Skip tour. The tours draw inside QUP's own windows, so they can't be lost behind anything.
Fixed
- Column widths are remembered again. Widening a column in the karaoke or filler library, playlist, filler queue or rotation lasted only until the next launch: the column show/hide settings put back their own even split on every start, and that was then saved over your widths.
- A first run opens the Media Library on Local Library → Karaoke, where the songs are, instead of an empty Rotation. After that QUP opens on whatever you last selected, as before.
- The evaluation notice's button is easier to find. The countdown only runs while the pointer is over the button, and people were missing that. Its border now pulses until you hover it, and it matches the rest of QUP's buttons.
QUP Karaoke Engine — v2.14.0
Released September 23, 2026 · Previous version: 2.13.1
Linux: QUP works on tiling desktops (Hyprland, Omarchy, Archcraft, sway)
Hyprland never draws a title bar for any application and tiles new windows by default. QUP was relying on both, so Preferences came up with no way to move or close it, the title bars dragged nothing, and on one machine Preferences did not appear at all.
- Preferences draws its own title bar on compositors that provide none — the same bar the Player and Playlist windows already use. Windows, macOS, GNOME and KDE are unchanged and keep their native one.
- Title bars drag windows again. QUP asks the compositor to move the
window, the way GTK and Qt applications do; sway does this for you, and on
Hyprland — which accepts the request and ignores it — QUP notices and moves
the window itself. Either way a floating window drags normally. A
tiled window will not move by any route, because the layout owns its
position; float it first with a window rule (see the docs page), or use
Super+drag, which always works. - Message boxes and file pickers belong to the main window, so they open beside it instead of in the corner of the screen. A prompt QUP is waiting on that opens in a corner you are not looking at is indistinguishable from one that never opened. This also fixes a long-standing Windows annoyance where a scan report could hide behind the settings window.
- Every QUP window reports a stable name to the compositor and the taskbar:
QUPKaraokeEngine, with the singer display asQUPKaraokeEngine-CDGso it can be sent to the projector on its own. It used to reportQUPKaraokeEngine-Main, which matched neither the desktop entry QUP installs nor anything you could reasonably guess. - The AppImage and the portable ZIP now set the Java window-manager flag these
desktops need. The
.debcannot set it for itself — seedocs/linux-tiling-wm.md, which also covers writing compositor rules against the names above (Hyprland changed its config format, so the oldwindowrulev2lines you may find elsewhere no longer apply).
On a tiling desktop, the first run starts undocked
Docked mode puts every pane inside one window. A tiling compositor then squeezes that whole window into one tile, which is worse than useless on a small screen. So the first time QUP runs on one of those desktops it starts undocked, and the compositor gets separate Player, Media Library and Playlist windows it can actually place.
It is only the starting point. Dock it once and it stays docked, there as anywhere else — QUP remembers what you chose and never overrules it. Windows, macOS, GNOME and KDE are unchanged and still start docked.
Fixed: dividers that fought you on a narrow window
Dragging the divider between the tree and the pane beside it — in the Media Library, in Preferences, and in Singer Management — could bounce back instead of moving, and the narrower the window the worse it got. It was never really draggable past a point you could not see or predict, because that point was set by whichever hidden pane happened to be the widest.
Now it goes where you drag it. Most visible on a tiling desktop, where windows are small by default, but the same bounce was reachable on Windows by making the Media Library narrow enough.
Also fixed: being on a narrow window once could overwrite your saved divider position, so it followed you back to a big screen.
YouTube: sign-in settings, so age-restricted videos download
The YouTube plugin had no way to sign in to YouTube, and nowhere to set one up. Downloads that needed an account simply failed — age-restricted videos, members-only videos, and the "confirm you're not a bot" check YouTube now shows on unfamiliar connections.
Config → Plugins → YouTube now has the same two cookie settings the Music
Video Backgrounds and Karaoke Maker plugins already had, and they work the same
way: pick a browser to take cookies from, or point it at a cookies.txt file,
which wins if you set both. Chrome and Edge have to be closed for the browser
option; the file option does not care.
Downloads that fail for those reasons now say so and tell you where to fix it, instead of failing with nothing to go on.
QUP Karaoke Engine — v2.13.1
Released September 18, 2026 · Previous version: 2.13.0
A Plugin Browser follow-up: clearer sizes, and uninstall now cleans up after itself properly.
The Apply button tells you how much room it really takes
A plugin's row used to show only what was left to download on your computer, so Karaoke Maker could read "189 KB" on a machine that already had its tools. Rows now show the plugin's own size, and the Apply button adds it up:
Apply — 1 plugin: 189 KB + 2.1 GB tools = 2.1 GB
Tools you already have are not counted, and when nothing new is needed the "+ tools" part goes away. Removing works the same way: "1 to remove: 189 KB + 2.1 GB tools = 2.1 GB freed". Hover over a plugin to see its download size, which tools you already have, and the voice and separation models some tools download the first time they are used.
A Tools view
A new Tools button at the end of the filter row lists the shared tools — FFmpeg, yt-dlp, Deno and the Python audio tools — with how much room each takes, where it lives, and which of your plugins use it.
Uninstalling a plugin now removes the tools only it used
A tool stays as long as any installed plugin needs it, and goes with the last one. Before, tools were only removed if you ticked a box, and even then:
- Karaoke Maker's Python tools were never actually removed — about 1.8 GB stayed on disk. They are now.
- "Uninstalling" a built-in plugin (which only switches it off) could take a tool it needed with it, so it broke when you switched it back on. Built-in plugins now keep their tools.
- Tools are removed when QUP restarts, not while the plugin that uses them may still be running.
The voice and separation models are left where they are, because other programs on your computer may use them; the dialog tells you where to find them.
QUP Karaoke Engine — v2.13.0
Released September 18, 2026 · Previous version: 2.12.2
A Plugin Browser, a smaller installer, and patrons buying songs for the bar.
A Plugin Browser, and a smaller download
QUP now has a Plugin Browser (Media Library → Plugins → General → Plugin Browser). Every plugin is listed with what it does, how big it is on your system, and whether it is installed. Tick what you want, press Apply, and restart QUP.
- Installing a plugin installs everything it needs. Karaoke Maker, YouTube and Music Video Backgrounds used to need a separate trip to their settings to press "Setup Tools" before they worked. Now the download tools, the video engine and the vocal-separation software come down with the plugin itself. That button is still there, renamed Repair Tools, for putting back a tool that has gone missing.
- Tools you already have are used, not downloaded again. If a working copy is already on your machine, QUP checks it can actually do the job, then uses it.
- Eight plugins are no longer part of the installer: AutoFiller, File Management, Genre Tagger, Karaoke Maker, MIDI Karaoke, Music Video Backgrounds, SongShop and YouTube. They are free downloads from the browser instead, so the installer only carries what everyone uses.
- QA Harness, a tool for testers and plugin developers, is a browser download now too; nobody needs it to run a show.
If you were using any of those eight, nothing is lost. The first time you start this version, QUP tells you which ones you had, and they are already waiting in the browser's cart: open it, press Apply, restart. Your settings, queues and files for them are exactly where you left them.
Patrons can buy a song for the bar at the kiosk
With SongShop installed and your card saved in it, turn on Config → Misc → Song Purchases. A patron who can't find a song at the kiosk sees the store's songs with a price, and can buy one for the venue: your card pays the store, the song lands in your library, and it goes into the patron's queue.
- The price comes off the patron's credits, plus anything you choose to add on top — or turn that off and just let them queue it for the usual cost to sing.
- The patron pays only once the song is in your library. A purchase that fails anywhere along the way costs them nothing.
- Nobody pays twice for one song. A song you already own is simply queued, and a second patron asking for a song that is still downloading waits for it without being charged.
This uses the song-purchase screens already in the QUP kiosk app; the web kiosk and mobile app will follow.
Fixed: the right-hand EQ slider's buttons were cut off
On the graphic EQ, the last band's value and frequency labels were clipped — the column was allowed to be narrower than the text in it. Reported on a Mac; it was the same everywhere, just least visible on a wide window.
Fixed: your graphics card stops going unused without telling you
QUP now checks whether Karaoke Maker can actually use your hardware, and says so in plain words when it cannot — which card it found, what is missing, and what to install. Before this, a machine with a perfectly good NVIDIA card would quietly do everything on the processor and simply take several times longer, with nothing on screen to suggest anything was wrong.
Fixed: the video tools no longer change under you overnight
Karaoke Maker fetched its video engine from a nightly build that is replaced every day. One of those nightlies needed a newer graphics driver than the machine had, and GPU encoding stopped working — on a machine where nothing had changed and no update had been installed. Every download is now pinned to a specific version that only moves when we move it.
Fixed: the Linux portable ZIP said it needed the wrong Java
The portable ZIP asked for a JRE. It has never worked with one and never could: it needs a part of Java that only the full JDK ships. The instructions now say JDK, and the launcher checks for the two pieces it actually needs before starting, instead of dying with a stack trace.
QUP kiosk app
An updated kiosk app is on the download page. Its purchase confirmation now shows the full amount a patron will be debited — the song, anything you add on top, and the cost to sing. It used to show only the cost to sing.
QUP Karaoke Engine — v2.12.2
Released September 17, 2026 · Previous version: 2.12.1
For Mac owners who use Karaoke Maker: it now sets itself up, and the videos it makes have lyrics on them. Everyone else can skip this one.
On an Apple Silicon Mac, Karaoke Maker's "Setup Tools" button never worked
This applies to Macs with Apple Silicon — M1 and later. Intel Macs are covered further down, and the news there is smaller.
Karaoke Maker needs a few outside tools before it can build a karaoke track for
you, and the Setup Tools button is supposed to fetch them in one click. On a
Mac that button has never succeeded. It ended with Setup failed: pip install
failed (exit 1) and nothing to go on. This was not something that broke
recently — it has not worked on any Mac release, so if you tried it once and gave
up, this is the version to try again.
Setup Tools now brings its own copy of everything it needs. It no longer depends on what happens to be installed on your Mac, which is what it was doing wrong: it was trying to borrow the Mac's own Python, and modern macOS does not allow that.
What to expect when you click it. It downloads about 30 MB to start, then the audio tools themselves and a video engine of about 60 MB, settling at roughly 850 MB inside QUP's own plugin folder. The first song you build after that downloads another 1.5 GB or so of listening models — that happens once, not per song. Nothing is installed into macOS itself.
One optional piece may not install, and that is fine. The fancy subtitle
effects need a graphics library that Macs do not ship. If it is missing you will
see "Subtitle effects unavailable (optional) — everything else is ready" and
Karaoke Maker still works, with plain subtitles. If you want the effects,
install that piece yourself with brew install cairo pkg-config.
On a Mac, the finished video had no words on it
Even once the tools were in place, the video Karaoke Maker produced on a Mac had no lyrics on the picture. The words were attached as a subtitle track that most players leave switched off — so on a projector, where it matters, the screen showed a song with nothing to sing from.
The cause was the same one as above, one step further along: QUP was borrowing whatever video engine the Mac happened to have, and none of the available ones could draw lyrics onto a picture. QUP now brings its own on the Mac, the way it already did on Windows and Linux. Lyrics are burned into the video again, in colour, sweeping word by word as the song plays.
And if lyrics ever cannot be drawn, the job no longer reports a cheerful "Done". It says "Done — NO LYRICS ON VIDEO" and tells you why in the log.
The first song on a Mac always failed with a graphics-card error
Every first attempt on a Mac stopped with "GPU (NVENC) video encoding unavailable — turn on Allow CPU encoding". That setting exists for Windows machines with an NVIDIA card. No Mac has ever been able to use it. The question was never a real one on your machine.
Macs now just get on with it, and use your Mac's own video hardware — so songs finish noticeably quicker and the files come out about 30% smaller, with no visible difference to the lyrics on screen.
Songs occasionally came out named after an error message
If YouTube hiccuped while QUP was looking up a song's name, the video still built correctly but came out called something like "Unknown — ERROR: [youtube] … The page needs to be reloaded". The song itself was always fine; only the name was wrong. QUP now tells the difference between a title and an error.
Intel Macs: better, but still not finished
On an Intel Mac, Setup Tools gets considerably further than it used to but still does not complete. Two of the audio components have no ready-made Intel-Mac version left and have to be compiled on your machine, which needs developer tools QUP cannot install for you. What has changed is that it now tells you that, by name, instead of "exit 1".
Linux
Linux gets the same self-contained setup. Two things to know: it needs several
GB of free space in your temporary folder as well as in QUP's own folder, and
it installs the graphics-card build of the audio engine whether or not you have
that card — so it settles at around 5.7 GB. If setup stops with a message
about a disk quota, that is your /tmp filling up, not your main disk.
Windows
Windows is unchanged. Setup Tools worked there before and works the same way now — the only difference is that a failure message says more than it used to.
QUP Karaoke Engine — v2.12.1
Released September 16, 2026 · Previous version: 2.12.0
A same-day hotfix for 2.12.0. If you are on macOS, take this one.
On a Mac, Help → About closed the whole program
Opening the About page quit QUP instantly — no message, no crash box, the window simply disappeared and you were back at the desktop. Anything unsaved in that session went with it.
The About page has an animated opening-crawl behind it. On macOS it was drawing that animation in a way the operating system does not permit, and macOS responds by shutting the program down rather than by showing an error. On macOS the About page now uses the original, non-animated crawl, which is why there is nothing to see here beyond the page opening normally. Windows is unchanged and keeps the animated version.
Only the About page was ever affected. Playback, the library and your data were never at risk, and nothing needs repairing after it happened.
The portable Linux download really does start now
2.12.0's notes below say the portable ZIP was fixed. That was not true of the
file we actually shipped: the fix went into one launcher and the ZIP is built
with a different one, which still had the fault. 2.12.1 is the first release
whose portable ZIP starts. The .deb and AppImage were always fine. Apologies
— if you downloaded the 2.12.0 ZIP and it did nothing, that was this.
Under the hood: how QUP works out which system it is running on
Fixing the About crash turned up the same mistake in the shared code that asks "which operating system is this?" — and that code also helps choose which audio device list you are shown and which sound components load. It was corrected everywhere it appeared.
You should see no difference. On Windows, macOS and Linux the answer is the same before and after, and that is what we tested. But because it touches audio device selection, it is worth one look: open your output device picker once after updating and check your usual device is still listed. If anything is missing, tell us — that would be a bug in this release, not a setting you need to change.
QUP Karaoke Engine — v2.12.0
Released September 16, 2026 · Previous version: 2.11.0
Your database is now actually backed up. Every backup QUP has written since the beginning was an empty 22-byte file — a typical install holds well over a thousand of them, and not one contains a song, a singer, or a play count. If you had ever needed one, there was nothing in it.
From this version QUP writes one real backup per session, at shutdown, and checks it before calling it done: the copy is reopened and every table's rows are counted against your live database. If anything is wrong the file is deleted and QUP says so, instead of reporting success.
- A session that ends badly is backed up too. If QUP crashes, or the power goes, the next launch notices and backs up that night's work before anything else happens.
- The five most recent backups are kept, in
data/db/backups. Older ones are removed only after a new backup has passed its checks, so a bad backup can never delete a good one. - Your old empty backups are left alone. They are worthless, but they are your files, so QUP counts them in the log and does not touch them.
A backup of a large library takes well under a second, and never runs while you are singing.
Config ▸ Database loses two checkboxes, "Backup on startup" and "Backup on new session". They switched on steps that produced nothing. Backup on shutdown stays, and turning it off still turns backups off.
Keyboard shortcuts for the things you do mid-song
Config ▸ Hotkeys is a new page. Bind a key to what you reach for while a song is playing — pause, next singer, volume, key change — and see every binding in one list instead of learning them.
- Conflicts are shown, not discovered. If a key is already taken, the page tells you before you save it.
- Plugins can add their own actions, so a plugin's feature can sit on a key beside the built-in ones, named in the same list.
- System-wide keys — the ones that work while QUP is not the focused window — ship switched off, and are Windows-only for now. Turn them on in the same page if you want them.
The library stops working while you sing
Background library jobs — length backfill, BPM scanning — no longer run during playback. They wait for a gap and give way the moment one ends. A paused song counts as playing, because a pause mid-show is not an invitation to start decompressing archives.
This one was a real regression. After the archive-format fix in 2.11, those jobs stopped failing quickly on certain song archives and began succeeding slowly instead — seconds of work, repeatedly, during a show.
Your settings and photos land where they belong
Twenty-one places in QUP wrote files next to the program instead of in your data folder — on an installed build, a folder you never look in, and sometimes one the app cannot write to at all.
- Singer photos uploaded over a secure connection are now served. They were written to one place and looked for in another, so they simply never appeared.
- Settings, logs and temporary files now live under your data folder. Anything already saved in the old location is copied across on first launch — never moved, never overwritten.
Linux: the portable ZIP starts
The portable Linux download had never started — it stopped on a plugin loading error before the window appeared. Fixed, and the release build now refuses to ship a ZIP that does not start.
Correction, added with 2.12.1: this did not reach the 2.12.0 download. The fault existed in two launchers and only one of them was fixed in time — the ZIP is built with the other. The 2.12.0 portable ZIP still does not start. It is fixed in 2.12.1 above.
Also in this release
- Long sessions no longer grow a file that never shrinks. QUP's database journal grew all night and was never tidied up; by the end of a three-hour session it had reached 15 MB and was still climbing. It is now kept in check however long you run.
QUP Karaoke Engine — v2.11.0
Released September 13, 2026 · Previous version: 2.10.0
The Up Next scroller can outline its text and fill it with a gradient. Busy music videos behind the lyrics no longer swallow the singer list.
Config ▸ Display ▸ Scroller ▸ Outline. Tick Outline Text, pick a colour and drag Thickness from Thin to Thick. The outline is a share of the font size, so it looks the same in a small window and fullscreen on the projector. It sits behind the letters and never covers them.
Config ▸ Display ▸ Scroller ▸ Colors ▸ Fill now has three choices:
- Solid Color is how the scroller has always looked.
- Gradient runs a colour ramp down every letter, top to bottom. Twelve presets are built in (Sunset Shore, Chrome, Gold Bar, Fire, Ice, Neon Miami, and more), and a live preview strip shows each one. Import .ggr... loads a GIMP gradient file of your own.
- Animated is the rainbow, fire, party and other colour modes. The old gradient mode is now called Two-Color Sweep, so it isn't confused with the new gradient.
Outline and gradient work in all ten scroll styles, including Matrix, Wave and Flip. If you had an animated colour mode set, it comes up as Animated after the update and looks the same as before. Everyone else's scroller is unchanged until they turn something on.
The scroller is the right size fullscreen. Going fullscreen and back no longer leaves the scroller text sized for the wrong window, and proportional scaling no longer overwrites the font size you set by hand.
CD+G lyrics over a music video or visualizer let the background show. On many discs (every Chartbuster disc among them) the lyric screen's solid background covered the video completely. QUP now works out each disc's real background colour when the song loads, so the video shows through.
Doubled or scrambled graphics on some discs are cleaned up. Some discs store their graphics twice or carry stray data, and QUP drew all of it on top of itself. Corrupt tiles that used to spill garbage onto the next row are now skipped.
A song with no graphics file no longer replays the last song's lyrics. The lyric window stays blank instead.
Smoother picture. The lyric and video display now refreshes 30 times a second instead of 15.
Leaving fullscreen no longer leaves the picture stuck in a corner. Lyrics and video resize to fit the window again.
Music video backgrounds play at normal speed. Background videos played about ten seconds of footage too fast, jumped back and repeated for the whole song. They now follow the song in real time, and a video shorter than the song loops cleanly. DJ mode's video window gets the same fix.
MIDI karaoke lyrics are sharper on large screens. They are drawn at the screen's real size instead of being stretched up.
Experimental: CDG Enhancement. A new plugin that redraws CD+G lyrics at the projector's full resolution is included, but it is switched off and not production quality yet. It is labelled that way in Config ▸ Plugins. Leave it off for shows.
For plugin developers: a new, experimental CdgLyricPlugin interface. See
the Plugin API.
Linux portable zip: it now contains only qup.sh. On Windows, use the
installer.
QUP Karaoke Engine — v2.10.0
Released August 21, 2026 · Previous version: 2.9.1
The new YouTube plugin turns a link into a karaoke track. Find a video in your own browser, copy the address, paste it into QUP with the artist and title, and it downloads and lands in your karaoke library ready to queue.
You search in your browser, not in QUP. There is no embedded search box, no Google account, no API key and no quota to run out of. You already know how to find a video; QUP's job starts once you have the link.
Media Library ▸ Plugins ▸ General ▸ YouTube, with two tabs.
Import is the list you build. Paste a URL, type the artist and title, press
Add — youtube.com/watch, youtu.be, /shorts/, m. and music. links all
work, and a link that happens to be part of a playlist just adds that one video.
Add ten songs without touching the mouse: paste, tab, tab, Enter. Then press
Download All and watch them drain, one at a time so a venue's wifi stays usable.
History is what you have already pulled — searchable, and exportable as a small text file. That file is also an Import list, which is the whole point: export your history, send it to a friend, and they can import it and download the same set. It travels fine through email, Discord or a pastebin.
Files are named to the AKDJ standard your library already understands —
\YouTube\<video id> - Artist - Title.mp4 — so the save folder's own name
becomes the disk, and a plain library scan finds them correctly even if you turn
the automatic import off. Sharding by night or event needs no setting: just point
it at a different folder.
It knows what you already have. Adding a video that is already in your library is caught before you download it a second time — and it stays caught if you have moved the file, renamed its folder, or got it from somewhere other than this plugin.
Fix a typo whenever you notice it. Edit the artist or title on a row that has already downloaded and the file is renamed and your library updated to match, so a misspelling never gets stuck on disk. Took it at 720p and wanted 1080? Change the quality and re-download that row.
Quality is a ceiling, not a demand. Pick 1080p, 720p or 480p; a video that only exists at 480p still downloads rather than failing. Everything is video with its audio — the plugin will not silently hand you an audio-only file that plays as a black screen.
Downloads never leave a mess. Half-finished files are written to a scratch folder and only moved into your library folder once complete, so a library scan can never index a partial download. Cancel a download and nothing is left behind. Neither Clear button ever deletes a downloaded file, and both say so.
You supply the links; the plugin is a download client, exactly as the Music Video and Karaoke Maker plugins already are.
Also in this release
Song stores can finally tell whether you already own something. The plugin API has been able to ask "is this song already in my library?" since the SongShop work, but nothing an import wrote ever answered it — the store id was being dropped on the way into the database. It is now stored, which switches duplicate detection on for SongShop and Party Tyme as well as for YouTube. Nothing you have to do; it simply starts working.
If a download fails, QUP now tells you why. Age-restricted, members-only, geo-blocked, private, removed, or the downloader being too old for YouTube's latest change — each one gets a plain sentence instead of an error code. The Import tab also shows the downloader's version and warns when it has aged past the point where YouTube usually breaks it.
QUP Karaoke Engine — v2.9.1
Released August 21, 2026 · Previous version: 2.9.0
QUP is now $10. You pay it once, and it covers every version for life.
That is the entire release. No engine, audio, DJ, rotation or cloud behaviour changed — only what a licence costs and how long it lasts.
If you already own a licence, it is now a lifetime licence. Keys sold under the old $60 terms were tied to the major version they were bought for, plus two — a v2 key would have stopped working at v5.x. That ceiling is gone, retroactively, for everybody. There is no new key to collect and nothing to re-import: install 2.9.1 and the key you already have simply never expires again. The "your licence key needs an upgrade" screen no longer exists, because nothing can reach that state any more.
What has not changed. The 60-day evaluation period stays exactly as it was, and so does the reminder screen. QUP is still shareware and still completely uncrippled while you evaluate it — no disabled features, no timers, and it still doesn't phone home. Licence keys are still signed on our server and verified offline by your copy of QUP.
Buying now actually sends you a key. The link between our payment processor and the licence server had never been connected, so every key issued to date was cut by hand. That is wired up, secured and tested end to end as of this release — your key arrives by email within a minute of paying. If it ever doesn't, mail licenses@qupkaraoke.com and we will send it straight over.
QUP Karaoke Engine — v2.9.0
Released August 20, 2026 · Previous version: 2.8.4
The DJ side of QUP grows up. This release adds the whole hands-on performance surface, and teaches Auto DJ to mix six different ways instead of one.
New — the PERFORM pane. Eight pads across four modes on each deck: hot cues, beat loops, loop rolls, and buffer rolls. Loops engage, resize and release the instant you press, and a SLIP switch lets a loop play over a track that never stopped moving — so letting go drops you exactly where the track would have been, and a trick can last as long as it is interesting rather than as long as the phrasing allows. Each deck also gains two effect slots, a send, and a transport row (brake, spinback, stop, start).
New — Auto DJ picks a transition to suit the tracks. Instead of one timed crossfade for everything, it now chooses between a bass swap (highs, then mids, then bass — the crossfader never moves, so it sounds mixed rather than faded), an 8-bar filter-and-loop build, an echo out, a beat cut, a filter fade, and the plain crossfade. It never plays the same move twice in a row, and when two tracks are too far apart in tempo to beatmatch, the result now sounds deliberate instead of like a compromise.
New — Auto DJ stops playing dead air. It starts the next transition before a silent outro rather than after it, and it starts the incoming track where its level actually matches the one going out — so a track that opens with thirty seconds of quiet no longer drops the floor out of the mix.
New — eight DJ effects: filter, echo, reverb, roll, gater, flanger, phaser, and a three-band kill isolator. A single STOP FX button clears every effect on a deck at once. An effect that is switched off is bit-for-bit silent, not merely quiet.
Fixed — beatmatched transitions could jump in tempo at the very end, on the surviving track, at the moment it became the only thing playing. The same underlying cause could also make Auto DJ quietly fall back to a simpler transition than the one it should have used. Both traced to a beatmatch confirmation set tighter than the tempo chase can physically reach.
Fixed — a failed track load could delete the track that was playing. Dropping a damaged MP3+G onto a deck cleared that deck's working folder before checking the file was readable, and a load that failed part-way left the deck still reporting the track it had just unloaded.
Fixed — .flac files showed no waveform. The waveform reader was asking a decoder that cannot read FLAC at all, while playback used one that can. This also fixes m4a, aac, opus and wma.
Fixed — scanning a filler folder froze the app while it worked, and wrote to its database once per track rather than once per scan. Scan result dialogs also opened behind the main window.
Fixed — three separate ways to lose a playlist: a failed read could destroy the playlist it failed to read, the "New list" menu item silently emptied the open one, and edits made from another pane were reverted by the next edit.
Also improved — the DJ crate supports Ctrl-A and shift/ctrl click, and Remove clears the whole selection. The tempo fader's double-click reset now glides over two bars of the track's own tempo, and Auto DJ uses the same glide to return a track to its natural speed after a beatmatched mix — previously the incoming track kept the outgoing track's tempo for its entire length, so across an unattended set every song drifted further from where it started.
QUP Karaoke Engine — v2.8.4
Released August 17, 2026 · Previous version: 2.8.3
- Fixed — venues with very large song libraries (100,000+ songs) could silently fail their first cloud sync, leaving kiosk and mobile song search empty for that venue with no error shown. Large-catalog syncs are now batched on the server and given more time to complete.
- Improved — library rescans now let you review and export the list of files that couldn't be imported (missing lyrics file vs. unsupported format), instead of just a bare count.
QUP Karaoke Engine — v2.8.3
Released August 16, 2026 · Previous version: 2.8.2
- Fixed — a song a KJ added or replaced for a registered singer never notified their phone. Push notifications only ever fired for songs the singer submitted themselves through the app; if the KJ entered or swapped a song for them from the QUP side, their "you're up next" alert silently never arrived. Both iOS and Android are affected the same way and both are fixed by this release.
QUP Karaoke Engine — v2.8.2
Released August 14, 2026 · Previous version: 2.8.1
- Fixed — DJ mode's crossfader was dead on a fresh install, on every platform. New installs (and anyone who had never touched the old karaoke crossfade settings) opened DJ mode to a crossfader that did nothing, with no way to turn it on from the DJ screen itself.
- Fixed — on macOS, DJ mode's lyrics could flicker or drop to black for an instant, due to a rare timing issue in the video compositor.
QUP Karaoke Engine — v2.8.1
Released August 12, 2026 · Previous version: 2.8.0
- Fixed — the MilkDrop visualizer could fail to load on Windows. On some installs it would silently fall back to plain lyrics instead of the projectM visuals, with nothing on screen indicating anything had gone wrong.
QUP Karaoke Engine — v2.8.0
Released August 12, 2026 · Previous version: 2.7.0
- New — DJ mode. QUP is now two apps in one: karaoke, and a real two-deck DJ mode, switchable from the same install. Two decks with waveform seek, tempo control, per-deck EQ, and a proper pre-fader cue bus. Beatgrids and SYNC keep tracks locked together; scratch behaves like a real platter, including catching a track mid-throw. A constant-power crossfader blends between them, and MP4 video decks bring the same experience to video mixing, sharing the same GL visual layer.
- New — Auto DJ. Set-and-forget, beatmatched automatic mixing: build named crates from folder drops, m3u imports, or a genre fill, then arm it and it keeps going, yielding control back to you with one touch whenever you want it.
- New — FLAC and OGG playback, on both the karaoke and DJ sides.
- New — MilkDrop starter preset pack, so the visualizer has real presets to show on first boot instead of the 37 plain engine test presets. A "Download the Cream of the Crop pack" button pulls in a larger curated pack in one click. Presets can now be grouped into playlists and ticked to shuffle only from a subset.
- New — first macOS Apple Silicon (M-series) build. Previous releases ran under Rosetta; this one runs natively.
- Improved — cold start is faster. QUP now runs on Java 25 — DJ mode starts about 28% faster and karaoke about 20% faster than the previous release.
- For plugin developers —
VisualizationPlugingained direct GL rendering (supportsDirectGl(),glAdopt(),glRenderFrame(),glRelease(),publishHostFrame()) for visualizations that already draw in OpenGL, skipping the per-frame image readback.PluginContext.isDjMode()lets a plugin tell whether the room is in karaoke or DJ mode and gate its own menu entries accordingly. Full reference on the Plugin API page.
QUP Karaoke Engine — v2.7.0
Released August 7, 2026 · Previous version: 2.6.1
- New — MilkDrop visuals behind the lyrics. QUP now runs real MilkDrop
.milkpresets as a background, through projectM. It reacts to the song the room is hearing, and to the filler music between songs. Windows, macOS and Linux. Turn it on under Media Library → Plugins → Backgrounds → MilkDrop, where there is a live preview of exactly what the projector will composite behind the words. - New — preset controls. Pick a preset from the list, jump to the next or a random one, or let it cycle on a timer with optional shuffle. Turning cycling off pins the preset you chose. A search box narrows the list, which matters: a full MilkDrop pack runs to about ten thousand presets.
- New — preset playlists. Group the presets you like into named playlists, then tick one or more to shuffle only from those. Nothing ticked plays everything. Playlists are plain text files you can hand-edit if you prefer.
- QUP ships only projectM's own test presets, which are deliberately plain. Point the plugin at a downloaded MilkDrop preset pack under its settings to get the real thing.
- New — a master dim for whatever is drawn behind the lyrics, applied on top of a background's own brightness. The preview shows the dimmed result, so "will the words still be readable" is answerable before the song starts rather than after.
- Improved — backgrounds now composite at 30fps instead of 15. A pre-recorded video mostly survived the lower rate; anything reacting to the music did not, and looked like a slideshow no matter how fast it was actually drawing.
- Fixed — column widths and column order are now remembered on every list in QUP. Two of them saved their layout properly; four more saved part of it — the Rotation and Singer Database, for instance, kept column widths but forgot any reordering — and the rest saved nothing at all. Every list now remembers both, and layouts are saved as you adjust them rather than only on a clean exit.
- Fixed — an existing saved column layout is carried over, so widths and ordering you have already set are not reset by this change.
QUP Karaoke Engine — v2.6.1
Released August 7, 2026 · Previous version: 2.6.0
Hotfix. If you are on 2.6.0, update.
- Fixed — QUP could freeze on startup. The lyrics window appeared but the main window never did, and the app sat using a full CPU core. This was introduced in 2.6.0 by the fix that made collapsed Media Library folders stay collapsed: restoring the saved folder state could get stuck in a loop while plugins were still loading, leaving the interface unable to finish drawing. Whether it happened depended on which folders you had collapsed and on plugin load timing, so it did not affect every 2.6.0 install — but where it did, QUP would not start at all.
Nothing else has changed since 2.6.0.
QUP Karaoke Engine — v2.6.0
Released August 6, 2026 · Previous version: 2.5.0
- New — background visualizations. Whatever is drawn behind the lyrics is now one kind of thing you pick from, in Config → Plugins → Background Visualization, and only one can be active at a time. Music Video Backgrounds is the first of them; "None" gives you plain lyrics. The picker appears once you have a visualization installed.
- New — "Start videos with audio". Karaoke tracks often open with a second or two of silence before the music, and the video used to start with the file and stay that far ahead of the song the whole way through. QUP now holds the video on its first frame until it actually hears the karaoke, then starts it in step. On by default, and it does nothing on tracks that start immediately.
- Fixed — the video brightness slider did nothing. Music Video Backgrounds has had a "Video brightness" control that was saved but never reached the projector — the brightness was fixed in code. It works now, and takes effect while you drag it rather than on the next song.
- Fixed — auto-crossfade in Silence mode could stop working entirely. Raise the CUT slider past about halfway and the silence and resume detectors overlapped and cancelled each other out, so filler never came up in the gaps. Near the top of the range it was worse: filler never ducked at all and played over the whole song. Silence mode now behaves across the full range of the slider.
- Fixed — the CUT threshold line on the meter lines up with the CUT slider across its whole travel.
- Fixed — the list font size no longer resets on the Playlist and Rotation after a restart. The size was always saved correctly; those two panes simply never picked it up when they were built, so they came back at the default until you touched the setting.
- Fixed — Media Library folders you collapsed stay collapsed. They were reopened on every launch. Folders nested inside others — the Audio and General groups under Plugins — could not be remembered at all before, and now are.
- Fixed — the Internet Radio station sync stops cleanly when QUP closes, instead of continuing to download into a database that is shutting down.
- Changed — the row order list and height weight boxes are gone from Skin & Layout. They stopped doing anything in v2.0.27, when the main window moved to dockable panes — reordering wrote a setting nothing read back. Arrange panes by floating and docking them and by dragging the divider. Skin selection and font size are unchanged.
- For plugin developers — new
VisualizationPlugininterface for drawing behind the lyrics,PluginContext.setKaraokeAudioTap()for the decoded karaoke stream, andstartVideoWithAudio()/getVideoDimLevel()onPlaybackListenerPlugin. All have defaults, so existing plugins need no changes. Full reference on the Plugin API page.
QUP Karaoke Engine — v2.5.0
Released July 31, 2026 · Previous version: 2.4.1
This release is about one thing: settings you changed that QUP then forgot. If you have ever set something in the control panel, come back later and found it reverted, this is the release that fixes it.
- Fixed — control panel settings now save when you close the window. Several sections only wrote their settings when you pressed an Apply or Save button. Change something, close the window, and the change was quietly thrown away. This affected Cloud, Kiosk Security, Discord Party, OBS, Music Video and SongShop.
- Fixed — disabling the Discord Party plugin now sticks. Unticking "Enable Discord room automation" and quitting brought it back enabled on the next launch, because that setting was only written by the Save button.
- Fixed — the list text size under Skin & Layout stopped resetting. Your chosen size was being saved correctly all along, then overwritten with the default every time QUP started and every time you changed skins.
- Fixed — Skin & Layout could not save at all. The section was added to the control panel in a way that discarded it, so nothing in it could be persisted.
- Fixed — "Enable Kiosk Song Purchase" never recorded its own setting. It silently followed whatever the main Tricerasoft enable was set to.
- Fixed — the Tricerasoft auto-up credit limit dropped the last digit you typed, and ignored pasted values entirely. Entering 50 stored 5.
- Fixed — the two database backup checkboxes showed each other's setting after a restart, so correcting one silently flipped the other.
- Fixed — the Enable DBV checkbox for kiosk 4 never showed its saved setting, and kiosk 3's box showed kiosk 4's.
- Fixed — a configured Discord announcements channel could be erased. If QUP saved while the Discord bot was not connected, the empty channel list overwrote your setting with a blank.
- Fixed — your SongShop login could be destroyed if the stored password could not be read back. QUP now leaves unreadable saved credentials alone instead of overwriting them with blanks.
- Fixed — in SongShop, a download folder typed and then locked was discarded, with no way to re-enter it because locking makes the panel read-only.
- Fixed — a crash on the kiosk screen when kiosk 1 was connected and kiosk 2 was not.
- Improved — settings save when you close the control panel, not only when QUP exits. A show runs for hours, and a crash or a forced quit previously lost everything you had changed since launch.
- Improved — the Internet Radio station sync now stops cleanly when QUP closes. It used to keep downloading and writing to the station database during shutdown, which could leave the station list half-updated.
- Improved — the rotation debug log records the rotation order each placement was judged against, making it possible to see exactly why a singer landed where they did.
- For plugin developers —
QUPPlugingainsonConfigPanelClosed(), called whenever the config window closes and again just beforeshutdown(). Persist settings there instead: plugins taking more than 3 seconds to shut down are abandoned, which can kill a save. It has a default empty implementation, so existing plugins need no changes.
QUP Karaoke Engine — v2.4.1
Released July 31, 2026 · Previous version: 2.4.0
- Fixed — "Min singers in playlist" now actually works. This setting was saved and shown in Config → Bribe but never enforced. Bribing now stays switched off until that many different singers have a song waiting, so nobody can buy their way up a near-empty rotation. Singers see the reason on the kiosk and phone instead of an empty list. Leave it at 0 for no minimum.
- Fixed — a dead session could bounce the next patron straight back to the scan screen. When a phone session expired, the "session gone" response was being cached by the browser and replayed to the next person who scanned on that device, kicking them out on their first refresh. Fixed on the server, so it no longer depends on the app being up to date.
- Improved — the touchscreen kiosk greys out slots it cannot sell. Positions blocked by your bribe rules now show greyed with LOCKED in place of the price, and tapping them does nothing, matching what the phone app already did. Requires the updated kiosk download.
QUP Karaoke Engine — v2.4.0
Released July 31, 2026 · Previous version: 2.3.1
- New — you decide what a bribe is allowed to jump. Some songs in the queue are protected: ones you dragged into place, ones someone already paid to move, singers who have waited past the maximum wait time, and the locked top of the queue. Each of those now has its own switch in Config → Bribe, plus its own cost multiplier, so a jump can be expensive rather than impossible. A song carrying more than one protection needs all of them enabled and is priced at the highest single multiplier — premiums never stack.
- New — counter-bribes are back. A singer can pay to jump ahead of someone else's paid jump, so the top slot stays for sale all night and whoever wants it most keeps paying. On by default at a 2× premium; turn it off in Config → Bribe if you would rather a paid jump be final. The sniped singer keeps their place relative to everyone else.
- New — "Highest bribe position" actually works. This setting was previously saved but never enforced. Set it to 1 to allow bribing all the way up to the next singer, or to a higher number to keep the top of the queue off the market. 0 means no cap.
- Fixed — new singers were losing their turn to bribed songs. With new-singer preference switched on, a first-timer was queued behind every song that had been bribed up, because a paid jump was being treated exactly like a KJ lock. A first-timer can now be placed ahead of a paid jump, which simply moves down one spot and keeps everything else it bought. There is a switch for this in Config → Bribe if you prefer money to always win.
- Fixed — bribes from the kiosk never went through. Every bribe submitted from the touchscreen kiosk failed with "Playlist has been updated, please try your bribe request again," no matter how many times the singer retried.
- Fixed — bribes from phones charged the wrong amount. Bribes submitted through the mobile app were deducting a small fraction of the real price, and the "not enough credits" check was not working. Both now charge and check correctly. If you run the paid bribe system, expect bribe charges to look right for the first time — which means noticeably higher than they have been.
- Improved — singers can see what they cannot buy. Positions blocked by your settings now appear greyed out on the kiosk and phone with a short reason, instead of being offered and then refused after payment. The prices shown are the prices the system charges.
QUP Karaoke Engine — v2.3.1
Released July 31, 2026 · Previous version: 2.3.0
- Fixed — rotation order is now exactly right. The singer rotation now strictly follows the proven rotation rules: new-singer priority actually takes effect, a first-timer's first song can't be jumped by a regular, and a returning singer whose songs were removed re-enters the current round instead of being pushed to the back. The rotation round can also no longer jump backward mid-night — this was behind singers appearing to sing back-to-back while others waited.
- Changed — the Queue and Rotation panels no longer sort by clicking column headers. What you see is always the true play order. Sorted views looked harmless but silently made drags, moves and right-click actions hit the wrong entries. The search box still filters as before.
- Fixed — song counters stay truthful. Removing, reverting or toggling a song as played kept phantom counts on the singer, quietly placing their next song in the wrong round.
- Fixed — bribe jumps respect protections. A paid jump is refused if it would displace a locked, protected or already-played entry.
- Fixed — Rotation panel right-click. "Remove From Rotation" and "Change Singer Name" work again.
- Under the hood. Every one of these rules is now enforced by an automated full-night rotation simulator that runs on every build.
QUP Karaoke Engine — v2.3.0
Released July 29, 2026 · Previous version: 2.2.0
- New — Discord Party. Run your karaoke night in a Discord voice channel and let QUP moderate it for you. QUP moves an "On Stage" role as the rotation advances, so only the singer whose song is playing can talk. The room opens between songs and for a short applause window at each end of a song, so people can cheer without talking over the performance. Singers claim their name with
/iamin Discord — they enter their name and PIN in a private dialog only they can see. Configure it under Config → Plugins → Discord Party; there's a full setup guide in the documentation. - New — automatic handling of missing singers. If the person whose turn it is isn't in the voice channel, QUP pauses the song, pings them, and gives them a grace period to appear. If they turn up it resumes; if they don't it moves on to the next singer, exactly as if you'd pressed Next. An unattended room keeps running.
- New — filler music into Discord. Optionally, QUP transmits your filler music into the voice channel between songs, so the room isn't silent while nobody is sharing their screen.
- Fixed — microphones on macOS. Mic input didn't work at all on macOS: the app was missing the microphone entitlement, so the system blocked it without ever prompting. Also fixed a crash when changing microphones, and mic effects now work when your microphone and speakers are the same audio interface.
- Fixed — songs queued from a phone ignored your rules. Max Singer Repeat and the closing-time cutoff were being bypassed for anything queued through the mobile or web path — one singer could fill the whole list. Songs queued by the KJ are unaffected and still override the limit as before.
- Improved — singer PINs now reach the venue. A patron who signs up on their phone gets their PIN synced to your local singer database, so it works at the venue too. Existing singers pick theirs up the next time they sign in on their phone.
- Improved — documentation. New guides for Discord Party, MIDI Karaoke, Mic Effects, AutoFiller, Genre Tagger, Internet Radio, the Metadata Editor and the Plugin Manager. See Documentation.
QUP Karaoke Engine — v2.2.0
Released July 25, 2026 · Previous version: 2.1.4
- New — MIDI & Soft Karaoke (.mid / .midi / .kar). QUP now plays MIDI karaoke files through a built-in SoundFont synthesizer, with the lyrics on your projector and preview screens exactly like CDG — highlighted word-by-word as the song plays. A General MIDI SoundFont is bundled, so MIDI songs play out of the box, and you can import
.mid,.midiand.karfiles straight into your library. - New — per-instrument MIDI mixer (Media Library → Audio). Live VU meters and a volume knob for every instrument, mute the guide-vocal track for a true sing-along, switch SoundFonts on the fly, and save a custom mix per song. A built-in catalog lets you download hundreds of additional SoundFonts.
- New — full MIDI transport. Key change (transpose), tempo, and seek for MIDI — all gap-free, no dropouts — and the music-video background now works with MIDI too, compositing the lyrics over the video.
QUP Karaoke Engine — v2.1.4
Released July 24, 2026 · Previous version: 2.1.3
- New — Mic Effects tempo sync. Lock the mic echo/delay to the song's tempo (BPM). Tap the beat or let QUP auto-detect it, choose a note value (1/2 · 1/4 · 1/8), and the echo stays in time with the music. You can also save per-song mic-effect presets that load automatically when the song starts.
- New — Analyze BPM in the Genre Tagger detects and stores the tempo of your whole library, so the mic echo is in sync the instant a song starts. QUP also fills in tempos in the background when nothing is playing.
- Fixed — microphone inputs on macOS and Linux. The mic input picker now works on Mac (Core Audio) and Linux (ALSA/PulseAudio) — previously those platforms listed no microphones at all. Added an input driver selector that matches the audio-output settings.
QUP Karaoke Engine — v2.1.3
Released July 23, 2026 · Previous version: 2.1.2
- New — Mic Effects. Add reverb and echo to your microphones, right from the Media Library (Plugins → Audio). Wet-only, and it works with whatever sound device you use.
- The projector QR-code size slider now resizes the code across its full range (previously the change was barely visible).
- Turning on "Show Wait Time" no longer blows up the up-next scroller text size.
- Config-panel drop-down menus now display with the correct light theme.
QUP Karaoke Engine — v2.1.2
Released July 23, 2026 · Previous version: 2.1.1
- Security vulnerability hotfix — a recommended update for all users.
QUP Karaoke Engine — v2.1.1
Released July 23, 2026 · Previous version: 2.1.0
A quick follow-up to 2.1.0 with a handful of fixes:
- macOS — the app now launches on a clean Mac. The 2.1.0 DMG could fail to start at launch on machines without certain developer tools present; the runtime is now fully self-contained.
- Fixed a "Could not create the Kiosk Song Database" error on macOS after scanning your library.
- Fixed password fields showing their contents as plain text instead of dots across the settings panels — including OBS and SongShop.
- The license import / registration window now always opens on top, so it can no longer get stuck behind the main window.
- Karaoke Maker — added an optional "Allow CPU encoding" fallback, with clear plain-English messages when the GPU encoder is busy.
- New: QUP now checks for updates and shows a "New Version" notification when one is available.
QUP Karaoke Engine — v2.1.0
Released July 21, 2026 · Previous version: 2.0.55
This is a big one. QUP now runs natively on Linux, ships signed and notarized installers on every platform, and adds music video backgrounds behind your CDG lyrics. Full details below.
🐧 Linux support (new)
QUP now runs natively on Linux in three flavors:
- AppImage — single file, double-click to run, no install required. Self-installs a desktop and applications-menu shortcut on first launch.
- .deb — native Debian/Ubuntu package. Installs to
/optand adds a menu entry. - Portable zip — bring-your-own Java 21, for the widest range of distributions.
All three include the native audio engines built for Linux — SoundTouch key change, ysfx graphic EQ, and PortAudio device I/O. They're built against an older glibc so they run on essentially any distribution from 2022 onward (Ubuntu 22.04+, Debian 12+, Fedora 35+, RHEL/Rocky 9+).
Verified end to end: real karaoke playback (audio, CDG lyrics, key change, and EQ), filler MP4 video, and music-video backgrounds all working on Linux.
🔏 Signed & notarized installers
No more scary download warnings.
- Windows — the installer is now signed with Azure Trusted Signing (Authenticode, timestamped), so you'll see far fewer SmartScreen warnings.
- macOS — full macOS support arrives this release with a signed, Apple-notarized, and stapled DMG that passes Gatekeeper cleanly (just drag to Applications). The app bundles its native audio engines, and a series of macOS-specific fixes landed: a startup crash on read-only install directories, an invisible maximized window on the second launch, the kiosk HTTPS keystore path, config persistence, and a self-contained yt-dlp.
🎬 Music video backgrounds (new)
Play music videos behind your CDG lyrics. QUP automatically downloads the matching video (video-only, with the artist included in the search), prefetches your entire upcoming queue, and starts the background mid-song the moment its download lands. The video is composited behind the lyrics with the CDG on top, and it's performance-tuned to avoid per-frame allocation.
🎵 Audio & A/V sync
- Video karaoke / MP4 — audio is now the master clock, fixing audio/video drift.
- CDG lyrics are slaved to the audio clock in absolute terms (off the UI thread) with output-buffer latency compensation, so lyrics stay locked to the music.
- CDG timing offset is now deterministic at startup and persists across restarts.
- Seek is reliable and immediate on both the karaoke and filler players — fixed backward-seek jumping to the next song, playhead jumps, and tempo-shift position errors.
- ASIO — karaoke and filler are now summed onto a single shared mains bus/pair for clean pro-audio routing.
- Crash fix — skipping a song could crash the app due to a native heap corruption during PortAudio teardown. Fixed.
- The native graphic EQ (ysfx/JSFX) is now active in the packaged builds.
- Removed the old LibVLC/vlcj video backend; JavaCV/FFmpeg is now the single video path.
🪟 Windowing & docking (Winamp-style)
- Per-window controls (quit, hide, shade) and a system-tray presence.
- Dock and undock all three sections together (all-or-nothing), with z-order and focus fixes — no more flicker, the focused window stays on top, and the whole workspace can go fully undocked and hide the main frame.
- Single-instance guard — only one copy of QUP runs at a time.
- The app and taskbar icon is now the QUP brand (previously a generic icon), including on floating windows.
- The exit confirmation dialog now reliably appears over the transport controls.
🎨 Config panels
Fixed the dark skin leaking into config panels. Tables, checkboxes, text fields, sliders, scroll bars, and combo boxes now render correctly, and text boxes look properly sunken.
🔌 Plugins
- AutoFiller v2.0 — a from-scratch redesign.
- Genre Tagger — now writes genre to MP3 ID3 tags (not just the database), reads artist/genre/album from filler ID3 on import, and adds a "Rescan filler ID3" backfill.
- Metadata Editor (new) — right-click tag editing plus "Explore item".
- File Management — added a Path column (right-aligned, leading-ellipsis so the containing folder stays visible; auto-grows to fill), "Remove from library" and "Delete from disk" right-click actions (also on the core libraries), and several new karaoke/CDG filename import and rename formats.
- Internet Radio — plugin source added.
- SongShop — configurable download folder.
- Plugin Manager — enable and disable plugins (restart to apply).
- AutoFiller and Genre Tagger are now surfaced as Media Library tabs, with M3U playlist support and a library right-click menu API.
👤 Singer management & library
- The Singers Database now has a visible home under Singer Management, where the KJ can edit singers and adjust credit balances.
- The Media Library tree has been reordered — Local Library first, then Singer Management.
📁 File dialogs
Native OS open, save, and folder dialogs (via JavaFX) now replace the old Java choosers.
☁️ Cloud
Now-singing info is emitted in the cloud poll, and PHOTO downloads resolve the configured cloud host.
This release covers 127 commits from April 25 to July 21, 2026.
Note: v2.0.54 was tagged but never released — the build failed at compile time due to an ambiguous-overload bug in the new file chooser API. v2.0.55 is the working release with the native file dialogs.
v2.0.55
Added
- Native file and folder pickers across the entire app. The Add Folder, Add Files, Browse, Save, and Import dialogs now use the platform's native file picker —
IFileDialogon Windows 10/11,NSOpenPanelon macOS,GtkFileChooserNativeon Linux. On Windows you get the full File Explorer–style picker with the This PC sidebar, address bar with breadcrumbs, recent folders, pinned locations, and OS theme support (light/dark mode follows your Windows setting automatically).
Changed
- Plugin SDK: file chooser API replaced with action-oriented methods (
openFile,openFolder,openFiles,saveFile) that return the selected file directly. Plugin authors no longer configure a chooser before showing it. - Database singer-list import simplified to use a CSV-only filter (the previous mixed files/directories mode was vestigial; the call site only ever consumes CSVs).
Removed
- Internal cpanel theming sweep for file chooser widgets — no longer needed now that file dialogs are rendered by the OS.
v2.0.53
Changed
- File chooser theming for plugins now flows through the plugin SDK (
PluginContext) rather than direct internal references. Genre Tagger, File Management, and Karaoke Maker plugins migrated to the SDK factory methods. Lays groundwork for future picker improvements without touching plugin code.
v2.0.52
Fixed
- File chooser dialogs no longer have dark Folder Name fields or Files of Type combo boxes. Both widgets now render with white backgrounds and black text, matching the rest of the file picker. Affects the Media → Add Folder, Database → Browse, Music Video → Cache directory, and License chooser dialogs.
v2.0.51
Fixed
- Number spinners across all configuration panes now render with white backgrounds and black numbers instead of solid black rectangles. Affected widgets included Auto-pause threshold (Kiosk Security), Max cache MB (Music Video), Intro duration (OBS Recording), Min queue depth and No-repeat window (AutoFiller), height-weight spinners (Skin & Layout), and the Simulation engine spinners.
- Scroller's editable font combo box now displays the currently selected font name in black on white — previously the selection box was unreadable.
- Configuration table column headers (Media Library Folders "Folder" / "Filler" headings) now display in black text instead of blue.
- Empty tables (Kiosk Security pattern filter table) no longer fill with dark color when there are no rows.
- Spinner up/down arrow buttons render consistently as flat-style buttons matching the rest of the cpanel.
v2.0.50
Added
- Flat WACUP-style arrow buttons for combo box dropdowns and spinner up/down controls. Matches the existing flat-button styling for regular cpanel buttons.
v2.0.49
Fixed
- Cpanel tables, lists, and trees now have white backgrounds (previously appeared as dark holes when empty — most visible in the Bribe singer list and Kiosk Security pattern table).
- Non-editable combo box dropdowns display items in black-on-white rather than dark colors. Affects Output settings, Kiosk Security drop-downs, and Scroller selection menus.
- Spinner inner text fields correctly render with white backgrounds.
v2.0.48
Added
- Custom flat-button rendering for cpanel buttons. Buttons now have a raised bevel with hover and pressed states, matching the WACUP visual style.
v2.0.47
Fixed
- Cpanel text labels, buttons, and checkboxes no longer render in blue on light backgrounds — foreground text is now correctly black throughout the configuration panel.
- Text input fields, spinners, and combo boxes have white backgrounds across all cpanel panes (some plugin config panes were rendering dark).
v2.0.46
Fixed
- Plugin configuration panels (AutoFiller, Music Video Background, OBS Recording, Karaoke Maker, Genre Tagger, File Management, SongShop) and the Simulation pane now have consistent light backgrounds matching the rest of the cpanel. Previously these panes inherited the global dark theme.
v2.0.45
Internal
- Diagnostic release. No user-visible changes.
v2.0.44
Fixed
- Restored proper rendering of cpanel controls after the v2.0.43 theming change. Buttons now display their raised bevels, dropdowns show their arrows, and text fields have visible borders.
v2.0.43
Changed
- Cpanel light-theme implementation refactored to use a centralized override table rather than per-component color setters. More consistent and predictable theming behavior across all panes.
v2.0.42
Added
- Plugin panes that lazily construct widgets (e.g. when an "Enable" button is first clicked) now get themed automatically when new widgets appear.
NativeFileChooser.createFolderChooserconvenience method (pre-configures folder-selection mode with drag-and-drop enabled).
Fixed
- File chooser dialogs maintain the cpanel light theme more reliably when reopened.
v2.0.41 — Wait Time clock starts fresh when your song is up next
Fixed
- Wait Time now resets when a singer's next song becomes "up next." Previously, if you had two songs queued and your first song was playing, your second song's wait clock was already counting — so the moment your first song finished, your second song would show something like "10 minutes" of wait time. That was misleading. Now the clock starts at zero the moment a song actually becomes the singer's next-up turn.
v2.0.40 — Fixed "Est Time: NOW" on second singer
Fixed
- The singer in position 2 of the rotation no longer incorrectly shows "NOW" as their estimated time. Only the currently-playing singer should display "NOW"; everyone else should show how long until they're up. The calculation now accounts for remaining time on the currently-playing song. The same fix applies to the scrolling display.
v2.0.39 — Polish on the new mobile kiosk
Fixed
- Your Submissions list now displays in rotation order. Your next song to be sung appears at the top, not the most recently submitted one. Played songs and errors fall to the bottom.
- Credit balance updates correctly on the mobile kiosk. Previously the kiosk showed "$0.00" for credits even after the KJ added credits via Singer Database → Edit Singer. Now changes propagate within a second or two.
- Bribe submission errors are clearer. Instead of a generic "required" message, the kiosk now tells you exactly what's wrong.
Changed
- Bribe cost table now only shows singers you can actually skip past. Previously every singer in rotation was listed, including ones at or after your own position (which always cost $0 because there's nothing to skip). Now the list shows only actionable move-up targets.
v2.0.38 — Live kiosk state; view the full playlist; Change Song fixed
Added
- View Playlist on mobile. A new button on the patron kiosk opens the full current rotation — every singer, every song, in order. Your own entries are highlighted. See where you are, see who's ahead of you, see the big picture. Same data the KJ screen shows.
- Rotation position indicator. The kiosk now shows "You're #3 in line, 2 songs ahead" so patrons know where they stand at a glance.
- Live state refresh. The kiosk refreshes its view every 10 seconds. Songs that have already been sung disappear from "Your Submissions." Credit balances update. Bribe availability updates.
Fixed
- Change Song now actually works. The command was being silently rejected by the engine due to a name mismatch. It's been recognized now. If you click "Change Song" on a queued submission and pick a different song, the swap goes through and you see "Done."
- Played songs no longer linger on the patron's kiosk. If you sang your song and it finished, your kiosk updates within 10 seconds to show it as played, and stops offering Change Song / Bribe buttons on it.
v2.0.37 — Change Song and Bribes wired up (with caveats addressed in v2.0.38)
Added
- Change Song button on patron kiosk. Patrons can now swap a queued song for a different one — as long as their original submission hasn't been sung yet. Uses the same "verify it reached QUP" feedback flow as regular song submission.
- Bribe system on patron kiosk. Bribe-enabled venues now show a Bribe button next to each of a patron's queued songs. Tapping it shows who they can move ahead of and what it costs. Patrons select a target, confirm the cost, and the bribe is processed by the engine — which deducts credits, validates the cost, and reshuffles the rotation. KJs credit singer accounts manually via Singer Database → Edit Singer (no payment processing on the kiosk; cash-in-venue model).
- Bribe button auto-hides when bribes are disabled in the venue's Bribe configuration.
Known issues addressed in later releases
- v2.0.38 fixed the
QUEUE_REPLACEswitch-case gap that prevented Change Song from actually working end-to-end. - v2.0.39 fixed credit balance display, submission ordering, and bribe cost-table filtering.
v2.0.36 — Finally: patrons' songs actually reach the queue (and the kiosk tells the truth)
This release fixed three converging bugs that had caused silent song drops. After this, first-session fresh installs work end to end.
Fixed
- The "double CloudSync" race. On registered-install reboots, two cloud-sync workers were running simultaneously on the same install. One had the song-queue engine wired up; the other didn't. Whichever fetched a patron's submission first processed it — so submissions failed or succeeded at random. Now there's exactly one sync worker per install.
- Silent song drops. As a consequence of the above, roughly 5 out of 8 song submissions were silently failing with "Enqueue engine not ready" while the patron's phone happily showed "Submitted!" Now that the race is fixed, and combined with the ack-verify flow below, submissions are reliable.
- Catalog sync on library changes. If you registered your cloud before adding your media folder to QUP, the server-side song catalog was empty and the kiosk found nothing when patrons searched. Now, whenever QUP finishes scanning a library folder, the cloud catalog refreshes automatically — no restart required.
Added
- Submission ack-verify. When a patron submits a song, the mobile kiosk shows "Sending..." then "Verifying with host..." then — only after QUP actually confirms the song was queued — "In queue." If QUP rejects the submission, the kiosk shows "Couldn't queue" with the reason. If QUP doesn't respond within 60 seconds, the kiosk shows "Still trying... if this keeps happening, ask the KJ." No more silent success; no more patrons wondering why their song never came up.
v2.0.35 — Auto-initialize kiosk on registration
Fixed
- QR code now appears automatically within 60 seconds of completing cloud registration. Previously, even with everything else working, the kiosk token had to be manually minted by clicking "Initialize kiosk now" in the Kiosk Security settings. That step is now automatic when a venue verifies its email.
- Rate-limit friendliness for the nonce-fetch calls that precede every signed request. These are now exempt from the per-IP and per-install general buckets, so high-frequency polling no longer starves other cloud operations.
v2.0.34 — Fresh-install QR rendering
Fixed
- Cloud polling now self-starts on a fresh install. Previously, registering cloud on a brand-new install left the polling scheduler unstarted, which meant the venue's status never flipped to "active" internally, which meant the QR code URL never resolved. Fixed.
- Poll and sync rate-limit ceilings doubled. The original values were sized assuming one counter increment per request; in practice each request produced two increments, so the ceiling tripped during normal operation. Now set correctly.
Changed
- The old
/sing/patron URL is deprecated. If a patron scans an old-era QR code linking to/sing/something, they'll now see a friendly page directing them to scan the current QR on the karaoke screen, instead of getting a confusing error. The supported patron flow is/k/<token>which resolves to a cookie-persistent/s/<session>URL.
v2.0.33 — Secured cloud auth migration
Changed
- Cloud authentication fully migrated to signed requests. Previously, some cloud endpoints used a shared secret model that was prone to subtle desync bugs (secret generated on the client, secret generated separately on the server, the two never exchanged — silent auth failures). All runtime cloud endpoints now use per-install cryptographic signing. Authentication desync is structurally eliminated.
Breaking change
- Clients on v2.0.32 and earlier will need to upgrade to v2.0.33 to continue using cloud features. (Fresh installs on pre-v2.0.33 were already broken in practice due to the desync issue this release fixed.)
v2.0.32 — Multiple stability fixes
Fixed
- Cloud sync now starts immediately after registration without requiring a QUP restart. Previously, completing cloud registration correctly updated the cloud settings, but the actual sync worker wasn't started until the next app launch.
- No more "split-brain venues." If cloud registration was already complete, the app no longer attempts to re-register on restart, which was previously creating duplicate venue records server-side.
- Venue name length check. Venues named with fewer than 3 characters are now accepted (previously the registration form silently rejected them).
- Silent cloud errors now surface. Sync failures that used to go to an invisible error stream now appear in the log with full stack traces, so operators can diagnose issues.
Added
- Session ban / unban from Singer Management. The Singer Management table now lets a KJ ban a specific kiosk session (e.g., a problem patron) and reverse the ban later.
- Catalog sync progress indicator. The Media Library window shows an indicator strip during a cloud catalog sync, so operators can see the operation is in progress.
v2.0.31 — Signed request rate limit
Fixed
- Singer Management panel no longer polls continuously when hidden. It used to make signed cloud requests every 10 seconds forever, whether the panel was visible or not — about 360 requests per hour. Now it polls only when the panel is showing, and the per-install hour cap was raised to accommodate bursts.
v2.0.30 — Fresh-install UI defaults fixed
Fixed
- Checkbox defaults on first launch now match the intended values. A long-standing bug meant that even though many settings had sensible default values in code, they were silently overwritten to "unchecked" on fresh installs because the save-preferences code read from the UI state before the UI was fully initialized. The Karaoke settings panel now sets each checkbox explicitly after creation, so defaults persist correctly. Affected checkboxes include the proportional scroller toggle and eleven others.
v2.0.29 — Cloud settings persistence on registration
Fixed
- Cloud is now enabled automatically when registration is verified. Previously, a successful registration verification didn't flip the "Connect to QUP Cloud" checkbox on or save the updated state, so restarting the app meant re-enabling cloud manually.
- Production cloud configuration is now bundled with release builds. Shipped zips contain the correct live-production cloud settings out of the box.
v2.0.28 — Baseline release
The starting point for this release series. All subsequent changes above build on this.
Notable features present as of v2.0.28 (not new — included here for context)
- Crossfades between the filler playlist and karaoke songs with configurable duration.
- Async song-length scanning and database v3 migration with background backfill of missing lengths.
- Proportional CDG rendering that scales cleanly at any window size.
- Per-role equalizer namespacing (main output vs. phones output).
- Click-to-position on the global playback slider.
- QR float overlay on the CDG window.
- GenreTagger plugin (freedb/MusicBrainz metadata tagging).
- AutoFiller plugin with Enable/Disable toggle and manual "Fill Now" action.
QUP Karaoke Engine v2.0.27
The biggest UI refactor since 2.0 — the main window is no longer a fixed layout. Each major section can float, dock, and snap freely. Plus a ton of polish throughout.
Dockable windows
The Player, Media Library, and Playlist are now independent panes. Dock them in the main window or pop them out to float wherever you want. Drag title bars to move, and floaters snap to each other at the edges when dragged close. Clicking any one floater brings the whole group to the foreground so nothing gets buried behind another app. Each window can be set "Always on Top" independently, and layouts persist between sessions.
Media Library redesign
A left-side navigation tree now covers Rotation, Local Library (Karaoke + Filler), and Plugins. Each library has its own "Add to Library" button with Add Folder / Add File(s) — fast imports no longer require a detour through Preferences. When docked, a draggable divider between Media Library and Playlist lets you size each one to taste.
Filler playlist overhaul
The filler queue finally behaves like it should — currently-playing is pinned at the top, tracks disappear after they finish, and the NOW indicator actually points at what's playing. AutoFiller keeps topping things up whenever the queue runs low.
Right-click everywhere
Right-click almost any title bar, list view, or empty chrome area to get a shared menu with Dock/Undock, Always on Top, AutoFiller, Genre Tagger, Send Message, New Session, Preferences, Singer Database, and Exit. No more hunting for where a feature lives.
Alternating row colors
Every list view (karaoke, filler, playlist, rotation, plus every plugin table) now renders with alternating row colors for easier scanning. Right-click any list to toggle it — the setting is global and persists between runs.
Native file browsers
Open/Save dialogs now render with the native Windows look instead of QUP's dark theme. Feels much more at home when navigating your file system.
Notable fixes
- Filler Genre column is actually visible and resizable now (was being hidden by a column-index bug)
- Corner resize on floating windows works reliably on the first click, every time
- Right-click menus no longer flash and disappear when opened on an unfocused floater
- Ctrl-A in list views selects the rows you're looking at, not the navigation tree
- Transport controls stay properly centered inside the Player window at any width
- Filler library alternating colors match the rest of the UI
QUP Karaoke Engine v2.0.26
New Features
- Up Next Scroller config panel — Full settings pane for the CDG window's upcoming-singers overlay. Configurable scroll style (horizontal/vertical), animation speed, custom font and size, color mode, transparent overlay option, scroll position (top/bottom), and Cloud QR code display with position and color pickers.
- Skinned title bar — Custom-drawn window title bar that follows the active skin theme.
- MMCSS audio thread priority — Audio playback threads now register with Windows Multimedia Class Scheduler for lower latency and fewer glitches during heavy CPU load.
Bug Fixes
- Fixed right-click song queueing — "Enqueue Song" from the singer submenu was silently failing. Songs now queue correctly when selected from the right-click menu.
- Fixed cloud registration — Registration was hitting a retired server endpoint, causing "Error communicating with server" on signup. Now connects to the correct API.
- Fixed folder removal freeze — Removing a large media folder (thousands of files) no longer locks up the UI. Deletions now run in the background.
- Fixed connection leaks — Cloud sync and HTTP calls were accumulating open connections over long sessions. Cleaned up for better long-run stability.
- Fixed exit confirmation dialog — Properly sized and non-resizable.
- Reverted FlatLaf experiment — Restored Nimbus via QUPDarkLaf. EQ sliders back to 3D shaded knobs, all 10 bands visible.
Security Improvements
- Removed legacy SSL bypass that weakened encrypted connections
- Removed hardcoded credentials from source
- Hardened HTTP error handling to prevent silent failures
Under the Hood
- ~30 resource leaks patched for improved stability during extended shows
- Background processing improvements to keep the UI responsive during database operations
v2.0.25 — Architecture & Reliability
The filelist panel — the main screen where you browse and search your song library — was rebuilt from the ground up. What was a single 2,700-line file is now five focused modules handling table display, search, file importing, column preferences, and right-click actions separately. This makes the codebase easier to maintain and sets us up for faster feature work going forward.
Other improvements in this release:
- Right-click "Enqueue Song" submenu now shows all singers currently in rotation for one-click queuing, with a "More options..." fallback for the full dialog
- Bad file marking and unmarking available directly from the right-click menu based on current file status
- Multi-select support for bulk song deletion from the database
- Filler table gets its own right-click context menu with enqueue and folder browsing
v2.0.24 — Security Hardening
A comprehensive security and stability pass touching 21 areas across the engine. The highlights:
Input validation — A new centralized input validator now screens all data coming in from the kiosk web interface. Singer names, hashes, pin codes, mobile numbers, and general text fields are all checked for length limits, allowed character sets, and common injection patterns before they reach the database.
Safer data handling — Replaced the legacy XML parser with Gson for configuration serialization. Thread-safe collections now protect shared data structures that are accessed from multiple threads simultaneously. Several places where the application could abruptly terminate have been softened to graceful error handling instead.
General hardening — Path traversal protections, stricter input sanitization on HTTP parameters, and defensive null checks across the kiosk communication layer.
v2.0.23 — Performance & Polish
This release focused on fixing rough edges reported from live venue use:
- Media database loading performance improved — library scanning is noticeably faster on large collections
- Filler music crossfade behavior fixed — transitions between filler tracks and karaoke songs now blend smoothly without volume jumps
- Build size reduced by removing duplicate and unused libraries from the distribution
- First-run experience fixed — eliminated a double-restart that occurred on fresh installations
- Column layout preferences now load with proper guards, preventing crashes when saved preferences reference columns that no longer exist
QUP Karaoke Engine v2.0.23 Release Notes
Genre Tagger Plugin
Brand new plugin that tags your entire song library with genre metadata from the freedb database — over 1 million artists catalogued.
- One-click genre tagging — download the pre-built genre database from qupkaraoke.com (~45 MB), then click Tag Library. Genres appear in your media library instantly, no restart needed.
- freedb import — for advanced users, import the full freedb dump directly from archive.org (~850 MB). QUP stream-parses the archive without extracting it to disk.
- MusicBrainz fallback — songs that freedb doesn't recognize get queued for MusicBrainz lookup. Start it when you're idle — it runs at 1 query per second in the background. Pause and resume anytime.
- Persistent LED indicators — the Genre Tagger window shows green LEDs with dates for each completed step: IMPORTED, TAGGED, and BRAINZED. State persists between sessions.
- Loading screen — the Genre Tagger opens instantly with rotating fun messages while the database loads in the background. No UI freeze.
- Browse for local file — already downloaded the freedb dump? Point QUP at the file instead of downloading again.
AutoFiller Plugin
New plugin that automatically keeps your filler music playing between karaoke singers. No more dead air.
- Enable with one click from the skinned popup window — right-click any empty area and select AutoFiller
- Shuffle mode — plays through your entire filler library before repeating any track
- Repeat avoidance — set a time window so the same song doesn't come back too soon
- Genre filter — limit auto-fill to a specific genre using ID3 tag data from your MP3 filler files
- Fill Now button — prime your filler queue before the show starts
- Live status — shows queue depth and available track count in real time
Genre Column in Media Library
- Genre column added to both the karaoke and filler file lists
- Artist and Genre columns added to the filler table
- Genre data populates automatically after running the Genre Tagger
Right-Click Context Menu
- Right-click on empty areas of the main window for quick access to AutoFiller, Genre Tagger, Control Panel, Singer Database, and About
- Menu is dynamic — only shows plugins that are actually loaded
Media Database Performance
- Song scanning is dramatically faster — indexed lookups replace full table scans, batch transactions replace per-song commits
- Database bloat fixed — automatic compaction after scans prevents the database from growing to multiple gigabytes over time
- Clean shutdown — database is properly checkpointed and closed on exit
Plugin API Expansion
For plugin developers building on QUP:
- New FillerPlugin interface for hooking into the filler playback system
- New SkinnedDialog utility for creating themed popup windows that match the active QUP skin
- New genre tagging methods:
updateSongGenre(),updateSongGenres(),updateFillerGenre() - New
refreshMediaLibrary()method to update the file list UI without a restart - New
getPluginDatabase()for plugin-private SQLite storage SongInfoexpanded with genre and album fields
Bug Fixes
- Fixed: Application required two restarts on first launch — now starts fully on the first run
- Fixed: Upgrading with new columns no longer crashes on startup — column count mismatches are handled gracefully
- Fixed: Filler music going silent on manual crossfade song transitions
- Fixed: Build size reduced from ~245 MB to ~90 MB by excluding unnecessary platform-specific native libraries
v2.0.22 — April 13, 2026
Crossfade & Distribution Fixes
- Fixed filler music going silent on song transitions when crossfade is set to Manual mode
- Fixed crossfade gains resetting on each new karaoke song start in Manual mode
- Fixed crossfade incorrectly triggering during seeks in Manual mode
- Filler volume slider now correctly applied on all playback paths
- Distribution size reduced from ~245 MB to ~90 MB by removing unused libraries (OpenCV, Tesseract, sensor drivers, and non-target platform binaries were being bundled unnecessarily)
v2.0.21 — April 12, 2026
KaraokeMaker Local Files & Fast Restart
- KaraokeMaker now supports local MP3 and MP4 files — use the Browse button instead of requiring a YouTube URL
- Accurate duration detection using FFmpeg probe replaces the old bitrate-based estimation
- Fast song restart — video mode seeks to the beginning instead of fully reloading, audio mode caches duration to skip the rescan
- Stop → Back now immediately restarts the current song without needing another Play click
- Playlist wait times show "PENDING" for a singer's queued songs that aren't up next
v2.0.20 — April 11, 2026
File Management Plugin & Plugin API Improvements
- New FileManagement plugin — batch rename and re-import songs with support for 6 naming formats (DISC/TRACK - ARTIST - TITLE, ARTIST - TITLE, and more)
- Right-click selected songs to re-import with a different naming convention or physically rename and reorganize files on disk into a clean folder structure
- Karaoke and Filler sub-tabs with multi-select, sortable columns, and a configurable output folder for file conversions
- Progress bar for batch operations across hundreds of files
- Plugin API extended with
SongInfo— plugins can now query and inspect the full song library - New
buildPluginApiGradle task automatically rebuilds the plugin API JAR when interfaces change - Five plugins now ship with QUP: SongShop, Music Video Backgrounds, OBS Recording, KaraokeMaker, and FileManagement
v2.0.19 — April 11, 2026
KaraokeMaker v2 & GPU Acceleration
- Complete rewrite of the KaraokeMaker plugin with a job queue system — queue multiple songs while one is processing
- Jobs persist between sessions so you can close and reopen without losing your queue
- Per-song output settings: brightness, duet mode, frequency slider, and visual effects are now set per song, not globally
- Right-click menu on queued jobs: Re-Start, Re-Sub (redo transcription only), Re-View, Import to library, Delete
- GPU acceleration throughout: NVIDIA NVENC for encoding, CUDA for vocal separation (Demucs), and CUDA for lyric transcription (Whisper) — falls back to CPU automatically if no NVIDIA GPU detected
- NVIDIA CUVID hardware video decoding for music video backgrounds and karaoke video playback
- Language support for 65 languages with auto-detection and manual override
- Graceful handling of songs where lyrics can't be transcribed — produces instrumental karaoke instead of failing
- Music Video plugin now supports browser cookie import for authenticated YouTube downloads
- Music Video plugin strips track numbers from search queries for cleaner YouTube results
v2.0.18 — April 10, 2026
Session Recording & Media Library Improvements
- Session Recording — every song queued, dequeued, moved, or removed during a live show is logged automatically
- Session Playback — replay saved session logs through the real rotation engine for debugging or training
- Per-folder media scanning — each media library folder now has its own Scan and Remove buttons with an inline progress bar
- Rescan All button replaces the old "check boxes then rescan" workflow
- Database settings panel cleaned up with a simpler vertical layout
- Fixed a rotation bug where singers could get scheduled back-to-back at the start of a show
v2.0.17 — April 9, 2026
Portable Distribution
- Switched from native installers to a portable zip distribution — just unzip and run, no installation required
- Per-platform JavaFX bundling for Windows, macOS, and Linux
- Gradle now auto-compiles all plugins as part of the standard build
v2.0.15 — April 5, 2026
Plugin Architecture
- New plugin system — third-party developers can extend QUP with custom song stores, media tabs, recording integrations, and more
- Four shipping plugins:
- SongShop — browse and purchase songs from the Party Tyme catalog directly inside QUP
- Music Video Backgrounds — automatically downloads YouTube music videos as CDG backgrounds via yt-dlp
- OBS Recording — controls OBS Studio via WebSocket to auto-record each karaoke performance with scene switching and lower thirds
- KaraokeMaker — AI-powered karaoke track creation: downloads a song, separates vocals from instrumentals, transcribes lyrics, and builds a karaoke file with timed lyric sweeps
- Playlist right-click menu — Exchange Song, Replace Singer, Lock/Unlock in rotation, Show Singer History, Dequeue
- Video drag-and-drop support for MP4, MKV, and AVI files
- Plugin developer guide included for third-party development
v2.0.14 — April 5, 2026
Bug Fixes & Stability
- Fixed music video backgrounds looping indefinitely after the last karaoke song ends
- Improved rotation engine stability in headless/CI environments
v2.0.13 — April 4, 2026
Rotation Engine Overhaul, Simulation & Cloud Queuing
- Deep analysis and alignment of the rotation algorithm with the original ml_akdj C++ engine
- Graduated new singer preference — replaces the old on/off checkbox with a 0–100 slider that controls how aggressively new walk-in singers jump the queue
- Max wait time lock now correctly protects only a singer's next song, not all their queued songs — matches the original algorithm's intended behavior
- Same-rotation tiebreaker corrected to use actual singer position in the rotation list
- Full simulation engine — run fake shows with randomized singers, songs, bribes, and KJ moves to test rotation fairness before going live
- Simulation displays a purple "SIMULATION" banner on the kcombo web interface with a simulated venue clock
- Rotation invariant tests added to the CI pipeline
- Bribe cost calculation fixed for songs queued via cloud and kiosk
- Double-click to edit singer name
- "Unmark Bad File" option added to the right-click context menu
Cloud Song Queuing
- Singers queue songs from their phones — scan a QR code displayed on the kcombo screen and they're in
- Mobile-first web interface with search-as-you-type across the venue's entire song library — even libraries with 120,000+ songs search instantly, with phones only downloading a handful of results at a time
- QR code rotates daily to confirm the singer is physically present at the venue
- One account per device per venue prevents duplicate signups from the same phone
- Returning singers are recognized automatically when they scan in on a future night
- Singer selfie photo upload from phone camera, displayed on the kcombo screen above the current singer
- Song change and replace — singers can swap a queued song for a different one without losing their spot
- "You're next!" notifications — in-app banner and vibration alert when a singer reaches position 2 or 1 in the queue
- No port forwarding or special network setup required — works behind any firewall
- Live queue view — singers see their position and estimated wait time from their phone
v2.0.0 — March 29, 2026
Major Release
- Application now starts immediately — no blocking dialogs on launch
- JavaFX video playback reliability improved with an alternating MediaPlayer strategy that avoids a known GStreamer pipeline degradation bug
- Import Media button added to the file list for quick song imports
- Venue name is now a simple text field instead of a button
- Output defaults corrected: JavaFX video, PortAudio audio, WASAPI driver on Windows
- Build system modernized with dynamic file scanning and updated GitLab CI for Windows, macOS (Apple Silicon), and Linux builds
- Version format standardized to three-part numbering (e.g., 2.0.0)
v1.1.51 — March 22, 2026
Skin System, Crossfade Engine & UI Overhaul
- 14 bundled skins themed after classic hi-fi receivers — EAD Ovation, Technics SC-CH900, Kenwood KR V-106, and more
- Live skin switching — change the look of the entire application without restarting
- All UI components (VFD timers, scrolling displays, VU meters, waveforms, EQ sliders, transport buttons) are fully skinnable
- Vector-drawn transport buttons replace old bitmap buttons — scale cleanly at any size
- Filler music EQ — filler now has its own independent 10-band equalizer (separate from karaoke EQ)
- CUT slider and VU meter — horizontal CUT slider for filler volume with a redesigned VU meter bar
- Smart crossfade engine with three modes:
- Silence — auto-fades filler based on silence detection in the karaoke audio
- No Karaoke — filler plays only when no karaoke song is active
- Manual — direct slider control
- Crossfade mode persists between sessions
- Config panel redesign — tabbed interface replaced with a tree-navigation panel (always light themed for readability)
- Alternating row colors in all list views, configurable per skin
- EQ curve visualizer with smooth spline rendering
- EQ memory preset buttons redesigned with LED indicator lights
v1.1.0-b48 — Pre-March 2026
Foundation (Java 21 Port)
- Filler music system — dedicated filler music player with its own playlist, crossfading between karaoke and filler streams
- Filler checkbox per media folder — designate folders as filler music (excluded from kiosk and song search)
- Internet radio URL support for filler music
- Filler songs appear on the kcombo web interface as "Filler" with no rotation logic applied
- VU meter panel — real-time stereo VU meter
- Smart crossfade — monitors karaoke audio levels and automatically fades filler at natural silence points
- Kcombo web interface — live queue display for the audience showing current singer, upcoming songs, rotation order, and queue status
- Kiosk touchscreen keyboard improvements
- Bribe visual indicator on kcombo — bribed songs show a tiled money GIF background
- Cloud backend with venue registration, live playlist sync, singer photo uploads, and session heartbeat