This is a python package to draw fretboard (scales) and guitar chord diagram in svg format based on notes of scales or in finger positions.
pip install fretboardgtr
from fretboardgtr import ScaleGtr
F=ScaleGtr(scale=["G","A","B","C","D","E","F#"],root="G")
F.customtuning(['E','A','D','G','B','E'])
F.draw()
F.save()
The number in the image represents the degree of the scale, 1 is the root so it's G, 2 is the major second so A and so on.
If you want to show the note name instead :
F=ScaleGtr(scale=["G","A","B","C","D","E","F#"],root="G")
F.customtuning(['E','A','D','G','B','E'])
F.theme(show_note_name=True)
F.draw()
F.save()
F.pathname('Test.svg')
F.pathname('Test\Test.svg')
For the second example you have to create a folder with the name Test before. (Creation of the folder is not yet implemented)
F=ScaleGtr(scale=["G","A","B","C","D","E","F#"],root="G")
If no root precised, C by default. If no scale precised, CEG (C major chord) precised.
F.customtuning(['F','A','D','G','B','E'])
F.customtuning(['D','A','D','G','A','D'])
You can specify an array with all the note in your tunings ( DADGAD, Drop D and so on). The programm automatically calculate positions of the notes.
F.theme(show_note_name=True,color_scale=False)
You can highly customize the fretboard with all the following variables :
wf = 50 (width of fret)
hf = 70 (height of fret)
R = 20 (radius of circle )
background_color = 'rgb(255,255,255)'
fretcolor = 'rgb(150,150,150)'
strings_color = 'rgb(0,0,0)'
nut_color = 'rgb(0,0,0)'
fretsize = 3
string_same_size = False (If False first string bigger than the last)
string_size = 3
dot_color = 'rgb(200,200,200)'
dot_color_stroke = 'rgb(0,0,0)' (small dots on the neck)
dot_width_stroke = 2 (small dots on the neck)
dot_radius = 7 (small dots on the neck)
fontsize_bottom_tuning = 15 (fontsize of the tuning)
fontsize_text = 20 (Fontsize of text in circle)
open_circle_color = 'rgb(255,255,255)' (for open string)
open_circle_stroke_color = 'rgb(0,0,0)' (for open string)
open_circle_stroke_width = 3 (for open string)
open_text_color = 'rgb(0,0,0)' (for open string)
cross_color = 'rgb(0,0,0)' (Cross when doesn't play string )
fontsize_cross = 20 (Cross when doesn't play string )
fretted_circle_color = 'rgb(0,0,0)' (for fretted string)
fretted_circle_stroke_color = 'rgb(0,0,0)' (for fretted string)
fretted_circle_stroke_width = 3 (for fretted string)
fretted_text_color = 'rgb(255,255,255)' (for fretted string)
nut_height = 7
show_nut = True
first_fret = 0
last_fret = 12
show_tun = True
show_ft = True
color_scale = True (for the Scale class)
open_color_scale=False (for the Scale class)
show_note_name = False (if show_not_name==True, show_degree_name is not considered )
show_degree_name = True
color_chord=True (for the ChordGtr class)
open_color_chord=True (for the ChordGtr class)
You can return to the default parameter by pass this argument : default_theme=True and execute. You can also recreate the object.
F.set_color(root='yellow')
F.set_color(minorsecond='rgb(231, 0, 0)')
The available variables are the following : root, minorsecond, majorsecond, minorthird, majorthird, perfectfourth, diminishedfifth, perfectfifth, minorsixth, majorsixth, minorseventh, majorseventh
You can pass a classic color string ('black','yellow' ..) or a rgb string ('rgb(231, 0, 0)' for example).
You can return to the default parameter by pass this argument : default_theme=True
F.draw()
Draw and fill the fretboard.
You can add an optionnal parameter to the draw method F.draw(fingering=[1,2,3,4,5,6]) which draw the fingering like a guitar chord. All the theme parameters are not yet implemented.
You can precise the format in which you want to save the file. The followings format are available : SVG, PNG BMP, PPM , JPG , JPEG, GIF, PDF.
F.save(extension='pdf')
F.save(extension='PNG')
You can also just draw a scale diagramm with the root and the name of the scale. The following modes are available : Ionian, Dorian, Phrygian, Lydian, Mixolydian, Aeolian, Locrian, Melodicminor, Dorianb9, Augmentedlydian, Lydianb7, Mixolydianb13, Locrianbec9, Altered, Harmonicminor, Locrianbec13, Ioniansharp5, Doriansharp11, Mixolydianb9b13, Lydianbec9, Superlocrianbb7, Wholetone, Majorpentatonic, Minorpentatonic, Majorblue, Minorblues, Halftonewholetone, Wholetonehalftone, Dominantbebop, Majorbebop.
from fretboardgtr import ScaleGtr, ScaleFromName
F=ScaleGtr(ScaleFromName(root='F#', mode='Ionian'))
F.customtuning(['E','A','D','G','B','E'])
F.pathname('TestScaleName.svg')
F.theme(show_note_name=True)
F.draw()
F.save()
For convenience, modes are also defined as Enum:
from fretboardgtr import ScaleGtr, ScaleFromName, Mode
F=ScaleGtr(ScaleFromName(root='F#', mode=Mode.IONIAN))
F.customtuning(['E','A','D','G','B','E'])
F.pathname('TestScaleName.svg')
F.theme(show_note_name=True)
F.draw()
F.save()
You can also just draw a scale diagram with the root and the type of the chord. The following type are availables : M, (b5), 11, 11#5, 11b5, 13, 13#5, 13b5, 5, 6, 6b5, 7, 7#5, 7b5, 7sus2, 7sus4, 9, 9#5, 9b5, 9sus2, 9sus4, aug, aug6, dim, dim(maj11), dim(maj13), dim(maj7), dim(maj9), dim11, dim13, dim6, dim7, dim9, m, m#5, m(maj11), m(maj11)#5, m(maj13), m(maj13)#5, m(maj7), m(maj7)#5, m(maj9), m(maj9)#5, m11, m11#5, m13, m13#5, m6, m6#5, m7, m7#5, m7b5, m9, m9#5, maj11, maj11#5, maj11b5, maj13, maj13#5, maj13b5, maj7, maj7#5, maj7b5, maj9, maj9#5, maj9b5, sus2, sus2(#5), sus2(b5), sus4, sus4(#5), sus4(b5).
from fretboardgtr import ScaleGtr, ChordFromName
F=ScaleGtr(ChordFromName(root='C',quality='M'))
F.customtuning(['D','A','D','G','A','D'])
F.pathname('TestChordName.svg')
F.draw()
F.save()
For convenience, most common chords are also defined as Enum:
from fretboardgtr import ScaleGtr, ChordFromName, Chord
F=ScaleGtr(ChordFromName(root='C', quality=Chord.MAJOR))
F.customtuning(['D','A','D','G','A','D'])
F.pathname('TestChordName.svg')
F.draw()
F.save()
You can tell that you want enharmonic notes, for example in the D# mode there is 3 flat notes, the setenharmonic function is call and turns the scale into the more appropriate enharmonic scale
F=ScaleGtr(scale=['D#','F','G','G#','A#','C','D'] root='D#',enharmonic=True)
F.customtuning(['D','A','D','G','B','E'])
F.pathname('TestScaleNameEnhar.svg')
F.theme(show_note_name=True)
F.draw()
F.save()
F=ChordGtr(fingering=[0,3,2,0,1,0],root="C")
F.customtuning(['F','A','D','G','B','E'])
F.draw()
F.save()
The use of root is for the color of notes. By default it is set to 'C'. But if no color it has no influence.
The ChordGtr class has the same set_color(), theme(), save(), draw() methods as ScaleGtr.
F=ChordGtr(fingering=[3,3,2,0,1,0],root="C",lefthand=True)
F.customtuning(['F','A','D','G','B','E'])
F.pathname('lefthandchord.svg')
F.draw()
F.save()
F=ChordGtr(fingering=[0,3,2,0,1,0],root="C")
F.customtuning(['F','A','D','G','B','E'])
F.pathname('Test2.svg')
F.theme(show_note_name=True,background_color='rgb(70,70,70)')
F.draw()
F.save()
enharmonicslist of scales ( Major, Minor, Dorian ..)baseline-dominant problemsave format--lefthand- fingering on scale like this fingering = [[5,8],[5,7],[5,7],[5,7],[5,8],[5,8]] to draw pentatonic for example.