NAME

 Audio::Play::Play::MPG123 - generic frontend for mpg123

SYNOPSIS

 use Audio::Play::MPG123;

 $player = new Audio::Play::MPG123;
 $player->load("kult.mp3");
 print $player->artist,"\n";
 $player->poll(1) until $player->stat == 0;

 $player->load("http://x.y.z/kult.mp3");

 # see also mpg123sh from the tarball

DESCRIPTION

 This distribution contains a module that can be used to control an
 mpg123 process and a sample application that implements a "mp3 player
 shell" on top of it.

 I wrote it because I really hate all these nifty frontend that take
 sparse desktop space. Xmms came close, but I couldn't get it to work
 (xmms, not the pelr interface module), so I wrote my own wrapper around
 mpg123.

INSTALLATION

 Get your hands on a suitable mpg123 player. While version 0.59r or
 above should work, it uses more resources and contains many bugs
 (frequent deadlocks or worse), so I recommend to use the included
 version instead, which has many bugfixes and some enhancements (notably
 irix 6.2 support).

 In short: look in the subdirectory mpg123/, compile the mpg123 binary
 and put it somewhere in your path or edit the variable $MPG123 in the
 file MPG123.pm to point to its location.