Metadata-Version: 2.4
Name: shredderscales
Version: 1.0.4
Summary: Guitar-scales for any key and tuning
Home-page: https://github.com/jrw24/shredder-scales
Author: Jamie Wangen
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: matplotlib>=3.10
Requires-Dist: mpld3
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# 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](https://pypi.org/project/pip/) for installation

```bash
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:

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

example custom scale generation:

```bash
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:

```bash
shredder-scales-available
```

example python usage"

```python
from shredderscales import shredder

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

## Contributing

Pull requests and issues are welcome!
