Guitar Chord Tool
1. Forward Lookup (Chord Name → Notes)
python3 chord_identifier.py <chord_name>
Example:
python3 chord_identifier.py Cmaj7
→ **Cmaj7**
Notes: C, E, G, B
2. With Chord Diagram
python3 chord_identifier.py <chord_name> --diagram
3. Reverse Lookup (Notes → Chord Name)
python3 chord_identifier.py --identify <note1> [note2] ...
Example:
python3 chord_identifier.py --identify C E G B
→ Result:
• Cmaj7
4. Chord Inversions
python3 chord_identifier.py --inversion <chord_name>
Example:
python3 chord_identifier.py --inversion C7
→ **C7** inversions:
Root: C, E, G, A#
1st: E, G, A#, C
2nd: G, A#, C, E
3rd: A#, C, E, G
5. Scale Lookup
python3 chord_identifier.py --scale "<scale>"
python3 chord_identifier.py --scale "<scale>" --diagram
Supported scales:
major, minor, harmonic_minor, melodic_minor
pentatonic_major, pentatonic_minor, blues
dorian, phrygian, lydian, mixolydian, locrian
Example:
python3 chord_identifier.py --scale "C major"
→ **C Major**
Scale: C, D, E, F, G, A, B
6. Capo Calculator
Formula: Actual Pitch = Open Chord Pitch + Capo Fret
Quick Reference:
| Chord |
1st |
2nd |
3rd |
4th |
| C |
C#/Db |
D |
D#/Eb |
E |
| G |
G#/Ab |
A |
A#/Bb |
C |
| Am |
A#/Bb |
B |
C |
C#/Db |
Supported Chord Types
- Triads: major, minor, diminished, augmented, sus2, sus4
- Sevenths: maj7, 7, m7, m7b5, dim7, aug7, maj7#5, 7#5, 7b5, mMaj7
- Ninths: maj9, 9, m9
Note Formats
Supports:
- Natural: C, D, E, F, G, A, B
- Sharps: C#, D#, F#, G#, A#
- Flats: Db, Eb, Gb, Ab, Bb
- Symbols: ♯ (sharp), ♭ (flat)
- Case insensitive
1---2name: guitar-chord3description: Guitar chord toolkit with chord identification, chord diagrams, capo calculation, and more. Features: - Identify chord from notes (reverse lookup) - Look up notes and diagrams from chord name - View chord inversions - View scales and scale diagrams - Capo transposition calculator4---56# Guitar Chord Tool78## 1. Forward Lookup (Chord Name → Notes)910```bash11python3 chord_identifier.py <chord_name>12```1314Example:15```16python3 chord_identifier.py Cmaj717→ **Cmaj7**18 Notes: C, E, G, B19```2021## 2. With Chord Diagram2223```bash24python3 chord_identifier.py <chord_name> --diagram25```2627## 3. Reverse Lookup (Notes → Chord Name)2829```bash30python3 chord_identifier.py --identify <note1> [note2] ...31```3233Example:34```35python3 chord_identifier.py --identify C E G B36→ Result:37 • Cmaj738```3940## 4. Chord Inversions4142```bash43python3 chord_identifier.py --inversion <chord_name>44```4546Example:47```48python3 chord_identifier.py --inversion C749→ **C7** inversions:50 Root: C, E, G, A#51 1st: E, G, A#, C52 2nd: G, A#, C, E53 3rd: A#, C, E, G54```5556## 5. Scale Lookup5758```bash59python3 chord_identifier.py --scale "<scale>"60python3 chord_identifier.py --scale "<scale>" --diagram61```6263Supported scales:64- `major`, `minor`, `harmonic_minor`, `melodic_minor`65- `pentatonic_major`, `pentatonic_minor`, `blues`66- `dorian`, `phrygian`, `lydian`, `mixolydian`, `locrian`6768Example:69```70python3 chord_identifier.py --scale "C major"71→ **C Major**72 Scale: C, D, E, F, G, A, B73```7475## 6. Capo Calculator7677Formula: **Actual Pitch = Open Chord Pitch + Capo Fret**7879Quick Reference:80| Chord | 1st | 2nd | 3rd | 4th |81|-------|-----|-----|-----|-----|82| C | C#/Db | D | D#/Eb | E |83| G | G#/Ab | A | A#/Bb | C |84| Am | A#/Bb | B | C | C#/Db |8586## Supported Chord Types8788- **Triads**: major, minor, diminished, augmented, sus2, sus489- **Sevenths**: maj7, 7, m7, m7b5, dim7, aug7, maj7#5, 7#5, 7b5, mMaj790- **Ninths**: maj9, 9, m99192## Note Formats9394Supports:95- Natural: C, D, E, F, G, A, B96- Sharps: C#, D#, F#, G#, A#97- Flats: Db, Eb, Gb, Ab, Bb98- Symbols: ♯ (sharp), ♭ (flat)99- Case insensitive