Guitar capo key calculator

Use it free in the browser when arranging charts, checking a lead sheet, or teaching how capos work, or call the API at $0.002 per successful request when you need reproducible sounding keys and chord lists in CI, set-list tools, or tutoring software.

What capo transposition means and what the response contains

A capo clamps every string at a chosen fret so fretted shapes ring higher without changing left-hand patterns. In equal temperament each fret is one semitone, so a shape whose root is pitch class R with capo N sounds at (R plus N) modulo twelve. Quality tokens such as m, 7, maj7, sus4, dim, and slash-bass tails are preserved character-for-character; only the root letter and accidental move. This calculator returns the integer capo frets, a semitones field equal to that capo (because one fret equals one semitone), the played_key you supplied or inferred from the first shape, the sounding_key after transposition, the played_chords list as normalized symbols, the sounding_chords list after raising each root, the method tag capo_transpose, and a short formula reminder. There is no sample-based pitch detector and no chord-recognition from audio: the engine either evaluates the closed form inside the documented limits or rejects the input with invalid_input. Rejected cases include a missing capo or chords list, non-integer frets, frets above the supported maximum, empty chord arrays, unparsable roots, and any negative capo fret, which cannot describe a physical clamp on a standard guitar neck.

How capo, chords, and key are read and how results stay reproducible

Each symbol must begin with a root A through G and an optional sharp or flat accidental; the remainder is treated as the quality suffix and kept verbatim when the root is raised. Enharmonic spelling prefers flats when the input root used a flat accidental and prefers sharps otherwise, so B flat shapes stay in the flat family after transposition while F sharp shapes stay sharp-based. The preferred field is capo for the fret number, but aliases fret, capo_fret, and position are accepted so forms, query strings, and spreadsheets can reuse the same contract. Capo must be an integer from zero through twenty-four inclusive; negative values fail with invalid_input and a message that the fret cannot be negative, while values above the ceiling are rejected as unsupported. The preferred chords field is an array of shape symbols such as G, Em, C, D, F sharp m7, or B flat; aliases shapes, progression, and played_chords are accepted, and a single comma-separated or whitespace-separated string is normalized into the same list. An optional key field names the played or shape key as a single root; aliases played_key, shape_key, and in_key are accepted. When key is omitted, the engine uses the root of the first chord as the played key so a simple four-chord list still produces a sounding_key without extra fields. Pair the free browser run on this page with the priced API when you need the identical mathematical result inside an automated pipeline without re-implementing semitone arithmetic yourself.

Where capo key calculation fits in practice, teaching, and software

Performers use capo transposition when a singer needs a higher key but the guitarist wants familiar open shapes: set the shapes and the target fret, read the sounding key, and print a chart that matches the band. Product and education tools use the calculation when a learner types shapes and a fret and the UI must show played_key, sounding_key, and both chord lists with a clear capo_transpose method tag. On this page the work runs entirely in your browser; through the API each successful lookup costs $0.002, failed validation is not charged, and nothing is stored after the response returns. That split — free interactive exploration and a priced, identical API — matches the rest of the KIT tier-A catalog and lets you move from a classroom demo to an automated pipeline without changing the mathematical result.