https://github.com/jekrch/chord-analyzr
A postgres driven solution for analyzing chord progressions and making chord suggestions
https://github.com/jekrch/chord-analyzr
chords music postgresql
Last synced: 30 days ago
JSON representation
A postgres driven solution for analyzing chord progressions and making chord suggestions
- Host: GitHub
- URL: https://github.com/jekrch/chord-analyzr
- Owner: jekrch
- License: mit
- Created: 2021-09-25T22:47:26.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-11-30T01:02:13.000Z (7 months ago)
- Last Synced: 2025-12-02T00:17:49.036Z (7 months ago)
- Topics: chords, music, postgresql
- Language: TypeScript
- Homepage: https://modal.chordbuildr.com/
- Size: 5.75 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Chord Analyzr :musical_note:
[modal.chordbuildr.com](https://modal.chordbuildr.com/)
A Postgres driven solution for analyzing chord progressions and generating chord suggestions.
Setup
Execute ```docker-compose up``` to create a postgres database named chordanalyzr on ```localhost:5432``` with user credentials from ```flyway/flyway.conf```.
Services for a spring boot API and react frontend will also be started, with the frontend available at `localhost:3000`
chord views
```chord_view``` displays all permutations of root note and chord type, with the notes comprising each chord aggregated in csv.
Sample usage:
```
SELECT cv.chord_name,
cv.chord_note_names,
cv.chord_notes
FROM chord_view cv
WHERE note_name = 'F' AND
chord_type = '7sus4';
```
Returns:
```
"F7sus4", "F, Bb, C, D#", "6, 11, 13, 16"
```
To capture each note by row use ```chord_note_view```
mode views
```mode_view``` displays all permutations of key and mode, with the notes comprising each scale aggregated in csv.
Sample usage:
```
SELECT mv.mode,
mv.key_name,
mv.mode_note_names,
mv.mode_notes
FROM mode_view mv
WHERE key_name = 'A';
```
Returns:
```
"mode", "key_name", "mode_note_names", "mode_notes"
Aeolian, A, "A, B, C, D, E, F, G", "10, 12, 13, 15, 17, 18, 20"
Altered Scale, A, "A, Bb, C, Db, Eb, F, G", "10, 11, 13, 14, 16, 18, 20"
Dorian, A, "A, B, C, D, E, F#, G", "10, 12, 13, 15, 17, 19, 20"
Dorian b2, A, "A, Bb, C, D, E, F#, G", "10, 11, 13, 15, 17, 19, 20"
Ionian, A, "A, B, C#, D, E, F#, G#", "10, 12, 14, 15, 17, 19, 21"
Locrian, A, "A, Bb, C, D, Eb, F, G", "10, 11, 13, 15, 16, 18, 20"
Locrian #2, A, "A, B, C, D, Eb, F, G", "10, 12, 13, 15, 16, 18, 20"
Lydian, A, "A, B, C#, D#, E, F#, G#", "10, 12, 14, 16, 17, 19, 21"
Lydian Augmented, A, "A, B, C#, D#, E#, F#, G#", "10, 12, 14, 16, 18, 19, 21"
Lydian Dominant, A, "A, B, C#, D#, E, F#, G", "10, 12, 14, 16, 17, 19, 20"
Melodic Minor, A, "A, B, C, D, E, F#, G#", "10, 12, 13, 15, 17, 19, 21"
Mixolydian, A, "A, B, C#, D, E, F#, G", "10, 12, 14, 15, 17, 19, 20"
Mixolydian b6, A, "A, B, C#, D, E, F, G", "10, 12, 14, 15, 17, 18, 20"
Phrygian, A, "A, Bb, C, D, E, F, G", "10, 11, 13, 15, 17, 18, 20"
```
To capture each note by row use ```mode_note_view```
mode chord views
```mode_scale_chord_relation_view``` displays all permutations of chord mode and key with any distinct notes listed and counted. This can be used for identifying chords that complement a given scale.
Sample usage:
The following query will return all chords that have a root note of A and whose comprising notes all fall within the C Ionian scale.
```
SELECT mscv.mode,
mscv.key_name,
mscv.chord_name,
mscv.chord_notes,
mscv.mode_chord_note_diff,
mscv.mode_chord_note_diff_count
FROM mode_scale_chord_relation_view mscv
WHERE mscv.mode = 'Ionian' AND
mscv.key_name = 'C' AND
mscv.chord_note_name = 'A' AND
mscv.mode_chord_note_diff_count = 0
```
Returns:
```
"mode" "key_name" "chord_name" "chord_notes" "mode_chord_note_diff" "mode_chord_note_diff_count"
"Ionian" "C" "Am" "{1,5,10}" "{}" "0"
"Ionian" "C" "Am7" "{1,5,8,10}" "{}" "0"
"Ionian" "C" "Am9" "{1,5,8,10}" "{}" "0"
"Ionian" "C" "A5" "{5,10}" "{}" "0"
"Ionian" "C" "Asus2" "{5,10,12}" "{}" "0"
"Ionian" "C" "Asus4" "{3,5,10}" "{}" "0"
"Ionian" "C" "Am11" "{1,3,5,8,10}" "{}" "0"
"Ionian" "C" "A7sus4" "{3,5,8,10}" "{}" "0"
"Ionian" "C" "Am7#5" "{1,6,8,10}" "{}" "0"
"Ionian" "C" "A9sus4" "{3,5,8,10}" "{}" "0"
```
## Frontend
**modal.chordbuildr.com** is a comprehensive web-based music composition and performance tool built with React. The application provides an intuitive interface for exploring musical scales, building chord progressions, and creating rhythmic patterns.
### Core Features
**Chord Explorer & Theory Engine**
- Browse chords that fit any selected key and mode combination
- Search and filter chords by root note or chord type
- Real-time chord preview with visual piano feedback
- Advanced chord editing with custom voicings and slash chord support
**Pattern Sequencer**
- Create rhythmic patterns for chord progressions
- Customizable pattern length and timing controls
- Multiple pattern presets and BPM adjustment
- Visual step sequencer with rest and octave notation
- Export sequencer output to MIDI
**Live Mode**
- Full-screen chord buttons optimized for live performance
- Keyboard shortcuts (1-9) for instant chord switching
- Touch-friendly interface for mobile devices
- Real-time pattern playback during performance
**Interactive Piano**
- Visual scale and chord tone highlighting
- Click-to-play individual notes
- Dynamic feedback based on current key/mode selection
**Professional Audio Engine**
- Multiple instrument voices and sound synthesis
- Comprehensive effects processing (reverb, chorus, delay)
- 3-band equalizer for sound shaping
- Adjustable note duration and octave controls
### Data Architecture
The frontend leverages the PostgreSQL-driven backend that provides:
- **Comprehensive chord database** with all permutations of root notes and chord types
- **Modal scale analysis** across all keys and modes (Ionian, Dorian, Phrygian, etc.)
- **Harmonic relationship mapping** that identifies which chords naturally fit within each scale
Data is served through two pathways:
1. **Live API** via Spring Boot backend for dynamic queries
2. **Static JSON files** generated from database views for optimal performance
The static data generator extracts chord relationships from views like `mode_scale_chord_relation_view`, ensuring the frontend has instant access to music theory data without database latency during performance.