Clone Hero Companion

Put the music videobehind every chart.

Clone Hero Companion adds HD music videos and synced lyrics to every song in your Clone Hero library, lines them up with the chart, and keeps doing it while you play. Free, open source, one download for macOS, Windows and Linux.

Download

Looking up the latest version…

All releases

The Clone Hero Companion library: a fast list of songs with album art, video quality and lyrics status, and a song panel open on the right

HD video backgrounds, in sync

Want Clone Hero music videos without hunting for them? Select songs and press Run. The app finds the official music video, downloads it, and lines it up with the chart by matching the video's soundtrack against the chart audio. Only 640p or better is accepted, so no blurry uploads and no album-art slideshows.

  • Preparing starts the moment you highlight a song in Clone Hero
  • Per-song sync editor with live preview to nudge it by hand
The Now Playing screen showing a music video and lyrics, karaoke style
The sync editor in the song panel, previewing a music video with video and lyrics offset sliders

Clone Hero lyrics, sing along

Charts that have a vocals part already show lyrics. For the rest, time-synced lyrics from LRCLIB are written into the chart and aligned to its own audio, so Clone Hero shows them in game.

Prefer to leave charts untouched? Switch lyrics off in one setting. Every change is backed up first and Undo restores the originals.

A real Clone Hero song manager

A virtualized list that stays fast with thousands of songs, with filters for no video, low-res video, no lyrics, favourites and recently added.

  • One-click metadata: album, year, genre, length and high-res art
  • Disable songs, rename folders by template, export chart packs
  • Find duplicate charts and keep the one you want
  • Create Clone Hero setlists from your library
The duplicate chart finder listing songs charted more than once
Chart search across Chorus Encore and RhythmVerse with instrument and difficulty filters

Clone Hero chart downloader

Search Chorus Encore and RhythmVerse with strict instrument and difficulty filters, preview the audio, and install with one click. New charts can get their video, lyrics and metadata right after they download.

  • .sng, .zip and .7z, including Google Drive, Mediafire and Dropbox links
  • Paste a Spotify playlist and see which songs you already have

Favourites that follow you

Star a song and it joins a Favourites setlist inside Clone Hero. Sign in, optionally, with Google or a six-digit code sent to your email, and your favourites sync across machines. A new computer can reinstall the lot in one click.

Signed out and offline still works fully.

The favourites view, including songs in your cloud that are not on this machine

Know your playing

After every song the app records the play. Profile shows plays, hours, accuracy, full combos and streaks, a 26-week activity map, your most played and best songs, and what needs practice, filterable by instrument and difficulty.

CH Leaderboards shows the global top scores right in the song panel and on Now Playing, and your rank once you link your username.

26week activity map
Top scoresfrom CH Leaderboards

See it move

Open the tour as a video file

macOS

11 or newer. One universal build for Apple Silicon and Intel.

Windows

Windows 10 and 11. A single .exe, nothing to install.

Linux

x64. Videos are saved as VP8 .webm, the format Clone Hero plays there.

What’s new

Loading release notes…

Install

Everything is bundled, ffmpeg and yt-dlp included.

  1. Open the .dmg and drag Clone Hero Companion to Applications.
  2. The app is ad-hoc signed, not notarized. On first launch, right-click it and choose Open, then Open again.
  3. If macOS asks about protected folders, grant Full Disk Access (Game & folders, then Grant Full Disk Access).

Then in Clone Hero, turn on Settings, Custom Content, Song Videos.

Frequently asked questions

Is Clone Hero Companion free?

Yes. It is free and open source under the GPL-3.0 licence, with no ads and no paid tier. You can read the code and download every release on GitHub.

Does it work with Clone Hero on Mac, Windows and Linux?

Yes. There are builds for macOS 11 or newer (one universal build for Apple Silicon and Intel), Windows 10 and 11, and Linux x64. On Linux, videos are saved as VP8 .webm, the format Clone Hero plays there.

How do I add music videos to Clone Hero?

Install the app, point it at your Clone Hero songs folder, select songs in the library and press Run. It finds a video for each song, downloads it and syncs it to the chart. Then turn on Settings, Custom Content, Song Videos in Clone Hero and the video plays as the background of the chart.

Where do the videos come from?

Videos come from YouTube. Only HD results of 640p or better are accepted, so low-quality uploads and album-art slideshows are skipped. The soundtrack of the video is matched against the chart audio to line the two up, and you can nudge the timing by hand in the sync editor.

Does it modify my charts?

Only when it has to, and never without a backup. Adding a video places a video file next to the chart. Lyrics are written into the chart only for songs that have none, and you can switch that off in one setting. Every change is backed up first, and Undo restores the originals. Both folder charts and .sng files are supported.

Do I need an account?

No. Everything works signed out and offline. An account is optional and only adds syncing of your favourites and play stats between computers. You can sign in with Google or a six-digit code sent to your email.

Is it affiliated with Clone Hero?

No. Clone Hero Companion is an independent community project. It is not affiliated with, endorsed by or sponsored by Clone Hero or its developers.

How do I install it on macOS?

Open the .dmg and drag the app to Applications. The app is ad-hoc signed but not notarized, so on first launch right-click it, choose Open, and click Open again. If macOS asks about protected folders, grant Full Disk Access.