Short:    Very small GUI for MPEGA
Uploader: carls@kajen.com (Carl Svensson)
Author:   carls@kajen.com (Carl Svensson)
Type:     mus/play
Version:  1.1
Requires: ARexx, rexxreqtools.library, MPEGA


            M P 3 P L A Y   1 . 1
           =======================

           (c) 2001 Carl Svensson

 
What's This?
ŻŻŻŻŻŻŻŻŻŻŻŻ
mp3Play is a small (almost tiny) GUI for MPEGA, the Amiga MP3 Player.
It's written in ARexx and needs RexxReqTools.library to work.


Contents of this Distribution
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
mp3Play    The GUI Script
mp3Config  Configuration Script
ReadMe     This file


Requirements
ŻŻŻŻŻŻŻŻŻŻŻŻ
· ARexx (with RexxMast running)
· MPEGA
· rexxreqtools.library (available from aminet, reqtoolsusr.lha)

No AHI, 24-bit Workbench screen or PowerPC CPU is needed
for it to look and sound good :)
I guess the GUI is blazing fast even on a vanilla 68000 machine,
since it only uses ReqTools. I haven't tested this though.


Installation
ŻŻŻŻŻŻŻŻŻŻŻŻ
1. Copy the mp3Play directory to the wished destination
   (for example, your hard drive)

2. Run mp3Config. This script is quite self-explanatory,
   so I won't bother to explain it here.
   The default MPEGA options (-d 2 -q 1 -p 3 -b 32) gives
   me a clear, crisp sound using only about 25% CPU on my
   A1200 with a 50MHz 060. However, you might wish to
   replace these with the ones of your choice.
   
   mp3Config creates a file called "mp3Play.cfg" in your
   s: directory. It's a very small file containing
   only one line of text.


Usage
ŻŻŻŻŻ
1. Run mp3Play
   - From Workbench: Double-click the icon.
   - From CLI: 1> rx mp3Play  

2. Now the GUI appears. It has three buttons:
   Play, Stop and Quit.
   
   The Play button throws up a file requester
   (NO multiple choice available). When you've
   selected an mp3 file, mp3Play starts playing it.
   If mp3Play is already playing a file when the
   Play button is pressed, mp3Play stops playing
   the old file and throws up a file requester.   
   The Stop button stops playing.
   The Quit button stops playing and closes the GUI.
 

The Author
ŻŻŻŻŻŻŻŻŻŻ
Contact me by mail (carls@kajen.com) or
visit my HomePage (http://carls.1av10.nu/).


To Do
ŻŻŻŻŻ
mp3Play v2.0, currently in development, will feature
a playlist and more GUI buttons ;-)


History
ŻŻŻŻŻŻŻ
* mp3Play version 1.1
  · Pressing "Cancel" in the file requester now
    causes mp3Play to return to the GUI with a
    "No File" indication just like when pressing
    stop. In v1.0 you had to select a file or the
    file requester wouldn't disappear.

* mp3Play version 1.0
  · Initial release.


DISCLAIMER
ŻŻŻŻŻŻŻŻŻŻ
This program is freely distributable as long as all files remain intact.
The files in the distribution should be:
 · mp3Play (Main GUI script)
 · mp3Config (Config script)
 · ReadMe (this file)

I am NOT responsible for any of the problems this script may cause.
I offer NO warranty and I cannot guarantee that it'll work on your
computer.