
***********************************************************************
readme for M A P  
***********************************************************************

changes:
  look at whatsnew.txt
	
	
***********************************************************************
The Demoversion of MAP allows only a maximum of 15 MP3 files to play.
All other features are fully implemented!
The fullversion consists of:

software: all needed files send via email - costs 12 US$
hardware: IR-HW readymade and tested              18 US$
Total                                      --------------
                                                  30 US$
Shipment (non europe, for hardware)                5 US$

All in all 35 US$ or 65DM

If you find MAP useful send your requests to:
		Jui_Plus@web.de
***********************************************************************

Note: mpxplay V.1.42 was tested with MAP. It works properly. But you have to do
      some modifications to the mpxplay.ini - file. Please modify the following
      settings:
      
      KeyExit3     =0x5300    ;exit mpxplay with "." on Numpad
      KeyExit4     =0x4800    ;exit mpxplay with Cusor_up-key
      UseVariables =3         ;3:save variables at exit to catch the volume setting
      TimeMode     =1         ;0:elapsed, 1:remaining, 2:allelapsed, 3:allremaining
      LCDtype      =0         ;0:for no LCD support in mpxplay- MAP controls it!
      StartupEnabled  =0
      
      TimeMode is up to you...


Files:

map.ini      init file for map.exe
map.exe      executable playerfile
rclearn.exe  program to learn your RC-code for using MAP. Generates rcmap.dat
rcmap.exe    TSR-program for mapping RC-codes to the keyboardbuffer
             and LCD-scrolling
rcmap.dat    DEMO file with RC code mappings (USE rclearn to PRODUCE IT) 
lcd.exe      executable file for displaying character LCD like echo
start.bat    batch to loop the program map.exe 
readme.txt   this file
glist.exe    can be used to scan the specified drive for mp3-files
             it uses the same structure as MAP needs for playlist 
autoexec.bat sample autoexec
config.sys   sample config

use option /h for help!

NOTE: If you don't have a LCD and the IR-Hardware you don't need
      to start the TSR program rcmap.exe! Simply edit the ini file 
      to your belongings and start map.exe.


INSTALLATION:

Put all the files on a bootable DOS floppy. Install your CDROM driver
and Soundcard driver to the floppy.
If you have the IR hardware, the PC have to learn your special keys:
Connect the hardware to COM port1 (or 2),
start the program  rclearn 1 <CR>
1 - is for COMport

If rclearn.exe recognizes the IR hardware you are now able to learn
the needed keys.
After the learning process is finished, all keys are stored in 
rcmap.dat and will be loaded after any reboot.
If you don't have the IR hardware you are not able to use a remote control,
but you can use your keyboard instead.

Next you have to edit the map.ini file to your belongings. 
example:
-----------------------------------------------
#Ini-file for M A P (c) 1999 UM

[lcd]
Columns = 16
Rows = 2
ScrollDelay = 2
WaitEnd = 40

[environment]
mp3drive = d:
player = mpxplay
playlistfile = mp3.lst
# disable for slow machines (FALSE)
DisplayTime = TRUE
# MAP starts playing 1. found song immedeatly, if TRUE
StartImmedeately = FALSE

-----------------------------------------------

Specify the size of your LCD. Supported sizes are: 40x2, 20x2 and
16x2! I recommend 40x2 - it looks the best. When using 16x2 or 20x2,
scrolling will be enabled if the characters do not fit in the screen.

Specify the mp3drive, where mp3 file could be found. 
The program map.exe scans all subtrees and looks for files with the
extension *.mp3. 
Specify the DOS-player, default mpxplay - you have to download
the player by yourself at:
		http://members.tripod.com/~padara/ 
I recommend version 1.40b!

If MAP does not find a playlistfile on the CD-R, it creates a
temporary file. 
If you want to use your own playlistfile, it has to look like:

number [directory number] path\filename description
at the end $
example:
-----------------------------------------------
001 [1] nirvana\NI9166~1.MP3 Nirvana/About A Girl
002 [1] nirvana\NIRVAN~2.MP3 Nirvana/All Apologies
003 [1] nirvana\NIRVAN~3.MP3 Nirvana/Come As You Are
004 [1] nirvana\NIRVAN~4.MP3 Nirvana/Dumb
005 [2] Police\DeDoDoDo.mp3 Police/DeDoDoDo
...
164 [10] Stones\Voodo\track01.mp3 Stones/Voodo_01
165 [10] Stones\Voodo\track02.mp3 Stones/Voodo_02
166 [10] Stones\Voodo\track03.mp3 Stones/Voodo_03
...
$
-----------------------------------------------

The [directory number] counts the directory structure, to allow the
program to jump to different artists. This item is optional. If you
do not use it, you are only able to jump sequentialy.

"path\filename" points to the song from top e.g. d:. The path and
filename has to meet the 8.3 naming convention from MSDOS!! Sorry about
that crap..

"description" is normally the artistname/songtitle. This item will
be displayed on the LCD.

Place "$" at the end of the playfile!

Once more, if your MP3-songs uses the ID-tag, you don't need a playfile!
If no ID-tag and no playfile is specified, the program displays only
the path/filename of the song.


AUDIOCD-DATABASE

New feature since version 2.08. To use this feature just place a file 
e.g. cdplayer.ini to the directory where MAP is executed. The cdplayer.ini
is exactly the same as you know from W95(98)(NT). You can build this file by 
yourself or by using the CDDB (look at www.cddb.com for more informations).
The format is:

[5D52DD]
artist=Burdon, Eric
title=Eric Burdon declares -WAR-
numtracks=5
0=The Vision Of Rassan
1=Tobacco Road
2=Spill The Wine
3=Blues For Memphis Slim
4=You're No Stranger
order=0 1 2 3 4 
[157C936]
EntryType=1
artist=Nirvana
title=Unplugged in New York
numtracks=14
0=About A Girl
1=Come As You Are
2=Jesus Doesn't Want Me For A Sunbeam
3=The Man Who Sold The World
4=Pennyroyal Tea
5=Dumb
6=Polly
7=On A Plain
8=Something In The Way
9=Plateau
10=Oh Me
11=Lake Of Fire
12=All Apologies
13=Where Did You Sleep Last Night
order=0 1 2 3 4 5 6 7 8 9 10 11 12 13 
numplay=14

This example shows 2 audiocds. The number in brackets are build automatically.
You can generate this number by typing "vol d:" (d: == CDdrive) in a DOSbox.
MAP reads the keyword "artist" and the trackdescription (0..)
This file has no limitation (64kb) like the cdplayer.ini in W95. So
you can put your whole archive in it.


USING THE PLAYER

Run the batch start.bat. This will run the player in a loop.
Or type map (default is for seeking through the found structure).
If you don't have the remote control hardware, you can use your
keyboard to control the player. But the program is especially written to
use an infrared remote controller! So don't hesitate to order this
little hardware. It's cheap and very useful. BTW You can use nearly any
available RC with the IR-hardware and you can control any DOS application
with it, windows either
All infos are displayed on LCD (if adapted to printerport 1) and on monitor!
(Except Play-character, Pause-character and time in AudioMode
is not displayed at monitor!) 

BTW you can key in directly the songnumber you want to play acknowleged with
enter or (play at IR).


I am sure there are many questions. Let me know...

email: Jui_Plus@web.de

homepage: http://jui.homepage.com/index.html
