Summary	Java Sound MODules Player
Categories	None
License	*Other*
Owner(s)	oxygenic

JMOD - Java Sound MODules Library

Overview

Sound Modules (MODs) are music files that contain samples and replaying information. They are known from the Amiga(tm) and other computer systems and are able to offer high quality music togehter with small file sizes. The Java Sound Modules Player library is able to load, decode and replay such files using standard Java Sound. This library supports .MOD, .XM, .S3M, .IT and .ZIP module formats.

JMOD is a fork of the project ANA-MP. The main differences are that JMOD is a library that is really small, fast and efficient (no GUI or other fancy features that aren't necessary for a replaying library), that it is fully compatible with and compilable under Java 1.3 (the first Java version with sound support) and of course that it is alive and active.
The JMOD library can be added to own projects and included into an existing GUI there.
For future releases a J2ME variant of it is planned.

License and Download

The JMOD source codes are licensed under the LGPL.

Additionally people who have contributed something to the project that was useful and added to it (test data, code, documentation,...) will be added to our list of contributors.

After the project JMOD offers code that is intended to be used by programmers, we expect that everybody is able to help this project a little bit. Please pay attention to the fact that open source works after the principle of "participate", not "take"!

The latest release of the JMOD library (including a player class for testing or for usage as command line modules player) can be downloaded here.

Usage

The Java Sound MODules Player comes as a library that can be used in own programs. There are several examples available that demonstrate how to use the library.

To use the Sound MODules Player in own projects, simply copy the com-directory out of the CVS into your projects source folder and do an

import com.vwp.sound.mod.*

to get access to its functionalities.

Demo

A demo running an applet using the JMOD modules library can be found here. It is replaying the Hardwired-intro out of the legendary, emponymous Amiga(tm) demo from The Silents Denmark.

Test Data

This section contains some special data submitted by users and / or developers that can be used for testing.

• Odyssey Part1 - module with (currently unsupported) filter effect E0x
• Radio Moscow by Jesper Kyd / The Silents Denmark - module with (currently unsupported) filter effect E0x and invert loop effect EFx
• Garbage Collection by Peter Salomonsen - excessively uses Protracker effects and sounds a little bit different with JMOD

Become a Developer

With the developer role you would be able to write-access the CVS and therefore take part at the development directly. To avoid problems with people that request that role only for fun, to disturb the project, to submit trash willful and to do other evil things that are imaginable we are not able to grant that role to people we do not know.
So following procedures are possible to get the developer role at the project JMOD:

• Request the Observer role to get full read access to the sources
• Take part at the discussion at the developers mailing list dev@jmod.dev.java.net and submit code there

or

• Request the Observer role to get full read access to the sources
• Send us some information about yourself, your skills, at what projects you took part and other things like that so that we are able to imagine who you are; please send these information to the developers mailinglist dev@jmod.dev.java.net or directly to the project owner oxygenic (at) dev.java.net

...and afterwards request the developers role.

How you can help

The most important things that are required at the moment are

• support for some more module formats (.STM, .WOW and more variants of the .MOD format)
• add support for XM autovibrato
• implement support for missing effects "Set filter" (effect E0x, probably by turning the interpolation off and on?) and "Invert loop" (effect EFx)

Whenever you have some piece of code that fixes problems / implements new functionality please let me know.

Contributors

Special thanks for their help with this project go to

• Peter Salomonsen for some testdata
• Jesper Kyd / René Vidum of The Silents Denmark for their modules