Welcome!

PM123 is a high-quality digital audio player for IBM's OS/2 Warp operating system. You can play MP3s, WAV-files and even audio CDs. PM123 supports skins, audio streaming, plug-ins, visualization, CDDB 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.

   If you install this package over the PM123 version less than 1.32, you need to add manually oggplay.dll to the list of decoders using PM123 properties dialog.

2. DISTRIBUTION

   Sources for new updates for pm123:

   http://glass.ptv.ru/software/english/pm123.html
   http://hobbes.nmsu.edu/pub/os2/apps/mmedia/sound/players/

   Original mpg123:

   http://www.mpg123.org/

3. KNOWN ISSUES

   Bugs

   - the GUI freezes in various places due to network access and the need of threads for such operations.
   - there still might be occasional redraw problems where pm123 plagues the whole screen, not just pm123's windows.

   Missing Features

   - continuous playback would be nice
   - the genre list is not editable
   - no support for ID3v2
   - the way the scroller scrolls is annoying for some people: need of a "wrap around scroller"
   - the "remote control" pipe does not report if pm123 is playing or not (example: a "echo *status > \pipe\pm123" returning "stopped", "paused" or "playing" would be nice)
   - FLAC, etc support... a generic plug-in that could use command line decoders would also be nice
   - drag & drop skin would be nice
   - no support for "new" WinAmp 2.x or 3.x skins, only old ones for WinAmp 1.x
   - 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
   - no history for the "Load URL" dialog
   - 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
   - when loading an MP3 stream, there is no feedback when the buffer is filling up
   - 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/)
     Taneli Leppa
     Samuel Audet (http://www.step.polymtl.ca/~guardia/)

   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.xiph.org).

   WarpIN Installer:

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