Repository navigation
CHQueue v1.0.0
CHQueue v1.0.0
Initial release. TikTok LIVE chat requests, verified against your own Clone Hero library, with a fully customizable stream overlay and automatic chart downloading for the songs you don't have yet.
🎤 Chat & Requests
- Takes song requests from TikTok LIVE chat with
!Song - Artist(or just a title/artist on its own) - Uses TikFinity's local connection when it's running, falls back to a direct TikTok LIVE connection by username otherwise
- Fuzzy-matches every request against your own scanned library - handles typos, word order, and title-only initialisms like
!TTFAFfor "Through the Fire and Flames" - Per-viewer request limit,
!revoketo cancel a pending request, and a configurable no-repeat window so a song can't be re-requested right after it played
⬇️ Bridge Auto-Download
- Requests that don't match your library are automatically searched against Bridge (Chorus Encore) and the best-scoring chart is downloaded straight into your songs folder
- Every result is re-scored against what was actually typed - never trusts Bridge's own search ranking as-is
- Restrict downloads to only the instruments you actually chart, with an adjustable match-confidence floor
- Downloaded-but-unscanned songs are flagged
[]in the queue, distinct from*for "still needs downloading"
🖼️ Overlay
- One page that works as both an OBS Browser Source and a TikTok LIVE Studio Add Link - includes the hosts-file workaround for TikTok's dialog rejecting
127.0.0.1URLs - Fully customizable: heading text, accent color, background style (glass/solid/transparent), font (including your own uploaded font), corner radius, entrance animation, and overall size, all with a live demo preview
- Per-field visibility toggles for artist, requester, position number, and album art
- Card shrinks and grows smoothly with the queue itself instead of sitting at a fixed reserved height
🎮 Now Playing
- Watches Clone Hero's own
currentsong.txtand clears the front of the queue automatically once a song is actually confirmed playing - Configurable dwell time before removal, so a brief flicker in Clone Hero's own file doesn't drop a request early
- Live queue also exported to a plain
.txtfile for any OBS text source that isn't the browser overlay
Download
| Installer | File | Best for |
|---|---|---|
| Setup (recommended) | chqueue-setup.exe |
Most users. A standard click-through Windows installer. |
| MSI | chqueue-setup.msi |
Managed or business deployments (Group Policy / Intune). |
Windows 10 or 11, 64-bit.