Welcome!

PM123 is a high-quality digital audio player for IBM's OS/2 Warp and eComStation operating systems. You can play MP3s, WAV, OGG, FLAC and APE-files and even audio CDs. PM123 supports skins, audio streaming, plug-ins, visualization, FreeDB and more!

1. INSTALLATION

   If you have not used the WarpIN package to install this software, use makewps.cmd to create WPS Desktop objects for PM123.

2. DISTRIBUTION

   Sources for new updates for pm123:

   http://glass.ptv.ru/pm123.html
   http://hobbes.nmsu.edu/h-browse.php?dir=/pub/os2/apps/mmedia/sound/players

   Original mpg123:

   http://www.mpg123.org/

3. KNOWN ISSUES

   Missing Features

   - the genre list is not editable
   - the way the scroller scrolls is annoying for some people: need of a "wrap around scroller"
   - drag & drop skin would be nice
   - load all files from playlist file before loading information from each file would be nice
   - a "double size" would be nice
   - automatic fade in / fade out would be nice
   - add a status bar in the playlist window
   - no transparent or non-square skins because too difficult and ineffecient in OS/2
   - should load WinAmp skin directly instead of using a converter
   - no way to display customized information from each song in the playlist window or main window
   - no sound balance control
   - no skin for the equalizer, playlist, etc windows

4. COPYING AND COPYRIGHTS

   Please read first the important information in the COPYRIGHT and COPYING files.

   Original mpg123 decoder written/modified by:

     Michael Hipp
     Oliver Fromme

   with help and code from:

     Samuel Audet and Dmitry A.Steklenev: OS/2 port
     MPEG Software Simulation Group: reference decoder package
     Tobias Bading: idea for DCT64 in subband synthesis from maplay package
     Jeff Tsay and Mikko Tommila: MDCT36 from maplay package
     Philipp Knirsch: DCT36/manual unroll idea
     Niklas Beisert: MPEG 2.5 tables

   Graphical User Interface for pm123 by:

     Dmitry A.Steklenev (http://glass.ptv.ru/)
     Samuel Audet (http://www.step.polymtl.ca/~guardia/)
     Taneli Leppa

   Generalized Bitmap Module by:

     Andy Key (http://www.nyangau.fsnet.co.uk/)

   Fast Fourier Transformation Library:

     FFT123.DLL contains free collection of fast C routines for computing the Discrete Fourier Transform in one or more dimensions. FFTW was written by Matteo Frigo and Steven G. Johnson. You can contact them at fftw@fftw.org. The latest version of FFTW, benchmarks, links, and other information can be found at the FFTW home page (http://www.fftw.org).

   libsndfile:

     libsndfile is a library of C routines for reading and writing files containing sampled audio data. The main author of libsndfile is Erik de Castro Lopo.

   libogg and libvorbis:

     Vorbis is a general purpose audio and music encoding format contemporary to MPEG-4's AAC and TwinVQ, the next generation beyond MPEG audio layer 3. Unlike the MPEG sponsored formats (and other proprietary formats such as RealAudio G2 and Windows' flavor of the month), the Vorbis CODEC specification belongs to the public domain. All the technical details are published and documented, and any software entity may make full use of the format without license fee, royalty or patent concerns. Written by Monty and the rest of the Xiph.org Foundation (http://www.vorbis.com/).

   libflac:

     FLAC stands for Free Lossless Audio Codec, an audio format similar to MP3, but lossless, meaning that audio is compressed in FLAC without any loss in quality. This is similar to how Zip works, except with FLAC you will get much better compression because it is designed specifically for audio (http://flac.sourceforge.net/).

   maclib:

     Monkey's Audio is a fast and easy way to compress digital music. Unlike traditional methods such as mp3, ogg, or wma that permanently discard quality to save space, Monkey's Audio only makes perfect, bit-for-bit copies of your music (http://www.monkeysaudio.com/).

   WarpIN Installer:

     Thanks to Ulrich M”ller for the nice installer for OS/2. (http://warpin.netlabs.org)