shredderscales 1.0.5

Guitar-scales for any key and tuning

shredder-scales

shredder-scales is a python package that allows look-up of guitar scales given a key, scale, and tuning and outputs a plot showing the valid note positions on the fretboard.

The program accepts any number of guitar strings and any tuning without restriction to standard tunings. The number of guitar strings will be set based on the entered tuning.

For example:

• 'EADGBE' will set standard 6-string tuning
• 'G#D#G#C#F#A#D#' will set drop G# 7-string tuning
• 'F#BEADGBE' will set standard 8-string tuning

If a desired scale is not present in the library, custom scales can also be entered based on the intervals in the scale

Installation

Use the package manager pip for installation

pip install shredderscales

Options

required:
--scale: scale to use for retrieiving notes, ex:'major'
--key: key to use for choosing notes, ex:'C'

optional:
--tuning: tuning of guitar for plotting notes, ex:'EADGBE'
--flats: whether to use sharps or flats for accidentals
--fretnumber: number of frets to plot, max==24 
--mode: mode to display notes on scale['note', 'degree', 'interval']
	- note will display the note at each position: 'C', 'Eb', ect.
	- degree will display degree in that scale: '1', 'b2', '#4', ect.
	- interval will display the distance from root note: 'M2', 'P5', 'm6'
--outdir: directory for saving output plot if run locally
--django: set to '1' for outputing figure as html

custom scales: set --scale='*custom*' and include:
--scale_name: a name for the new scale
--scale_intervals: comma seperated list with interval spacing for each note
	- for the major scale, enter: 0,2,4,5,7,9,11

Usage

example command line usage:

shredder-scales --scale='major' --key='F' --tuning='CGCFAD' --outdir='/path/to/outdir'

example custom scale generation:

shredder-scales --scale='*custom*' --key='E' --tuning='EADGBE' --outdir='/path/to/outdir' --scale_name=new_scale --scale_intervals=0,1,4,7,8,10,11

to print out all available scales:

shredder-scales-available

example python usage"

from shredderscales import shredder

shredder.main(scale='minor', key='G', tuning='BEADGBE')

Contributing

Pull requests and issues are welcome!