Go to file
pszsh 3fb782c52b This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
www This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
.DS_Store This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
.gitignore 1 2025-03-30 08:02:05 -07:00
README.md Update README.md 2025-03-30 08:59:29 -07:00
chords.py 1 2025-03-30 08:02:05 -07:00
config.json This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
intervals.py This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
main.py This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
requirements.txt This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
template.html This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
triad.py This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00
utils.py This is the only commit that will still be the python version. I'm switching this to Go. But I felt it would be best to have one archival commit for it lest I lose track later on. Godspeed. 2026-02-28 00:58:08 -08:00

README.md

web-tuner

A neat little tool for custom tuning string instruments.

Setup

python -m venv venv
source venv/bin/activate  # or 'venv\Scripts\activate' on Windows
pip install -r requirements.txt

Configuration

Edit the config.json file to customize your chord generation:

  • Strings: Add/remove strings and use sharps (#), flats (b), or a mix.
  • max_fingers: Set the maximum number of fingers allowed per chord. (Note: Not always respected yet.)
  • max_frets: Controls how far up the neck to search for chords.

Warning: Even on a powerful computer, setting max_frets higher than 5 can slow things down a lot. You've been warned!


Run

python main.py > output.txt

it will be much slower if you don't output it to a file instead of the shell, but if you want to see the debugging messages, just run the command normally. That's all, playable chord shapes from any tuning you put into the config will be generated. View them by opening chords.html, which will be generated into www/