Fretatro

Fretatro

Guitar Hero inside Balatro. Every blind is a song from your own Clone Hero library, and the cards you play are the lanes. Hit notes to score, build streaks and Star Power, and let your jokers play along.

Play with a keyboard, a controller or a real Guitar Hero guitar. Requires Lovely and Steamodded.

Fretatro is made by one person. The programming was done with Claude Code, Anthropic's AI coding assistant.

Install

Mod manager (easiest): install Fretatro with r2modman or the Mod Manager. Lovely and Steamodded come with it.

By hand:

• Install Lovely and Steamodded (guide).
• Unzip Fretatro into its own folder in Balatro's Mods folder, so you get Mods/Fretatro/Fretatro.json.

Windows: %AppData%\Balatro\Mods · macOS: ~/Library/Application Support/Balatro/Mods

• Start Balatro: Fretatro should be listed under Mods.

Add your songs

Fretatro plays Clone Hero songs (a folder per song with notes.chart or notes.mid and its audio).

| Your songs' audio | What to do |

|---|---|

|.ogg.mp3 | Drag your Clone Hero Songs folder onto the Balatro window. An installed Clone Hero is found on its own. |

|.opus (most newer charts) | Balatro can't play.opus audio. Convert those songs' audio files to.ogg or.mp3 first, then add the folder as above. Songs left in.opus are skipped. |

Mods → Fretatro → Config shows the songs folder in use. With no songs, hands play like normal Balatro and a message tells you to add songs.

How to play

A blind is one song.

• You get 1 hand and 6 discards. Build your hand, play it, and pick 1 of 3 songs from the setlist.
• The setlist shows each song's length and how long until the first note (green short, yellow 5–20% of the song, red longer). Orange switches guitar / bass / keys.
• Short songs (under 600 notes) make every note worth more, up to x2; very short ones (under 300) also shrink the blind.

Your scoring cards are the lanes, left to right: green, red, yellow, blue, orange.

• Only cards that score get a lane; extra played cards sit out.
• With fewer lanes, the higher frets fold onto the lanes you have.
• A debuffed card keeps its lane, but nothing plays there.

Notes become score as you play.

• Your multiplier climbs x1 → x4 with your streak (10 / 20 / 30 notes). Each note pays 0 / 1 / 2 / 3 Chips, doubled in Star Power.
• Sustains, solos, jokers, Picks and enhanced cards add their part live; the left panel shows Chips × Mult building against the blind.
• Card enhancements trigger on Perfect hits in their lane.
• Star Power: complete star phrases (blue notes), activate at 50% with Select / tilt (Tab on a keyboard), whammy star sustains to charge it.
• Pair, Two Pair and Three of a Kind get +1 Mult. Extra hands (Grabber, Burglar...) become retriggers; extra discards add to the 6.
• There's no fail: misses just cost score. The crowd meter pays up to $4 a round.

Difficulty (Config) picks the chart. Easier charts have fewer notes, so each is worth a little more (Easy x1.3, Medium x1.25, Hard x1.1). Like in Guitar Hero, Easy barely uses blue and orange and Medium barely uses orange, so the shop leaves out jokers and Picks for those lanes there.

Note shapes: white centre = hammer-on (fret, no strum) · hollow = tap · blue = Star Power · purple bar = open note (strum, no fret) · $ + x * G = special notes from jokers and Picks.

Controls

In a song

| | Keyboard | Guitar |

|---|---|---|

| Frets | A S D F G | five frets |

| Strum | Space, Enter, ↑ / ↓ | strum bar |

| Star Power | Tab / Shift | Select or tilt |

| Pause | Esc | tap Start |

| End the song | Backspace | hold Start |

Pausing saves the song; when you come back it rewinds 2 seconds and counts you in.

In the setlist: Green / Red / Yellow pick song 1 / 2 / 3, Blue rerolls (needs the Setlist voucher or a Reroll Tag), Orange switches guitar / bass / keys. On a keyboard: A S D F G.

In Balatro's menus with a guitar (set it up first with F8):

| Guitar | Does |

|---|---|

| Strum down / up | move to the next / prev