Listen to your repo
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Gergely Polonkai 667df46f64 Add README file 6 years ago
git_sound Add Python 3 compatibility 6 years ago
.gitignore Update .gitignore 6 years ago
COPYING Add COPYING file (license) 7 years ago Add README file 6 years ago Refactor GUI and GitMIDI into separate files 7 years ago
git-sound.ui Make beatlen actually work in the GUI 7 years ago
notes.txt Initial version 7 years ago
requirements-play.txt Add requirement files 6 years ago
requirements.txt Add requirement files 6 years ago

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.