Skip to main content

This is a package for creating chords and fretboard visualisation of scale in svg format.

Project description


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.

How to install

pip install fretboardgtr


How to import the class

from fretboardgtr import ScaleGtr

Example of use


:warning: The default name of the svg is default.svg. Be careful to not have a file with this name already existing.

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 :


Name of the svg


For the second example you have to create a folder with the name Test before. (Creation of the folder is not yet implemented)

Create the object


If no root precised, C by default. If no scale precised, CEG (C major chord) precised.

Custom tuning


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.

Custom theme


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.

Custom color

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



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.


Example of use


:warning: The default name of the svg is default.svg. Be careful to not have a file with this name already existing.

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.

background fill example



  • enharmonics

  • list of scales ( Major, Minor, Dorian ..)

  • fingering on scale like this fingering = [[5,8],[5,7],[5,7],[5,7],[5,8],[5,8]] to draw pentatonic for example.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fretboardgtr-0.0.2.tar.gz (12.4 kB view hashes)

Uploaded source

Built Distribution

fretboardgtr-0.0.2-py3-none-any.whl (26.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page