# Transpose the chords in your chord sheets

> Markdown version of https://stella.sh/how/hobbies/transpose-chords for agents and LLMs.
> Move every chord in your chord sheets up or down by half steps, lyrics untouched and slash chords moved too: by hand, or Stella (stella.sh) for a whole folder.

Count each chord down (or up) the same number of half steps on the chromatic scale: C, C#/Db, D, D#/Eb, E, F, F#/Gb, G, G#/Ab, A, A#/Bb, B. Two half steps down turns G into F, D/F# into C/E and Em into Dm. Keep the chord type, move the bass note of slash chords too, and spell with flats in flat keys. Stella (stella.sh) rewrites a whole folder of chord sheets on your computer and saves new copies.

- Checked: 14 November 2026
- Stella does it on: Windows, Mac, Linux

## Stella doing it

Recorded 14 November 2026 on Linux (Omarchy) with Claude Code with Opus, on a Claude plan.
Result: Five transposed songs in under a minute and a half. Checked afterwards against an answer key written before the run: for each of the 5 songs, a new file whose chords are exactly the originals moved down 2 half steps, slash bass notes moved too, every lyric line unchanged, flat spellings in the flat keys, and the original sheets unchanged. The songs were written for this run, with lyric lines that look like chords on purpose. The work is sped up 3×.

Video (43 s, sped up 3×): https://stella.sh/media/proofs/hobbies/transpose-chords/proof.mp4

Transcript:

- 0:00 Stella on a Linux computer. Five chord sheets are in Documents/Chord Sheets.
- 0:02 The prompt: move them all down two half steps, as new files.
- 0:10 Stella replies each new version will sit next to its original.
- 0:16 Transposing, sped up 3×.
- 0:28 Done: G to F, D to C, A to G, E to D and Bb to Ab, lyrics untouched, setlist left alone.

What Stella does:

1. Finds the five songs in `Documents/Chord Sheets`: four chord-over-lyrics text files and one ChordPro file with chords in square brackets
2. Writes a small transposer that only touches chord lines and bracketed chords, so lyric lines starting “Am I”, “A distant” or “E is for” stay as written
3. Moves every chord down two half steps, keeping sevenths, minors, sus chords and slash bass notes, and spells them with flats where the new key uses flats (Ab, Db, Eb)
4. Updates the key labels in the song titles (Willow Street goes from Bb to Ab) and keeps each chord over the same syllable
5. Saves each song as a new file with “(-2)” in the name, leaves the originals as they were and ignores the Saturday setlist, which isn't a song

## The prompt to paste

```text
Transpose all the songs in the Chord Sheets folder in my Documents down two half steps so they're easier to sing. Save them as new files and keep the originals.
```

## Transpose them yourself

1. **Work out the new key.** Write out the twelve notes: C, C#/Db, D, D#/Eb, E, F, F#/Gb, G, G#/Ab, A, A#/Bb, B, then back to C. Count down from the song's key by the number of half steps you want. Two half steps down from G is F.
2. **Save a copy first.** Open the song in Notepad, TextEdit or your notes app and use Save As with a new name, such as the song title plus the new key, so the original stays as it was.
3. **Move each chord.** Change only the root letter (and accidental) of each chord, keeping the rest: Em7 becomes Dm7, Asus4 becomes Gsus4. For slash chords move both notes: D/F# becomes C/E. Keep each chord above the same word.
4. **Don't use find and replace.** Replacing every A with G also changes lyrics like “A distant train”, and changing chords one at a time with replace can move a chord twice. Go line by line, or use a transposer that only reads chord lines.
5. **ChordPro files.** Chords sit in square brackets, such as `[G]`. Change each one, or open the file in a ChordPro app and use its transpose setting before saving under a new name.

## Where Stella stops

- Stella changes the written chords. To change the key of a recording, see [change the key of a song](https://stella.sh/how/audio/change-key-of-song).
- Chord sheets in PDF or image form need the text read out first, which is less reliable than plain text files.
- The songs' text, lyrics included, goes to the AI model you use in Stella while it reads them. The new files are written on your computer.
- Recorded on Linux, using Python (built in on Mac and Linux). On Windows Stella may install Python first, which wasn't recorded.

## Questions

**How many half steps should I transpose to sing lower?**
Two half steps (a whole step) is a common first try. If the high notes are still a strain, go to three or four; to keep easy guitar shapes, use a capo instead.

**Should it be A# or Bb?**
Both are the same note. Keys with flats in their signature (F, Bb, Eb, Ab, Db) are normally written with flats, which is what Stella used.

**Can I transpose up instead, or for a capo?**
Yes. Ask for up a number of half steps, or for shapes to play with a capo on a given fret, and Stella writes those versions.

**Can I get a practice track in the new key?**
Yes: see [change the key of a song](https://stella.sh/how/audio/change-key-of-song) or [make a karaoke version](https://stella.sh/how/audio/make-karaoke-version-of-song).

**Is Stella free for this?**
Yes. Free with the ChatGPT or Claude plan you already have. Sign in with your ChatGPT plan, or use your Claude plan through Claude Code, and this task costs nothing extra. New accounts also get a small free trial of Stella’s own models.

**Can I control what Stella changes on my computer?**
Yes. Stella works on Windows, Mac and Linux with your own files and shows each step in the chat, so you can watch it and stop it at any point. Tell it what it may not do, as the prompts on these pages do (“don't delete anything without asking”). In the Downloads recording it deleted nothing until it was told to go ahead. It also refuses commands that would wipe a whole disk, your home folder or system folders.

Sources: [ChordPro file format](https://www.chordpro.org/chordpro/), [Wikipedia: Transposition (music)](https://en.wikipedia.org/wiki/Transposition_(music)).

## Related problems

- [Change the key of a song to fit your voice](https://stella.sh/how/audio/change-key-of-song.md)
- [Remove the vocals from a song for karaoke](https://stella.sh/how/audio/make-karaoke-version-of-song.md)
- [Slow down a song without changing its pitch](https://stella.sh/how/audio/slow-down-song-without-changing-pitch.md)
- [Scale a recipe up or down for more people](https://stella.sh/how/hobbies/scale-a-recipe.md)
- [Print a family tree chart from your GEDCOM file](https://stella.sh/how/hobbies/make-a-family-tree-chart-from-gedcom.md)

Get Stella: https://stella.sh/download. Free with the ChatGPT or Claude plan you already have.
