Debian Codegraph @

README

raw
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