Tools for algorithmic music composers and digital audio creators

View the Project on GitHub znmeb/AlgoCompSynth


AlgoCompSynth is a collection of tools for algorithmic music composition and digital sound synthesis based on Fedora Jam. For more details on Fedora Jam, see the Musicians' Guide.

The license for the code is GPL 3. The license for the documentation is Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0). Any music I produce with these tools will also use the CC BY-SA 3.0 license and will be distributed only in media formats free of lawsuit potential. If your device can't play them, get a better device.

Getting Started

  1. Install Fedora Jam on a machine.
  2. Install 'git':

    sudo yum install -y git
  3. Clone this repository with

    git clone
  4. To install the software, do

    cd AlgoCompSynth
    sudo ./install-all.bash
  5. During the install, the script will ask you to edit some system configuration files. First, you'll be editing '/etc/group'. You'll need to add any users that will be using the audio tools to the 'jackuser' and 'audio' groups.
  6. The DSSI tools require the machine's host name to be associated with 'localhost' in '/etc/hosts' for the GTK GUI to start. 'install-all.bash' will give you an edit session to set this. For example, if the host name is 'AlgoCompSynth' you would change the line in '/etc/hosts' with '' to localhost.localdomain localhost AlgoCompSynth

  7. At the end of the install, you'll be treated to a brief concert of synthesized sounds, courtesy of the sfront package. This includes a speech by a world-famous open source personality, so don't miss it!
  8. After the concert, you'll need to log out and back in again for the JACK tools to work. You should not need to reboot.

Troubleshooting lack of sound issues

If the concert played, most of the sound hardware and software is working! Here are a few more hints:

  1. Check your desktop settings. Make sure everything is enabled and the volume controls are at mid-point. Don't put the volume to full until you're actually getting sound!
  2. Rosegarden (and probably other tools) require the kernel module 'snd-seq-midi' to be loaded. The 'install-all.bash' is supposed to take care of this, but if you aren't getting sound, check it.
  3. For JACK to work, users need to be in the 'jackuser' group. As noted above, 'install-all.bash' will give you an edit window on '/etc/group', so you can add users to the group.
  4. The DSSI tools require the host name to be associated with 'localhost' in '/etc/hosts' for the GTK GUI to start. As noted above, 'install-all.bash' will give you an edit window on '/etc/hosts' to set this.
  5. If you're still not getting sound, reboot. If you're still not getting sound after the reboot, file an issue on Github.

Major tools in the project

To do / wish list for the future

Web Statistics