UModPlayer

Open-source audio module player for UNIX® operating systems

Main Features
Get the Software
CVS Development Versions
Examples
Screenshots
Licensing
Contact
Thanks
SourceForge.net project page

Latest Version: UModPlayer B5, September 15th 2006

Welcome to the UModPlayer homepage.

UModPlayer or Universal Module Player is a audio module "tool-chain", providing you functions to work with modules like playing, exporting, getting information, and more.

It should work fine on any UNIX system, although it has only been more-or-less tested on NetBSD® and Linux®.

UModPlayer uses the high-quality LibModPlug module rendering library.

Main Features

You can play the supported formats and seek to any order in the song. You have pause, timer, display, and other standard features.
You can view the pattern notes while playing.
Playlist support: you can create playlists, delete or move individual items in a playlist, import a playlist from the current directory contents, save a playlist and load a saved playlist...
You can specify any of the ModPlug options: noise reduction, megabass, surround, reverb sound options specifying the grade and the delay of most of the options.
You can export the audio data of a module to any of the supported formats (see below)
You can read and export to a file the song builtin message, the song instrument names and the song sample names.
Each user of your UNIX box can save all the sound options.
And much more!

Exporting Formats

WAVE Audio File (WAV)
Audio Interchange File Format (AIFF)
Raw Pulse Code Modulation (PCM)
Impulse Tracker (IT) [*]

For the WAV, AIFF and PCM exportings you can use different sound options

[*] IT export is available only if ModPlug was compiled with save support

Get the Software

UModPlayer B5.1, released September 16th 2006

Download UModPlayer B5.1 source tarball [multiplatform, gzipped] (~35 KiB)

[Changelog]

Requirements

The following libraries (and their correspondent 'development' packages in order to compile from sources) are required by UModPlayer:

LibAo: LibAo provides audio output for a lot of platforms.
LibModPlug >= 0.8 : LibModPlug is a high-quality module rendering library supporting dozens of formats. Note that you need at least the 0.8 version.
LibAiff >= 1.1 : LibAiff provides AIFF file support. Although LibAiff 1.1 will work, it's highly recommend to install at least the version 2.0.

The UModPlayer versioning system

UModPlayer Xa.b, where X is the major release from A to Z (and then AA, AB, AC, and so on), a is the minor release number and b the patch-level.

If a or b is 0, then it's not necessary to specify it. The first UModPlayer release was UModPlayer A.

CVS development versions

Although it's generally recommended to use the released versions, you can checkout CVS versions to get the latest features and improvements. Note that CVS versions might crash or fail to compile...

Type the following UNIX commands to checkout the latest development sources:

cvs -d:pserver:anonymous@umodplayer.cvs.sourceforge.net:/cvsroot/umodplayer login
cvs -z3 -d:pserver:anonymous@umodplayer.cvs.sourceforge.net:/cvsroot/umodplayer checkout -P umodplayer

You can also use CVSWeb to take a look to the sources and changes via your web browser.

Examples

To enter interactive mode:

% umodplayer

To play a module:

% umodplayer MyModule.xm

To play a module with volume 256, surround, megabass and spline resampler:

% umodplayer -v 256 -M SPLINE +S +B piece.stm

To play a module using the IRIX audio driver:

% umodplayer -O irix file.it

To export audio as 24-bit AIFF:

% umodplayer song.s3m -o song.aiff -f aiff24

To export audio as raw system-endian 16-bit mono 22050Hz PCM:

% umodplayer piece.mod -c 1 -r 22050 -o audio.raw -f s16se

To export song instrument & sample-names to a file:

% umodplayer foobar.it -I foobar.instruments -s foobar.samples

Screenshots

UModPlayer being operated from the command interpreter

Lines with notes displayed, such as C-3, G#6, etc. Each text line corresponds to a row in the module. Lines are numbered.

UModPlayer displaying pattern notes

Licensing

UModPlayer is released under the Public Domain. This means that you can do anything you want with it, including redistribution, modification, etc.

However, some of the libraries which UModPlayer uses are released under the GNU GPL. This means that a statically-linked binary of UModPlayer with such libraries will be covered by the GPL.

Contact

You can contact the project maintainer <via e-mail> if you want to help with the project, or for any suggestion, note, comment, bugs, etc.

Reporting bugs: What to do if UModPlayer segfaults

If UModPlayer crashes with a segmentation fault error, you can send us a "backtrace" which provides the status of the program when the crash occurs.

If you have the GNU debugger installed, run UmodPlayer with it (gdb umodplayer and then run <arguments>), reproduce the operations which caused it to crash, and then run the backtrace command.

If the crash is caused by a concrete module, send it too if you can. Thanks!