a small toolkit to compose simple music

Noah 89a9f859b7 merging and fix patch 4 years ago
doc 997ae400a7 better naming + update dependecies in the documentation 4 years ago
media b9ac8dc77e add README 4 years ago
src 89a9f859b7 merging and fix patch 4 years ago
tests 6d58e5846f fix unix compliance + remove hardcoded inputfile from xml-parser 4 years ago
.gitignore a8cf2281d0 better mac compliance 4 years ago
LICENSE 7ce123d4cd apply gpl v3 4 years ago
README.md 7ce123d4cd apply gpl v3 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.

Licensing

Gizmo is a free (as in “free speech” and also as in “free beer”) Software. It is distributed under the GNU General Public License v3 (or any later version) - see the accompanying LICENSE file for more details.

Dependencies

First of all you need python3 including the standard librarys. Now install the only needed additional module 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 new one that consists simply of lines in a plain text file.

Every line contains the information about one note. Seperated by commas 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 an 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.