a small toolkit to compose simple music

Noah 76a5976a57 added documentation generator 4 years ago
doc 76a5976a57 added documentation generator 4 years ago
media b9ac8dc77e add README 4 years ago
src a45b0cf80e fix TODOs and now get number from command line 4 years ago
tests b9ac8dc77e add README 4 years ago
.gitignore a8cf2281d0 better mac compliance 4 years ago
README.md 76a5976a57 added documentation generator 4 years ago

README.md

gizmo

gizmo is a simple toolbox to create some simple melodies using python. The beauty about is, that you only need a single motive to create a little song.

Note: This program uses the music21 library.

Dependencies

You can install the only python module that is not in the default library using pip:

pip install music21

the 'gizmo notation'

For a simple toolkit you need a simple notation that abides to the unix philsphoy. So we made a now one that consists simply of lines in a plain text file.

Every line contains the information about one note. Seperated by apostrophes there are different attributes specified for each note. Every attribute seperated like this is called a 'part':

  • The first part is a four characters long float that contains the length of the note in quarters.
  • The second part is two to three chars long. The fist character is the Note value (capitalized) and the second one the octave (as a integer). The third char is optional and just the key signature in the form of either "#" or "-".

Here an example in the gizmo notation:

1.00,G4
1.00,E4
0.50,D4
1.00,C#4

Now the same example in sheet music:

Rendering

After you fully processed your music in the gizmo notation you can run it through the script called final-converter to export your work as a .musicXML file. This file can be viewed and further edited/processed in other free software like MuseScore.