2.8 KiB
Raw Permalink Blame History

Listen to your Git repo!

This little script converts your Git repository to MIDI music.


There are 5 scales built in:

  • C major
  • A harmonic major
  • Chromatic
  • Pentatonic
  • D major


Programs in MIDI are effectively lists of instruments and effects to use. This script doesnt use effects (yet).

Here are the built-in programs you can use:

  • Sitar and Tablah (Indian style)
  • Bells (have you heard of Mike Oldfield? This will be familiar then)
  • Metal (because obviously)
  • Pure violin
  • Space (for futuristic repositories)
  • Sea-copter (Use this if you want some noise)


To create MIDI music, we use the MIDIUtil package. For reading Git repositories, we use GitPython.

Command line arguments

If you want to create music from a branch other than master (the default), you can specify it with --branch branchname.

If you want to save the MIDI file to the disk, use --file outputfile.mid

To play your MIDI file directly, use --play. This requires the pygame package to be installed.

If you want to see what is happening right now (can be useful with large repos), add --verbose to the command line.

To specify the scale to use, pass --scale scalename. There is no default, so you have to specify this. To list the scale names understood by the script, use --scale list.

To specify the program to use, pass --program pragramname. Again, there is no default, and you can list the available ones with --program list.

The volume of each note is randomized to get a more real feeling. By default, this means the lowest and loudest notes can have 100 units of difference. If this is too much for you (sometimes it can be annoying), specify a smaller number with --volume-range N (the valid range i0..255).

Some repositories begin with a huge import, when a lot of files were added to the repository. This can sound awful with some programs, so you might want to skip them. To do so, use --skip N, where N is the number of commits you want to skip.


If you have GTK+ 3.X installed and have the GObject Introspection stuff installed for Python (this is the default on many GTK based Linux desktops), if you dont specify a scale and a program on the command line, the GUI window will come up. Here you can set everything that is available from the command line, and follow visually what is happening in the background.


There are some features I want to add.

  • Skip or shorten large commits.


If you find a bug or have some ideas, open an Issue on GitHub.

If you can implement it, the better! Just go with the (GitHub) flow! Fork the repository, do the coding, and open a pull request.

Code of Conduct

In general, follow the Open Code of Conduct of the TODO Group.