Releases: tomcontileslie/ThatChord
ThatChord v2.2.0
This is a release which enables fret specification for chord requests using the @
symbol. This allows the user to request that every string in the output chord be either muted or played above a certain requested fret. For example, you can impose that the chord C7
be played above the 3rd fret by typing C7@3
into the prompt. Below is a comparison of the soprano ukulele output for C7
and for C7@3
.
$ ThatChord % python3 thatchord.py -f text -o print C7
C7
=======
| | | O
| | | |
| | | |
| | | |
| | | |
$ ThatChord % python3 thatchord.py -f text -o print C7@3
C7
=======
| | | |
| | | |
O | O O
| O | |
| | | |
The prompt now understands the following formats:
- Chords of form
WX(Y)/Z@V:T
where:W
is a note, e.g.Db
,B#
orc
X
is a chord quality. e.g.sus4
,maj7
orM
. The quality dictionary is extensive but incomplete.Y
is a list of alterations, e.g.b5
,##6
orb5#9
.Z
is a bass note, same format asX
.V
is a minimum fret height specification.T
is a number. ThatChord returns what it considers to be the Tth best version of the chord.
- The prompt
SETTINGS
, which opens thesettings.py
file. - The prompt
CUSTOM L
, whereL
is a list of notes.
ThatChord v2.1.0
This is a release which restructures preset storage and adds functionality for Unix users.
- Presets are now stored in a dedicated
/presets/instruments/
directory under separate YAML files. New presets are now easier to add: simply create a new file namedINSTRUMENT.yml
, replacingINSTRUMENT
with the capitalised name of the instrument preset. Examples includeBANJO
andUKULELE-BARITONE-CHICAGO
. Any synonyms can also be specified in the _index.yml file. - @joshwd36 insightfully suggested some command line options using
sys
. Runpython3 thatchord.py --help
for more information on how you can alter the instrument settings from the command line, without modifying your actual settings file - a good tool for a one-time check on an instrument other than your main instrument. - @reiniscirpons kindly added splash compatibility for linux users.
ThatChord v2.0.0
Following release of ThatChord v1.0.0, v2.0.0 introduces a non-backwards-compatible change to the structure of the settings file. settings.py
is no longer to be modified by the user. Instead, a more lightweight and user-friendly settings file settings.yml
contains ThatChord's settings. Presets need no longer be entered necessarily in uppercase.
For users updating from v1.0.0: from v2.0.0 onwards, the additional module PyYAML is needed. Install by running the following shell commands:
cd ~/Documents/ThatChord
python3 -m pip install --upgrade pyyaml
ThatChord v1.0.0
This is the first stable ThatChord release. Settings are configurable via settings.py
. The prompt understands the following formats:
- Chords of form
WX(Y)/Z:T
where:W
is a note, e.g.Db
,B#
orc
X
is a chord quality. e.g.sus4
,maj7
orM
. The quality dictionary is extensive but incomplete.Y
is a list of alterations, e.g.b5
,##6
orb5#9
.Z
is a bass note, same format asX
.T
is a number. ThatChord returns what it considers to be theT
th best version of the chord.
- The prompt
SETTINGS
, which opens thesettings.py
file. - The prompt
CUSTOM L
, whereL
is a list of notes.