Aramp

This is a port of the command line MP3 player WarpAMP to AROS.
I've removed the Warp specific code and the prelude support.
Source code is released in a separate package.


Original README
---------------

Introduction
------------
WarpAMP is an MPEG audio player based on Tomislav Uzelac's
amp decoding engine. It is based on Tomislav Uzelac's AMP.
It supports AHI, but it also has a special mode where it
directly accesses a Prelude Soundboard using the prelude.library,
if present. As Default it uses AHI (AHI V4 required).

The prelude.library Audio-Code is based on Thomas Wenzel's
PreludeAMP for ppc.library (i got his permission to use
this Replay source on a email-request by myselves to him, he uploaded
the Source recently on Aminet). The AHI Code was done by
Thorsten Hansen of KATO, thanks for his help with AHI :)

Version 0.8 fixes some small bugs.
Version 0.9 changes some small things to make it work okay with OpusMPEGA

Features
--------
 - FREEWARE!
 - Compiled with StormC PPC
 - Does not need ixemul.library!
 - Does not need the AHI audio system, but supports it
 - Does not stop the music, when Intuition is locked, if
   -quiet mode is used

Requirements
------------

 - AHI or prelude.library v2 (V2.41 recommended)
 - A PowerUP compatible system with WarpOS installed
   (should also work with V7, though not tested... might
   give slowdown in V7...)

Usage
-----

 WarpAMP infile

 If you call it without parameter, a Filerequester will be invoked.
 MultiSelect is possible.

 It is also possible to use a program file by

 WarpAMP -program

 or

 WarpAMP -program prgfile

 The first version uses a Filerequester, the second not.

 The programfile format looks like:

 work:mpg/mympg1.mp3
 work:mpg/mympg2.mp3
 repeat

 This file plays the two MPEG files (one line, one file) and then repeats.
 Until CTRL-C is pressed. If you do not specify repeat at the end, it does
 not repeat. Program files have filenames with .prg at the end.

 By default WarpAMP

 - uses a PPC BAT register.
 - disables the Caches for the Sound-Memory-Buffer

 If you do not like this, use the option

 -nobat

 -prelude uses the prelude.library Replaycode, if you do not specify this,
 AHI is used.

 -quiet makes WarpAMP not to print out any output. This has the effect,
 that WarpAMP will not stop when you do Intuition-Operations. I know,
 handling it in a new task would be the cleaner implementation, but
 this was more easy to do. :)

History
-------
v0.5 - First version, based on PreludeAMP with some modifications
v0.6 - Added AHI Support
v0.7 - Added -quiet mode

Legal stuff
-----------

WarpAMP
-------

I don't claim a specific copyright on it. It is just freeware. You are
obliged to confirm to the copyright notices of PreludeAMP and AMP, though.
I am in no way responsible, if this program should damage your computer (but
it should not, just a standard disclaimer) or anything else.

PreludeAMP of Thomas Wenzel Copyright Notice
--------------------------------------------

PreludeAMP is copyrighted freeware. It may be distributed freely as long as
no modifications are made to the executable and this document. A nominal
fee may be asked to cover distribution costs.

PreludeAMP may not be used for any commercial purposes or included with any
commercial product without the written permission of the author. It may
NOT be stored on ftp servers or websites that also hold commercial software
products or drivers for commercial hardware. The only exception are servers
of the Aminet archive.

No responsibilities are taken for damaged speakers, amplifiers, Amigas
or any other components or data involved while using PreludeAMP.

Although I've done some beta testing I can't guarantee that PreludeAMP will
not crash! If you find any bugs, let me know.

-----

Note, that i (Steffen Haeuser) have the email-permission to use his sources
and modify them in a way to create an MPEG Player of my own, as long as i
conform to the AMP license.

Here's the original amp.readme:
-------------------------------
amp MPEG audio decoder readme file (version 0.7.5)
(C) Tomislav Uzelac  1996,1997

amp is free software and can be _used_ freely by anyone. If you want to
do anything else with it, be sure to check the Legal section of this
document for legal issues.

THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
of this document.

1. Introduction
2. Installation
3. Running
4. Feedback
5. Contributing
6. Legal


1. Introduction

amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
putting together as a side project of the MPEG hardware design project at 
FER/Zagreb - just to confirm my knowledge of the standard. It works with
both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
defined in MPEG2), layers 2 and 3. 

There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
available at the amp home site ftp://ftp.rasip.fer.hr

Another gui supported is the Sajber Jukebox, written by Joel Lindholm.

The following people contributed their time and knowledge to amp:
Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
Edouard Lafargue, Andrew Richards, George Colouris,
Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel

amp home location is
        ftp://ftp.rasip.fer.hr/pub/mpeg/

and the mailing list: send 'HELP' in the body of the message to:
        multimedia at rasip.fer.hr

If you want to find out more about MPEG, best places to start are
        http://www.mpeg.org
        http://www.mpeg2.de 


2. Installation

Installation should be simple enough if amp was ported to your system,
just do a 

./configure
make 

You can edit the makefile further to suit your system. If configure fails 
to make a usable Makefile, you'll _have_ to edit it yourself.

Linux users should try real-time playing support, as described
in doc/realtime.txt. Some people that might pass on this feature are
those with slower machines (i.e. 486's), or SMP systems (see the
doc/linuxrealtime.txt file). 
Some versions of the linux C library produce an error when compiling
amp with realtime support. A quick fix is to edit /usr/include/sched.h
and replace _P in the offending line with __P.

./configure --enable-realtime
make
chown root.root amp
chmod u+s amp

... this requires /dev/dsp to be both world readable and writeable. If you
have a special group for people allowed to use the sound device (for
instance, a group called sound), you can do a:

chmod g+s amp

or make your audio card world read/writeable (not recomended)

chmod o+rw /dev/dsp*

3. Running:

'amp -h' gives you usage & options. If your computer is on the slower
side, direct playback might not work, but you can decode it
to .wav or raw pcm and play it later.


4. Feedback

Send in your makefiles, opinions, bugreports, fixes; anything related to this
program. You can also send me unlimited amounts of money, sugar, milk, etc.

If you find any mpeg audio files that amp has trouble decoding, please tell
me about this via e-mail <tuzelac at rasip.fer.hr>.


5. Contributing

Please contribute to amp. If you want to know what is going on in amp 
development, you can join the developers mailing list

        mpeg_audio_developers at rasip.fer.hr

There are certain debugging facilities that I made in amp, but are disabled
in the current release (they are neither nice nor user-friendly). If anyone
enhances them (they are in dump.c) to the point that they're actually
usable I'll be happy to include the changes in the release. I think this
kind of debug output would be very useful to people studying these audio
algorithms.


6. Legal

This software can be used freely for any purpose. It can be distributed
freely, as long as it is not sold commercially without permission from
Tomislav Uzelac <tuzelac at rasip.fer.hr>. However, including this software
on CD_ROMs containing other free software is explicitly permitted even 
when a modest distribution fee is charged for the CD, as long as this
software is not a primary selling argument for the CD.

Building derived versions of this software is permitted, as long as they
are not sold commercially without permission from Tomislav Uzelac 
<tuzelac at rasip.fer.hr>. Any derived versions must be clearly marked as
such, and must be called by a name other than amp. Any derived versions
must retain this copyright notice.

/* This license is itself copied from Tatu Ylonen's ssh package. It does 
 * not mention being copyrighted itself :)
 */

THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
at your risk, and neither Tomislav Uzelac, nor FER will be liable for
any damages that might occur to your computer, software, etc. in
consequence of you using this freeware program.


Tomislav Uzelac
<tuzelac at rasip.fer.hr>