| 1 |
ABOUT MPG321 |
| 2 |
------------ |
| 3 |
|
| 4 |
mpg321 is a Free replacement for mpg123, a very popular command-line mp3 |
| 5 |
player. mpg123 is used for frontends, as an mp3 player and as an mp3 to |
| 6 |
wave file decoder (primarily for use with CD-recording software.) In all |
| 7 |
of these capacities, mpg321 can be used as a drop-in replacement for |
| 8 |
mpg123. |
| 9 |
|
| 10 |
mpg321 is a project conceived and written by Joe Drew <[email protected]>. |
| 11 |
It uses code from the MAD distribution by Rob Leslie; XMMS; and plaympeg |
| 12 |
from the SMPEG distribution. mpg321 is licensed under the GNU General |
| 13 |
Public License version 2, as documented in the 'COPYING' file. |
| 14 |
|
| 15 |
WHY MPG321? |
| 16 |
----------- |
| 17 |
|
| 18 |
mpg123 is very popular because of its relative simplicity and its general |
| 19 |
facility. It is very good at what it does. It is, however, under a non-free |
| 20 |
license: you can't incorporate its code into your own without getting |
| 21 |
special permission, and commercial entities also need special permission |
| 22 |
just to use it. |
| 23 |
|
| 24 |
Being a Free Software advocate, I saw a deficiency in the dependency many |
| 25 |
people had on mpg123. Therefore, I created mpg321, and as more features |
| 26 |
of mpg123 are implemented, it becomes less and less likely that anyone |
| 27 |
will need mpg123 for anything any more. |
| 28 |
|
| 29 |
INSTALLING MPG321 |
| 30 |
----------------- |
| 31 |
|
| 32 |
Please read the document 'INSTALL' to find mpg321's dependencies and |
| 33 |
configuration, compilation and installation instructions. |
| 34 |
|
| 35 |
mpg321 has been tested on Debian GNU/Linux (x86), as well as Sun Solaris |
| 36 |
(UltraSparc). It is also available from several BSD vendors, and may be |
| 37 |
included in other Linux distributions. Any problems encountered on any |
| 38 |
system, though, should be reported to the author. |
| 39 |
|
| 40 |
GETTING INVOLVED/INFORMED |
| 41 |
------------------------- |
| 42 |
|
| 43 |
If you like mpg321, please donate to the Electronic Frontier Foundation (EFF). |
| 44 |
They help ensure that software for any purpose can continue to be written |
| 45 |
legally. Find out more information at http://www.eff.org . |
| 46 |
|
| 47 |
To be informed of any new releases of mpg321, please subscribe to the |
| 48 |
mpg321-announce mailing list: send an email with 'subscribe' in the body or |
| 49 |
subject to [email protected], or visit |
| 50 |
http://lists.sourceforge.net/lists/listinfo/mpg321-announce . |
| 51 |
|
| 52 |
There are a number of tasks that are still on-going with the develompent |
| 53 |
of mpg321. If you're interested, please read the TODO and HACKING files. |
| 54 |
Also, always feel free to e-mail me, Joe Drew <[email protected]>. |
| 55 |
|
| 56 |
There is also a sourceforge project for mpg321: |
| 57 |
http://sourceforge.net/projects/mpg321 |
| 58 |
|
| 59 |
HISTORY OF MPG321 |
| 60 |
----------------- |
| 61 |
|
| 62 |
`mpg321' started long ago (sometime in 1999) as a wrapper script for |
| 63 |
the mpg123 frontend of the media player FreeAmp. It was contributed |
| 64 |
to the Debian package of FreeAmp, and for several revisions was |
| 65 |
included as 'mpg123.freeamp.' (This script has since been removed.) |
| 66 |
|
| 67 |
mpg123.freeamp didn't work very well, and was limited by FreeAmp's |
| 68 |
implementation of the mpg123 frontend, but it worked for what I needed |
| 69 |
it to do: play music from the command-line without needing mpg123 |
| 70 |
installed. |
| 71 |
|
| 72 |
Early in 2001, I decided that a real alternative to mpg123 was needed, |
| 73 |
and started looking around for a good mp3 decoding library. I came |
| 74 |
across SMPEG, which was written by Loki Software, and based on SDL. |
| 75 |
It was very simple programatically and handled most everything that |
| 76 |
was needed. mpg321 was born, and it did all the simple things that |
| 77 |
were required of it. |
| 78 |
|
| 79 |
SMPEG, however, required SDL for output, which in turn required many |
| 80 |
other libraries. This was a very sub-optimal arrangement. So, in 2001, |
| 81 |
I performed what amounted to almost a full rewrite of mpg321, porting |
| 82 |
it to Rob Leslie's MAD MPEG audio decoder library. I chose MAD because |
| 83 |
it provides very high-quality output, and also because it operates entirely |
| 84 |
with fixed point (integer) instructions. |
| 85 |
|
| 86 |
At the same time, I also switched to the Ogg Vorbis (Xiphophorous) project |
| 87 |
libao for all audio output. |
| 88 |
|
| 89 |
That's pretty much where mpg321 stands right now. There are still |
| 90 |
unimplemented features, and undoubtedly still bugs. But it works well |
| 91 |
for many people, and it liberates one more dependency people had on |
| 92 |
non-Free software. That's worth it, to me. |
| 93 |
|
| 94 |
TROUBLESHOOTING |
| 95 |
--------------- |
| 96 |
|
| 97 |
1) If mpg321 gives: |
| 98 |
"libao - OSS cannot set rate to 44100" or/and |
| 99 |
"Can't find a suitable libao driver. (Is device in use?)" |
| 100 |
a) Try apt-get install libsamplerate0 |
| 101 |
b) Is alsa's OSS emulation loaded? Try: |
| 102 |
"apt-get install alsa-oss" |
| 103 |
"modprobe snd_pcm_oss" |
| 104 |
"modprobe snd_mixer_oss" as root. |
| 105 |
|
| 106 |
2) mpg321 has one resource, allowTitleOps, that enables or disables |
| 107 |
special operations which mpg321 relies on. If any of these resources are |
| 108 |
set(or defaults) to false mpg321 may hang. The resources corresponds to mpg321 |
| 109 |
options as: |
| 110 |
|
| 111 |
allowTitleOps: |
| 112 |
--title |
| 113 |
|
| 114 |
To set this resource value persistenly you can add the following to either your |
| 115 |
local ~/.Xdefaults file, or to system-wide resource file like |
| 116 |
/etc/X11/app-defaults/XTerm: |
| 117 |
|
| 118 |
*VT100.allowTitleOps: true |