Short:    -amorel- No fuss multiformat audio player.
Author:   amorel@xs4all.nl
Uploader: amorel@xs4all.nl
Version:  1.4.2b
Type:     mus/play
Url:      http://www.xs4all.nl/~amorel

UPDATE:

version 1.4.2b
        * Time out feature. Because figuring the end of a non ST module requires
          a great deal of hacking I have added for all those non ST formats a
          timeout option. You can set the time in the menu after wich the song quits and
          the next one will be load. You can ofcourse switch it off. And this
          obviously only works when a playlist is present. The timing happens
          through the vertical scanrate, so the accuracy depends on the screenmode.
        * It`ll now load in the system font as used on the workbench, though
          it`ll force it to 8 high for now. Tell me if that`s unacceptable ;-)
        * Added more error checking(I try the most to have it as foolproof as possible).
        * Minor bugs fixed(ofcourse ;)
Version 1.4b:
        * Another bug fixed, tried to redraw window equaliser when in playlist
          mode, iconified and attempting to start a new module. I`m ashamed ;-)
        * Bad bug cured. Choosing clearlist in a requester could`ve caused
          problems. This happened when playing a playlist and then an
          unrecognised file was loaded.
        * Changed module playroutine, for improved stabillity and such
        * Added a sort of graphic equaliser(Might redraw incorrectly with
          visualprefs hack, see known bugs)
        * Improved error checking and handling

        * See update history at the bottom of this text


This is version 1.4 beta. Lots of major and minor changes in this one. Though
still beta I believe it`s better and more stable than version 1.3. The
playroutine for modules has been totally changed and improved, there is improved
error checking thus making the whole program more fool proof. If you find any
bugs in this version, please email them.

This beta version is likely to be updated at a much more regular basis, so if
you encounter any problems it might already have been cured in a more recent
update.

This audio/song player supports:

        * Octamed Soundstudio (OSS)
        * Any other octamed and med format
        * Mods 
        * Digibooster(through AHI)
        * Iff 8 bit samples direct from disk
        * More to come....

INSTALL: 
         Copy libraries to libs:
         Copy main program anywhere you like!

To start:

This program is shareware but fully functional. Please pay $5,- or 10,-
Dutch guilders. Contact me for payment information. 

If you pay, you will get better support and you will get updates sooner. 
Also I`m more likely to implement your wishes :-) And of course paying this 
reasonable fee will encourage me to improve this more and more.

Check my site for anything about this and my modules, ramblings and links!

The story:

This is my first attempt to make a proper program for the Amiga. As some
may know I love (electronic)music and compose it myself. Of course I have
been using(and still use) several of the best Amiga song(module) players
around. But I found them to be overfeatured, with tons of menu options and
window gadgets and supporting tons of formats noone will be likely to have
ever heard about ;-) In other words, in an attempt to cover everything
audio and what not they became sort of overkill.... to me at least.

Hence my motivation to make a song/audio/module, whatever the name should
be, player. 

Besides the Amiga I`ve been developing on several other platforms, the
C=64, for job(s): the IBM AS/400 and some other platform widely used,
which I prefer to forget.

Tools used:

Amiga 1200 with a 200 mHz ppc/25 mHz 040 powerup card and 32 mb of memory.
Blitz Basic, a great programming language for which some of the best games
ever have been made and are being made. Also very good for application 
development. Coffee, tea, gym, team fortress quaking(try 137.226.116.82 for 
that :) to keep my sanity ;-)

The program:

Ok, as you know by now this program plays modules of different formats.
The formats currently supported are:

        * Med, Octamed, Soundstudio(thus 4 channel, 8 channel and the newest octamed 
          soundstudio up to 64 channel formats)

        * Pt module(the standard mod format)

        * Digibooster through AHI(a new composing program becoming pretty 
          popular)

        * IFF 8 bit samples, direct from disk(so no memory limitations)  

The most widely used formats are covered as far as I`m concerned(after all
I started to make this for myself to begin with ;). There will appear some
more support for other formats(see `future`) and if you think I missed out 
something really obvious, tell me.

Usage:
        I`m not gonna tell, ought to be obvious :-)

        Well, in case you`re stuck, check the help menu.

Needed:
        several octamed related libraries(included)
        dbplayer.library (included)
        libraries for powerpacker and xpk(included)
        AHI for digibooster(not included)

Features:

        * Multi format(of course :)
        * PLAYLIST!
        * Support for xpk`ed and powerpacked files, decrunching in
          fastmemory if available.
        * `App` support, thus drag and drop on window, appicon or
          appmenu(shift select) 
        * Plays (octa)med, soundstudio and digibooster songs from
          fastmemory if available.
        * Fast and easy gadtools GUI
        * Soundperiod displayed with ST modules(working on it for other
          formats)
        * Usage of standard libraries for replay and decrunch, except ST
          modules and IFF 8 bit samples. (hm is that a feature or laziness? ;)
        * Able to load in ANY file and attempt to play it, asking you
          beforehand of course(see and listen for yourself ;) Might be
          usefull for the few people who love weird sounds, some files give 
          perfect sounds for a psychedelic electro song :-D 
        * Reasonably small and fast, doesnt use up much resources. Needs
          very little memory to run
        * Works on all cpu types(as far as i know) and maybe even on Amiga
          os <2.0, not tested though.
 
        * .... ask me for features you want/need! Ofcourse if you register I
          will be more likely to add your requests.

Tested on:
        
        * Amiga 1200 with 200 mHz ppc, 25 mHz 040 and 32 mb fast
        * Amiga 1200 with 060
        * Bare Amiga 1200 2 mb chip, 14 mHz 020

Known bugs:

The (re)drawing of the graphic equalizer doesn`t seem to work properly with
visualprefs(or with larger fonts, thus larger dragbar). The gtbevelboxes will
(re)draw correctly, but might cause problems at more `exotic` settings in
visualprefs. These problems will most likely be corrected soon. Though
personally I hate visualprefs and as it doesn`t work ok with OS3.5 it should be
avoided ;-)

This program should support sid songs, but I haven`t got that working yet. 
It`ll load sids in and all(If you`ve got the playsid library), it just doesn`t 
want to make any sound. 
TELL ME IF IT WORKS FOR YOU!

The text "Cl" in the first gadget right of the filter toggle gadget is a "." in
rare cases. I have no idea why, maybe something with the used font. Might be
cured now, as the program will load your default font.

For the rest I do not know of any bugs present, that doesn`t mean however
that there are not any bugs, most likely there are(as in any program). if
you find some, contact me.

Future:
        
        * Datatype support for replaying samples
        * SID songs working properly! ;-)
        * 16 bit sample support
        * fast forward and rewind on other than PT modules
        * showing of period on other than PT modules
        * more formats(tell me)      
        * mp3 support(maybe!)

Update history:

Version 1.3b:
        * Random play option added, to play a playlist randomly
        * Various minor bug fixes
        * You can now load and save playlists
Verions < 1.3b:
        * Bugfix concerning ejecting a digibooster song and then loading  
          one again.
        * Close gadget added to window.
        * Visualprefs problem out of place gadget characters solved
          Thanks to Stefano Clemente, Tomislav Kitynski and Thomas Hurst 
          for telling me :-) 
        * Little bugfix concerning stopping a mod and then loading new
          one.
        * Added eject button.
        * Bugfix: When playing a sample without a playlist it hangs, grmbl
          thanks to Curt Esser for telling me.
        * Playlist! Enough said :-)
        * Added font sensitivity concerning the window title, so the window
          gadgets will draw correctly if the windowtitle has a different
          size font than 8.
        
        etc.

Credits:

        Wendy, my wife who I love a lot!
        Fabio Bizzetti as beta tester
        August('gustli) as beta tester
        Many people on the Blitz mailinglist for beta testing

        Teijo Kinunnen for the great Octamed(Soundstudio)

        Frederic Laboureur for New Commandset in Blitz
        James L Boyd for Pupit(powerpacker (un)pack)
        Xbones, Binary Assault
        Rick Hodger
        Red When Excited
        Acid
        
        Jay Miner, whose intellect made all this possible :-)

Greetings:

        All on #amigaquake/#amycoders and #theend! 
        Delphine `Elecwnch`
        Thomas `A340`
        August `Gustli`
        Damnation(long time no see)
        Nicholas `Yagger`(idem)
        Rune `Shitlips`(idem)
        The people on the Blitz list
        
        I forgot many....       

Check servers 137.226.116.82 (or .84) or game.uplink.de for some nice Quake Team
Fortress matches.


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
     383     258 32.6% 11-Jul-98 02:10:22  Amoralplayer.info
   16960    9270 45.3% 10-Sep-98 18:08:48  dbplayer.library
   19928   10274 48.4% 31-Jan-99 01:48:48  medplayer.library
   28224   10325 63.4% 18-Jan-99 04:24:22  octamixplayer.library
   13540    7167 47.0% 25-Jan-99 02:04:34  octaplayer.library
    6128    4144 32.3% 18-Jan-99 04:24:14  powerpacker.library
   11448    7090 38.0% 18-Jan-99 04:24:18  xpkmaster.library
  149944   62059 58.6% 15-Dec-99 04:28:34  Amoralplayer
    9735    4312 55.7% 14-Dec-99 22:46:38  Amoralplay1.4b.readme
-------- ------- ----- --------- --------
  256290  114899 55.1% 18-Dec-99 23:15:24   9 files
