Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Python music library
Branch: master
Pull request Compare This branch is 29 commits behind jdan:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
melopy
tests
.gitignore
MIT-LICENSE
README.markdown
requirements.txt
setup.py

README.markdown

Melopy (melo-pee)

A python library for playing with sound.

by Jordan Scales (http://jordanscales.com) and friends

on Github: http://prezjordan.github.com/Melopy

To install:

$ git clone git://github.com/prezjordan/Melopy
$ cd Melopy
$ python setup.py install

For examples, check out the examples directory:

$ python examples/canon.py
$ python examples/parser.py entertainer < examples/meeps/entertainer.mp

To run the tests: (we've got some errors to work out)

$ python setup.py test

or:

$ pip install -r requirements.txt
$ nosetests

Organization

Melopy is broken down into 3 subcategories - melopy, scales, and utility.

  • melopy.py contains the Melopy class
    • this is used for creating a Melopy and adding notes to it, rendering, etc
  • scales.py contains methods for generating scales
    • for instance, if you want to store the C major scale in an array
  • utility.py contains methods for finding frequencies of notes, etc

melopy.py

>>> from melopy import Melopy
>>> m = Melopy('mysong')
>>> m.add_quarter_note('A4')
>>> m.add_quarter_note('C#5')
>>> m.add_quarter_note('E5')
>>> m.render()
[==================================================] 100%
Done

scales.py

  • chromatic_scale
  • harmonic_minor_scale
  • major_pentatonic_scale
  • major_scale
  • minor_scale
  • major_triad
  • minor_triad
  • melodic_minor_scale
  • minor_pentatonic_scale
>>> from melopy.scales import *
>>> major_scale('C4')
['C4', 'D4', 'E4', 'F4', 'G4', 'A4', 'B4']
>>> major_scale('C4','dict')
{0: 'C4', 1: 'D4', 2: 'E4', 3: 'F4', 4: 'G4', 5: 'A4', 6: 'B4'}
>>> major_scale('C4','tuple')
('C4', 'D4', 'E4', 'F4', 'G4', 'A4', 'B4')
>>> minor_scale('D#5')  # has some bugs
['D#5', 'F5', 'F#5', 'G#5', 'A#5', 'B5', 'C#6']
>>> major_triad('A4')
['A4', 'C#5', 'E5']
>>> major_triad('A4', 'tuple')
('A4', 'C#5', 'E5')

utility.py

  • key_to_frequency
  • key_to_note
  • note_to_frequency
  • note_to_key
  • frequency_to_key
  • frequency_to_note
>>> from melopy.utility import *
>>> key_to_frequency(49)
440.0
>>> note_to_frequency('A4')
440.0
>>> note_to_frequency('C5')
523.2511306011972
>>> note_to_key('Bb5')
62
>>> key_to_note(65)
'C#6'
>>> key_to_note(304) # even something stupid
'C26'
>>> frequency_to_key(660)
56
>>> frequency_to_note(660)
'E5'

TODO

  • Get on PyPI
  • Create project page
  • Write to wav file bitwise? Rather than having an overhead
  • Add option to listen to files before rendering out (Render into RAM, play and then dump?)
Something went wrong with that request. Please try again.