Clone Hero Companion
Website & downloads: cloneherocompanion.com
Clone Hero Companion adds HD music videos and sing-along lyrics to every song in Clone Hero,plus the library manager and chart downloader you always wanted, in one app.
Download · Features · Quick start · FAQ · Report a bug
Why
Clone Hero can play a background video behind the highway and show lyrics, but most charts ship with neither. Finding the right music video, getting it in decent quality, lining it up with the chart's audio and adding lyrics is a lot of manual work per song. Clone Hero Companion does it for your whole library in one go, and keeps doing it for every new song while you play.
Features
🎬 HD music videos behind the highway
Select any number of songs and press Run. For each song the app finds the official music video on YouTube, downloads it and lines it up with the chart by matching the video's soundtrack against the chart audio. Only 640p or better is ever accepted (720p preferred, 1080p optional): no blurry 360p uploads and no static "album art" videos.
🎤 Lyrics in the game
Charts with a vocals part already show lyrics. For the rest, time-synced lyrics from LRCLIB are written into the chart and aligned to the chart's own audio, so Clone Hero shows them in-game.
🗂️ A real library manager
- Fast virtualized list for thousands of songs: album art, instruments, video quality, lyrics status
- Search, filters (No video, Video below 640p, No lyrics, Favourites, Recently added, Disabled) and sorting on every column
- Multi-select with click, ⌘/Ctrl-click, Shift-click and ⌘/Ctrl-A
- One-click metadata: album, year, genre, length and high-resolution album art from Chorus Encore and iTunes
- Disable songs (moved out of the game's way), Move to Trash, rename folders by template, export chart packs (.zip)
- Per-song sync editor with live video and audio preview, plus a video picker that only offers HD candidates
- Built-in player to listen to any chart's audio
- Languages: English, Русский, 简体中文, 한국어, 日本語, Português (Brasil), Español, Français and Deutsch. Follows your system language by default; change it any time in Settings, no restart needed. Missing translations fall back to English (translator guide:
chcompanion/web/i18n/GLOSSARY.md)
⭐ Favourites, also in the game
Star songs with one click (or press F). The app keeps a Favourites setlist in sync, so the same list is one click away inside Clone Hero.
📥 Get charts
- Search Chorus Encore and RhythmVerse with instrument, difficulty and sort filters, and ▶ preview a chart's audio before downloading
- One-click download and install of .sng, .zip and .7z (and .rar when an unrar tool or 7-Zip is installed), including Google Drive, Mediafire and Dropbox links
- New charts can get their video, lyrics and metadata right after downloading
- Spotify import: paste a public playlist link and the app finds a chart for every song and marks the ones you already have
☁️ Profile, cloud sync and CH Leaderboards (v2.1)
- Optional account. Sign in from the Profile page with Google, or with a 6-digit code sent to your email. Everything keeps working signed out and offline; cloud failures are retried quietly in the background. The session is stored only in your app config folder (
cloud_session.json).
- Favourites follow you. Favourites sync both ways (a few seconds after each change, at start-up and on sign-in). The Favourites view lists "In your cloud, not on this machine" with Install all, which finds each chart on Chorus Encore and downloads it (optionally adding video, lyrics and metadata).
- v2.1.1: favourites are now per chart (a Harmonix and a Neversoft chart of one song star independently), unstarring sticks, and removals sync both ways.
- Play stats. After every song Clone Hero writes
scorestats.json; the app records each play on your computer (plays.jsonl) and, when signed in, merges plays from all your machines. Profile shows plays, hours, accuracy, full combos, streaks, a 26-week activity map, most played / best / needs practice lists, recent plays and personal bests, filterable by instrument and difficulty. Importing older history from scoredata.bin is not supported.
- v2.6.0: friends and sharing. Friends can open your Profile stats (Friends > View profile; switch it off with Let friends see my profile stats, run
supabase/migrations/0004_friend_stats.sql first), and the Profile's Share button makes a 1080x1350 stats card with your recent highlights (full combos, new bests, 5 stars, streaks, play milestones) that you can save, copy, or send to WhatsApp, Reddit, Facebook, Instagram and Snapchat.
- CH Leaderboards (read-only). Song panels and the Now playing screen show the global top scores, plus your rank once you link your CH Leaderboards account in Profile (you sign in to CH to prove it is yours). The Leaderboards page shows site totals, top players, trending songs and the latest scores. Scores cannot be submitted from this app: the game submits replays itself in leaderboards mode.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
