gciruelos/musthe

Music theory implemented in Python. Notes, intervals, scales and chords.

musthe

Music theory implemented in Python. Notes, scales and chords.

It is still in development so feel free to read the code, fork and make pull requests! They are very welcome!

Installation

To install:

$ pip install musthe

Development install

To install as development:

(Optional) Create a virtualenv:

$ python -m venv env
$ source env/bin/activate

Then install:

$ pip install -e .

How to use

It is very simple, everything is coded in a object-oriented style, for example:

$ python
>>> from musthe import *
>>> a = Note('A')  #Default A4
>>> a
Note("A4")
>>> str(a)
'A'

Suppose you want to create tension, so you want the perfect fifth or the minor seventh of that A, so you do:

>>> fifth = Interval('P5')
>>> seventh = Interval('m7')
>>> a+fifth
Note("E5")
>>> str(a+fifth)
'E'
>>> str(a+seventh)
'G'

Though it is important to see that the octaves of those notes are different:

>>> a.octave
4
>>> (a+seventh).octave
5

Now let's see basic chord usage:

>>> Chord(Note('A'), 'M')
Chord(Note('A'), 'M')
>>> Chord(Note('A'), 'M').notes
[Note("A4"), Note("C#5"), Note("E5")]
>>> Chord(Note('Bb'), 'dim').notes
[Note("Bb4"), Note("Db5"), Note("Fb5")]

You can use a string to construct a chord:

>>> Chord('C#aug7') == Chord(Note('C#'), 'aug7')
True

Default chord type is 'M' (Major).

Now lets try scales:

>>> s = Scale(Note('B'), 'major')
>>> [s[i] for i in range(len(s))]
[Note('B4'), Note('C#5'), Note('D#5'), Note('E5'), Note('F#5'), Note('G#5'), Note('A#5')]
>>> s[0]
Note('B4')
>>> s[-11]
Note('E3')

It return a list of Note instances, so if you want a cleaner result should do something like:

>>> s = Scale(Note('B'), 'major')
>>> [str(s[i]) for i in range(len(s))]
['B', 'C#', 'D#', 'E', 'F#', 'G#', 'A#']

To check if notes and chords are contained in a given scale:

>>> Note('D#3') in s
True
>>> Note('F3') in s
False
>>> Chord('C#m') in s
True
>>> Chord('CM') in s
False

Now let's try some advanced stuff: given a list of chords, find all scales that contain those:

>>> chords = [Chord('Cm'), Chord('Fm7'), Chord('Gm')]
>>> for scale in Scale.all():
...     if chords in scale:
...         print(scale)
...
C natural_minor
Eb major

If you have lilypond installed, you can make little melodies using this program, an example is given in 'lilypond_example.py'

Running Tests

From the project root directory, run:

python -m tests.tests

Contributors

• zsinx6
• Federico Ferri
• Gonzalo Ciruelos
• David H
• nvoster
• Sylvain
• Edgar Gavrik
• Sri Raghavan
• Augustus Wynn
• Marco Heins

License

See license file.

musthe's Issues

C# != Db

>>> Note('C#4') == Note('Db4') 
False

error: interval d3

d3 should be 2 semitones, not 3

(line 144 of musthe/musthe.py)

Reference: intervals table in https://en.wikipedia.org/wiki/Interval_(music)#Main_intervals

Notation for sixth chords?

What notation could/should be used for sixth chords (i.e. added sixth chords)?

How refactor project to a standard python package?

I was wondering about that because I wanna put on Arch Linux Repository and provide too a simple command line interface to do some cool stuff like:

> musthe scale c-major
C D E F G A B

How about that?

why is 12.

%12 because it wraps in B->C and starts over.

why is 12.

and

" e.g. the fifth of

E is: (E F G A) B."

what it's meaning?

thanks for your answer.

Conflicting repositories

@gciruelos Could you merge from https://github.com/nvoster/musthe ? I would like to contribute, but it doesnt seem right to just start working on @nvoster

Note.__add__ method exception with flatened A & minor 3rd interval

Note('Ab')+Interval('m3') throws the following exception:
Could not parse note: C#################4

Same with Abb & Abbb.
Other combinations of notes + intervals do all work as far as I tested them.

Exception: Could not parse the note: C#######################4

>>> from musthe.musthe import *
>>> scale(Note('F'), 'locrian')
Traceback (most recent call last):
  File "<input>", line 1, in <module>
    scale(Note('F'), 'locrian')
  File "[...]/musthe/musthe/musthe.py", line 26, in scale
    return [note] + [note+Interval(i) for i in scales[scale_name]]
  File "[...]/musthe/musthe/musthe.py", line 26, in <listcomp>
    return [note] + [note+Interval(i) for i in scales[scale_name]]
  File "[...]/musthe/musthe/musthe.py", line 118, in __add__
    return Note(new_note_tone+accidental+str(new_note_octave))
  File "[...]/musthe/musthe/musthe.py", line 57, in __init__
    raise Exception('Could not parse the note: '+note)
Exception: Could not parse the note: C#######################4