My ultimate lovely totally innovating Automatic Multimedia Player

Web Sites
http://rafalszyja.republika.pl/
http://www.oginer.tk/
http://multiamp.sourceforge.net/
https://sourceforge.net/projects/multiamp/


Contents of this document


Introduction to MultiAMP


Reasons for writing this program

Well.. I wanted to do something interesting! (I hope MAMP is interesting a lot!)
I also wanted to show that DOS can be multimedia environment!


Features overview

Multiamp key features are fast operating and small overall size.
It uses a lot of libraries to provide wide support for sound formats.
Libraries related info is listed in Credits section.

MultiAMP is multiplatform multimedia player which supports most of popular audio formats.
This program is free and will be free!

And as project grows MultiAMP has got native Linux and window$ port and is now developed as Open Source!


System requirements

DOS version:

TIP: Under "clean" DOS session loading SmartDrive (type smartdrv at DOS promt) speeds up disk operations a lot!


Supported operating systems:DOS 3.30+ , window$ 3.x,95,98,Me
It won't work on NT based systems - at all :( [nt4/2000/xp]

Supported Sound Cards:All Sound Blasters,Pro Audio Spectrum, Gravis UltraSound,Ensoniq Soundscape,Windows Sound System

Additonal:

Non-GUI version:

0.4MB of HDD space

486dx2/66MHz,Pentium 60Mhz or faster suggested (especially for MP3 and OGG playback)

1MB of RAM,preferably 4+


GUI version:

0.6MB of HDD space

will run on 486s but Pentium 60Mhz+ is recommended,however Pentium 120Mhz or faster is suggested when you'll play MP3/OGG

2MB of RAM,preferably 4+ (preferably more)


Window$ version:

0.5MB of HDD space

486dx2/66MHz,Pentium 60Mhz or faster suggested (espacially for MP3 and OGG playback)

8MB of RAM,preferably 12+
(that depends on window$ and IE you're using... it may run even on 4MB with W95 OEM 1)


Usage


Features

MAMP supports a lot of different filetypes, it's small ... fast...
generally nice :)

+ Playlist
+ Same functionality for DOS , Win32 and Linux (If you used any version - rest looks the same!)
+ Different language localizations are avaiable and new ones are very easy to made


Supported formats

List of formats supported by MultiAMP.

NOTE for non GUI DOS version: Run CD Audio player using 'mamp cda' command or CDA.BAT file 

Ext.    Description

WAV     RIFF waves 

MP3/MPG MPEG Layer 3 

MP2/MPG MPEG Layer 2 

MID     Midi sequences 

CDA     CDAudio Tracks 

MOD     Amiga Protracker MODule (later on PC) 

XM      Fasttracker ][ eXtended Module 

S3M     ScreamTracker3 Module 

IT      Impulse Tracker 1.xx/2.xx Module 

OGG     Great compression similar to MP3 but better


FAQ

All versions:

none for now

DOS Version:

Q:Why MAMP produces noisy sound?
A:It's simple - see this table: Type max Hz/mono max Hz/stereo 16 bit support 

Type      Max Hz:Mono  Stereo  16 Bits

SB 1.0/1.5/2.0   22-44k   -    no 
SB Pro I/II      44100  22050  no 
SB 16 and higher 44100  44100  yes


So - You need at least SoundBlaster 16/compatible to hear sound without noise made by card itself.
NOTE: 8 bit sound always produces noise! 22Khz degregades sound very little.
I've Sound Blaster Pro - it's initialized as 22KHz/8bit/stereo by default.


Windows version:

none for now

Linux version:

none for now


Credits


MultiAMP authors and contributors

Authors:

Rafał Szyja - rafalszyja @ poczta . onet . pl
Started the project at 2nd July 2002
Made main API of MultiAMP
Created graphics and DOCS and anything else that others did not :)
Was managing the project alone up to late November 2002.

Web Site: http://rafalszyja.republika.pl



Oscar Giner - O_giner @ hotmail . com
Was invited to cooperate with Rafał in late November 2002.
Did playlist :)
Added monitor refresh rate control
Contributed a lot of useful code , tips and tricks
Made Spanish localization
Made Multiamp account on sourceforge.net

Web Site: http://www.oginer.tk


Contributors:

Christer Sandberg - christer . sandberg @ mdh . idt . se
Made Swedish localization
I suppose that Christer know all about C! ;)
MAMP uses Christer's CGUI...

Web Site: http://www.idt.mdh.se/~csg/cgui/



Ben Davis - entheh @ users . sf . net
He compiled MAMP under Linux , also thanks for nice suggestions!
MAMP also uses Ben's DUMB!

Web Site: http://www.dumb.sf.net/



Eduardo "Dudaskank" Machado - dudaskank @ yahoo . com
Made Portugal (Brazil) localization

Antonios Grizis (Medron/SAMAR Productions) - medron @ gmx . net
Made Greek localization





Thanks... Greets...

Shawn & All the Allegro community - Allegro is base of MultiAMP!
Jeffrey Guan - JGMOD is nice mod library [currently unused]
Delirium Software - AllegroOGG and AllegroMP3 are very good!

here is list of testers:
Ben "Enteth" Davis entheh @ users . sf . net
Marcin "Żeber" Żebrowski zeber00 @ wp . pl
Tomek "Yasioo" Jasiński
Kamil "Suchy" Nęcek
Marcin "CzechU" Czech
Catalyst88 catalyst88 @ btopenworld . com

And here is list of all libraries used:

Allegro
DUMB
AllegroMP3
AllegroOGG
CGUI
LIBCDA
AlText


Additional


Reporting bugs


If you find a BUG or PROBLEM let us know about that as fast as possible!

you can mail Rafal or Oscar but it's better to mail both of us at a time!


Future Plans

Future plans - yeah... Making MultiAMP better! - that's IT!


Source Code


How to compile sources

updated 14 Apr 2003 by Rafal.

Libraries needed to compile: 

Allegro 4.x.x  http://www.allegro.sf.net

DUMB  v0.9.x   http://www.dumb.sf.net

AllegroMP3     http://nekros.freeshell.org/delirium

AllegroOGG     http://nekros.freeshell.org/delirium

CGUI v1.6.x    http://www.idt.mdh.se/personal/csg/cgui/

LIBCDA v0.5    http://www.psynet.net/tjaden/

AlText v0.94   http://www.oginer.tk/

Case: GCC under Linux

Install all needed libraries then
use MAKE to create the program. (see end of this file for targets)
ie : make -f makefile.linux

Case: GCC under DJGPP

Install all needed libraries then
use MAKE to create the program. (see end of this file for targets)

make [then press enter]

Case: GCC under Mingw32
Install all needed libraries then
use MAKE to create the program. (see end of this file for targets)

default makes build statically linked EXE but you can
build dynamic also - remove _s form -lalleg_s and -lcgui_s in
makefile.mgw file.

Case: MSVC Open included workspace and compile it


--------

Makefile targets:
clean - removes all object-files (rm -f *.o)
fuck - deletes executable, then type make to recreate it (faster recompiling)
compress - uses UPX (must be in PATH) to pack EXE.
debug=1 - creates DEBUG version

that's it.