Overview Download Docs Demo-Room

API JMF+config

JMF configuration

I've not completed any installation manager for the Java Media Framework yet, so to make the J-Ogg libraries known to the system, you have to make a few simple configuration entries using the JMF Registry tool included in the JMF base installation.

File installation

The first step you have to do is to include the necessary jar files in your class path, or simply copy them to the /jre/lib/ext directory of your JRE installation. The following components are needed:

J-Ogg JMF (mandatory)
J-Ogg Ogg (mandatory)
J-Ogg Vorbis (optional)
J-Ogg FLAC (optional)
J-Ogg Theora (optional)

MIME type registration

After setting the class path or copying the jar files to the extension directory, you can make the configuration settings in the JMF registry. The first step is to click on the "MIME Types" tab of the JMF Registry application and add a relation between the MIME type "application/ogg" and the files extension "ogg". Be sure to click the "commit" button to save your changes.

Ogg demultiplexer registration

Now, click on the "PlugIns" tab and add a reference to the plug-in "de.jarnbjo.jmf.OggParser". Be sure to click the "commit" button to save your changes.

If you select the installed plug-in, you should see in the "plugin details" frame, that the content types "application/ogg" and "application/x-ogg" as supported as input formats.

Codec registration

After registering the Ogg demultiplexer, you can continue with the Vorbis, FLAC and Theora codecs. Depending on which optional components you have installed, click on the "Codec" tab (next to the "Demultiplexer" tab) and add entries for the following plug-ins:

de.jarnbjo.jmf.VorbisDecoder
de.jarnbjo.jmf.FlacDecoder
de.jarnbjo.jmf.TheoraDecoder

Be sure to click the "commit" button to save your changes.

The plug-ins should now be shown in the codec list, and you can get detailed information about the supported input and output formats if you select any one of them.

Installation complete

After completing these steps, you should be able to use any JMF based application (like JMStudio) to read or playback Ogg/Vorbis, Ogg/FLAC and Ogg/Theora files.