This is documentation for maplay3 (maplay 1.2 with Layer III support).

Note, that you should also have original maplay documentation files
(ANNOUNCEMENT, INSTALL and README), which may not be up to date for
all features.

Maplay3 should work on most supported unix platforms, but I could test it only
on Linux and IRIX. Since original maplay source was so old it may need
minor tweaking before it works.

usage: maplay [option(s)] [filename(s)]
  filename   filename of a MPEG audio stream or - for stdin
  -v         verbose mode
  -q         quiet mode (don't print filenames, when playing multiple files)
  -s         write pcm samples to stdout
  -l         decode only the left channel
  -r         decode only the right channel
  -c         check for filter range violations
  -f ushort  use this scalefactor instead of the default value 32768
  -@ list    get files (and comments) from file 'list'
  -a         randomize list order

You may specify more than one input filename (and use wildcards), use
file(s) containing list of files to play or combination of both. I think
that '-l' and '-r' switches aren't working with Layer III streams yet.


List file format:

Any blank lines or lines with '#' or ';' as first character are ignored.
In any other line, first word is taken as filename and rest of the line
is regarded as comment (and if '-q' switch is not used, printed to screen
when starting to play that file). Filenames may include paths (which are
not printed when playing file). Below is an example of a playlist.

------start------
# Maison Ikkoku Best Selection

mibest01.mp2 Kanashimi yo Konnichiwa "Hello, it's Sadness" OP
mibest02.mp2 Natsu no Sora so no 2 "The Summer Sky, No. 2"
mibest03.mp2 Ashita Hareru Ka "Will Tomorrow be Bright"
mibest04.mp2 Godai ga Kyoko wo Omou Toki "When Godai thinks of Kyoko"
mibest05.mp2 Cinema ED
mibest06.mp2 Aki "Fall"
mibest07.mp2 Yokan "Presentiment"
mibest08.mp2 Kaeri Michi "The Road Home"
mibest09.mp2 Fantasy ED
------cut-----


Credits:

Maplay3 is based on maplay 1.2 sources Copyright (C) 1993, 1994
Tobias Bading (bading@cs.tu-berlin.de).

Layer III routines Copyright (C) 1991 MPEG/audio software simulation group.

Optimizing Layer III routines Copyright (C) 1996, 1997 Jeff Tsay
(ctsay@pasteur.eecs.berkeley.edu).

Playlists and integrating Layer III routines from Maplay 1.2+ 1.80 for
Windows Copyright (C) 1996, 1997 Timo Jantunen (timo.jantunen@hut.fi).


Sources:

Should be in the same package with this file or in same directory
where you got the package this file was in.


Problems?

* If you hear snaps during playback, try adding '-c' parameter. If it suggests
  -f switch with a value, use it. (I usually use parameters -c -f 25000)

* If you have trouble compiling maplay3, try GNU C++ (g++) if possible.

* If you have playback problems with your unix workstation, try dumping
  decompressed audio stream to standard output ('-s' switch) and piping it
  to some other player to see if it works. I can't help with other unix
  platforms (unless you are willing to donate me one ;-), so you have to
  fix the problem yourself. If you do, please send the fix back to me so
  I can add it to next version of maplay3.


Bugs:

For some reason, if linux version is compiled with '-O3' but without
'-ggdb' switch it crashes when playing multiple files (gcc 2.7.2.1).

Report any other bugs to me (timo.jantunen@hut.fi or jeti@cc.hut.fi),
but it has something to do with playback on some unix platform, I
probably can't help.


Legal stuff:

This program is free. You are also free to use or not to use it, but I'm
not responsible of any damage it may cause (and I'm a student so I don't
have money anyway). Do NOT make money with this program (this includes
putting it to a CD-ROM which costs over 30 USD), change copyright
information or distribute it without unmodified files README, README.L3
and COPYING. You should distribute complete sources but if you distribute
precompiled binary with those three files then you need to have complete
sources available somewhere where anyone who got the binary can get it.