retorte.ch title image
back / German Version

{IntervalMusicCompositor}

Introduction
Features
Instructions
Download
Known Problems
Legal

Keywords: interval training, circuit training, physical education, PE, sports, music, exercise music, break, iteration, workout, automated generation, compilation

{introduction}

IntervalMusicCompositor is a small, multi-platform software which generates a random interval sequence out of an arbitrary number of music files. One can choose the duration of the music parts and the intermediate breaks as well as the number of iterations. The output is a single, large audio file to be processed further or burnt to cd.

The german-language professional journal mobile, a periodic publication by the swiss Federal Office of Sports about physical education, published a short review on the Interval Music Compositor in its 1/2010 issue:
mobile 1/2010 (p. 39); "Für Sie gelesen – Intervallmusik einfach zusammenstellen"

The main purpose is the generation of music compilations for the use with circuit or interval training in physical education. Certainly it can be used for any purpose where a compilation is desired but the exact position of the extracts does not matter. For example one can create a representative audio overview over a music CD in seconds.

Interval Music Compositor schematic

Envelope of a resulting audio file:

Interval Music Compositor output file envelope

{features}

What it does

  • Reads audio files (tracks) in current directory
  • Shuffles or sorts them
  • Ignores the first and the last 5 seconds of a track
  • Discards tracks which are too short
  • Takes a random extract of the tracks
  • Normalizes the volume of the extract
  • Composes them together to one big output file (compilation)
  • If there are not enough tracks to fill the compilation, it starts from anew
  • Stores the playlist data in a textfile
  • Displays the audio envelope of the compilation for test purposes

Supported input file formats

  • WAV
  • MP3
  • OGG
  • FLAC

What it needs to be run

  • Lots of diskspace (the temporary files and the output file need 10MB per minute music): 1GB
  • Lots of main memory
  • Installed Java Runtime Environment (Version 6)

Output file format

The resulting sound file is a 16bit, 44.1KHz, stereo WAV file

{instructions}

Installation/Preparation

The IntervalMusicCompositor comes as a single executable file. No installation is needed therefore. However, it is based on Java technology, thus a Java Runtime Environment (JRE) must be present to run it.
If you don't have one installed, you are prompted to do so on the first start of the software on the Microsoft Windows version. Users of Linux and Mac OS X operating systems are expected to have one installed already.

Usage

  1. Choose a directory or create a new one
  2. Put the IntervalMusicCompositor program file into this directory
  3. Put all the audio files you'd like to have compiled into this directory
  4. Start the IntervalMusicCompositor by double-clicking it
  5. (If necessary, follow the instructions for installing the Java Runtime Environment)
  6. The program window appears. Enter the desired values for the ordering method of the tracks (random or alphabetically sorted by filenames), the length of the sound samples (in seconds, i.e. 30 seconds), the fade-in/out period (i.e. 1 second), the length of the breaks (in seconds, i.e. 10 seconds) and the number of sound samples you'd like to have in the end (i.e. 12 samples)
  7. Press the 'Process' button
  8. Wait some time (around 1 to 10 s per track, depending on the speed of your computer and the length of the track), the tracks are now being loaded and analyzed
  9. If it says 'Finished' in the progress bar, the output sound file (in this example '30_10_12_imc_out.wav', the numbers match the entered values) and the according tracklist ('30_10_12_playlist.txt') have been generated (this is, unless there were some serious problems). You can check the audio envelope to determine if the output file is ok. If you chose 'random' and don't like the order of your tracks, just restart the process

Interval Music Compositor screenshot

{download}

The current version 1.0.0 was issued on 5th August 2010.
(
Changelog)
The software is provided free of charge. Please send me an email if you encounter errors or strange behavior.

I hereby declare: The software is free of malicious and snoopy parts in any way.

Linux version

Linux version
Version 1.0.0: IntervalMusicCompositor-1.0.0.tar.gz (460 KB)

The archive consists of two files; a start script 'IntervalMusicCompositor' and the Java file. Start the program by either double clicking on the start script or calling it from the shell:

user@localhost $ ./IntervalMusicCompositor &

If you are one of the rare species without JRE installed, call this to install one (on Debian or Ubuntu):
user@localhost $ sudo aptitude install sun-java6-bin

Mac OS X (>= 10.5) version

Mac version
Version 1.0.0: IntervalMusicCompositor-1.0.0.dmg (800 KB)

After the download the file image containing the program is automatically mounted. You can then drag the program into a folder of your choice.

Microsoft Windows (XP, Vista, 7) version

Microsoft Windows version
Version 1.0.0: IntervalMusicCompositor-1.0.0.zip (480 Kb)

This is just a simple executable in a ZIP file which can be unpacked and then placed in the folder of your choice and executed directly.

Legacy version

For users with older systems, where there still runs Java 5 (version 1.5) i prepared a stripped down older version of the IntervalMusicCompositor which is supposed to run on these:

Linux: IntervalMusicCompositor-0.0.9legacy.tar.gz
Mac OS X: IntervalMusicCompositor-0.0.9legacy.dmg
Microsoft Windows: IntervalMusicCompositor-0.0.9legacy.zip

Source code

Oh, perhaps later...

{known problems}

  • Some MP3 files seem to have a wrong encoding. These are ignored.
  • If a filename has some nasty characters in it, the file is ignored.
  • It occasionally occurs that some temporary files are not deleted on the Microsoft Windows version. The temporary files of the IntervalMusicCompositor have the extension .imc_wave and can be safely deleted manually after the software has quit.
  • On Mac Os X computers it may be that the wrong Java version is selected. The program will then only run for a second and close again immediately after being started. Start the 'Java Settings' (Applications -> Utilities) and move Java Version 6 to the top of the list to fix it. If there is no Version 6 of Java you probably have to update your operating system to obtain it.
  • MP3 files in exotic encoding (sampling frequency lower than 44.1 kHz) are in some cases played faster in the output file. Such only available in mono are reduced to one channel.

{legal}

Freeware.
You're using it at your own risk! :)

top