SongHero downloads the track, analyzes the audio, and builds a chart with 4 difficulty levels in one command. You don't need to know how to chart.
No MIDI editing and no manual charting. You give it a Spotify link and run one command.
Paste a Spotify track URL and SongHero finds the audio, downloads it, and generates a chart. It needs no API keys for Spotify, only the link.
With the --gemini flag, Google Gemini 2.0 Flash maps song sections (verses, choruses, bridges) and suggests note patterns for each one.
Easy, Medium, Hard, and Expert, each with its own note grid. Orange fret and chords appear from Hard up, scaled to the song's intensity.
With the --video flag, SongHero also downloads the music video and saves it as the video background Clone Hero expects.
librosa extracts onsets, tempo, and pitch curves from the audio, so each note is placed on a detected beat.
The output is a Clone Hero song folder with notes.chart, song.ini, album art, and audio. Move it to your Songs folder and play.
From a Spotify URL to a chart folder you can play.
Extracts song title, artist, album art, and metadata from the Spotify URL using public info, so no login is required.
Fetches the highest-quality audio and optional music video from YouTube via yt-dlp and ffmpeg.
librosa detects beats, onsets, and pitch. Gemini maps song sections and suggests note patterns per difficulty.
Builds a .chart file with all 4 difficulties, writes metadata, and packages everything into a ready-to-play folder.
Every chart includes all four difficulty levels.
| Difficulty | Note Density | Orange Fret | Chords | Style |
|---|---|---|---|---|
| EASY | 25% | No | No | Simple single notes on strong beats |
| MEDIUM | 50% | No | No | Faster single notes, varied patterns |
| HARD | 70% | Yes | Yes | Orange notes, some chords, faster sections |
| EXPERT | 90% | Yes | Yes | Dense patterns, full chords, all notes mapped |
Works on macOS and Linux. Windows via WSL.
brew install yt-dlp ffmpeg · pip3 install librosa soundfile numpy scipy
Each chart is saved as a Clone Hero song folder. Copy it into your Songs directory.