SongHero downloads the track, analyzes every beat with AI, and builds a full chart with 4 difficulty levels — in one command. No charting experience needed.
No MIDI knowledge. No manual charting. Just a Spotify link and one command.
Paste any Spotify track URL and SongHero finds the audio, downloads it, and generates a full chart. No API keys, no setup — just the link.
Google Gemini 2.0 Flash maps song sections — verses, choruses, bridges — and builds note patterns that feel like a human charted every phrase.
Easy, Medium, Hard, and Expert — each with independent note grids. Progressive orange fret and chord usage tuned to the song's actual intensity.
Automatically downloads the official music video and packages it as a video background — just like Clone Hero expects. Drop in and play.
librosa audio analysis extracts precise onsets, tempo maps, and pitch curves. Every note lands on an actual beat — no random placement.
Outputs a complete Clone Hero song folder with notes.chart, song.ini, album art, and audio. Move it to your Songs folder and you're done.
From a Spotify URL to a playable chart folder in under a minute.
Extracts song title, artist, album art, and metadata from the Spotify URL using public info — no auth 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 ships with all four difficulty levels. Pick your pace and play.
| Difficulty | Note Density | Orange Fret | Chords | Style |
|---|---|---|---|---|
| 🥉 EASY | 25% | — | — | Simple single notes on strong beats |
| 🥈 MEDIUM | 50% | — | — | Faster single notes, varied patterns |
| 🥇 HARD | 70% | ✓ | ✓ | Orange notes, some chords, faster sections |
| 🎸 EXPERT | 90% | ✓ | ✓ | 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
Every chart lands in a complete Clone Hero song folder. Drop it in your Songs directory and play.