Skip to content
generate ambient music using JavaSound MIDI via Groovy
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Morbleu! An ambient music generator

This application generates pseudo-random ambient music using parameters passed to various compositional engines.

Hopefully, a side effect will be a convenient framework for working with MIDI in Groovy.

early result

At this point, if you cd to the src directory and say

groovy morbleu c-major

# or

groovy morbleu d-minor

It should produce ambient music through the local machine's MIDI synthesizer.

The aim is for the output to be highly adjustable. The eventual goal is to produce ambient soundscapes, but this happened along the way:


Groovy should be on the path, meaning Java should be on the path. It uses the javax.sound.midi library. The scripts are written to run in cygwin. They will probably work in Linux or on the Mac, but have not been tested. They're not complex, so you can look at them and run the commands by hand.

There are Java classes in the midi directory that need to be compiled using javac. The build bash script does that. A glance at the verbosity of the Java files will give you some idea why I do this in Groovy.


You can figure out what MIDI instruments Java thinks you have installed by running the info bash script.

Even if you don't have an external synthesizer, you can still use the one Windows provides (if you're using Windows). It isn't the best, but it should work.

Below is a sample:

Description: Internal software synthesizer
Name: Microsoft GS Wavetable Synth
Vendor: Unknown vendor
Version: 1.0
isOpen(): true
Maximum # of Transmitters: 0
Open Transmitters: 0
Maximum # of Receivers: -1
Open Receivers: 1
is instanceof Synthesizer: false
is instanceof Sequencer: false

Notice that even though it's a synthesizer, it reports that it's not a synthesizer. The key is that Open Receivers is 1, and not 0. That means it can receive playback messages via MIDI.

For accessing the above synth, I found it more functional to use "Gervill," which seems to be a JavaSound adaptor for it.

Hopefully you have something better to play back on, but this should work for testing.

the Player object

You can write your own very easily. Here's a script that plays middle C, holds it for 4 seconds, then closes (called

import midi.Player

gervil=new Player('gervil') // the microsoft GS synth



The Player constructor does a very wide search on the "name" field of the MIDI info for the device.

You can run the script by saying

groovy simple.gvy

To hear the ambient experiment try

groovy morbleu d-minor

NOTE: Morbleu listens to Enter from the keyboard as a signal to shut down its threads. It does not automatically shut off notes if you interrupt with ctl-C and are using an external synth. If you do so, be prepared to reset manually.


Some code tweaks may be required depending on your setup. It's in a state of flux. The directory is cluttered. Java Sound is finicky.

See ./ to see what may eventually get done.

You can’t perform that action at this time.