Skip to content

CHQueue v1.0.0

Choose a tag to compare

@iamjrmh iamjrmh released this 26 Aug 22:30
· 1 commit to main since this release
5968b99

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 !TTFAF for "Through the Fire and Flames"
  • Per-viewer request limit, !revoke to 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.1 URLs
  • 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.txt and 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 .txt file 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.