	       ========================================
	       DOS MP3 JUKEBOX  The Turntable Emulator 
                    For Beta Testing Purposes                  15-02-2001
	       ========================================       David Aranda



1-Introduction
~ ~~~~~~~~~~~~
   Mp3 Jukebox is a Mp3, Mp2 (MPEG 1.0 and 2.0), Mod, S3m, Xm and CD-AUDIO
   player for Dos, that tries to emulate a turntable.

   Its able to do the classic vinyl stop effect, unlimited pitch, hand slaps,
   playing backward, and digital effects like realtime timestreching, pitch bend,
   pause, panning... and you can play sample .wavs (like voices, effects, jingles,
   etc...) while mp3/mp2 is playing.

   The original idea was make a application to play songs file format like 
   mp3 / xm / mod... that could emulate a turntable, to mix and manipulate
   the songs like a vinyl. 
   All the programs that mix mp3s or mods require that the user have see 
   the monitor and to use the mouse, really I don't like this method, I 
   want a program that can be used only with the keyboard without a monitor, 
   because for a DJ that is making a session only want heard the music,
   manipule your mix table and theirs turntables, the Dj don't need to be 
   seated, seeing a monitor to do a good mix or session. 
   Also you can make with this program a simply mp3 player for your home, your
   pub or your car like compact disc player or cassete module of your HiFi.


2-General keys
~ ~~~~~~~~~~~~

 h         Help for the general keys

 Enter     Search for songs on the drive specified in jukemp3.cfg
	   and play a random one (If you specify 'x' as a drive
	   the program will use the actual drive).
	   If you want that jukemp3 read the songs from your drive d: 
	   when the program starts, you have to edit the file jukemp3.cfg
	   and write simply d in the first position of the file.

 d         Change the drive of the songs.

 #         Change directory of the songs
	   You can specify the drive and the directory.

 a         Play a random song of the list

 q         Quit the player

 m         Show the song file list loaded

 t         Show the name and artist of the songs of the list and save
           them in tagsmp3.txt (DOS format) to be printed.

 c         Play the next CD Audio Track

 x         Play the previous CD Audio Track

 w         Save Winamp songlist.m3u

 b         Search a song

 v         Repeat last seach

          Open/Close CD door

 .         Stop the sound

 BackSpace <- Replay the last song played on the list

 Num       Play the song of the list with the number Num
	   If when you enter the number of the song it is not play
	   automatically you have to press enter (The Scroll Lock led of
	   keyboard indicates that you have to press enter).

 +         Play the next song of the list

 -         Play the previous song of the list


3-Mp3/Mp2 Playing keys
~ ~~~~~~~~~~~~~~~~~~~~


 F1  - Hand slap up to the vinyl, like a Pitch Bend. 
 F2  - Hand slap down to the vinyl.
 F3  - Panning to the left
 F4  - Panning to the right
 F5  - Pitch Up, you can specify the precision of the pitch in the file
       jukemp3.cfg, in the section PITCH PRECISION you can specify the number
       of tenth that the pitch will be modified. 
 F6  - Pitch Down
 F7  - The classic striped vinyl effect
 F8  - Volume to 0 / Volume to the max (mute)
 F9  - Play forward
 F10 - Play backward
 F11 - Another Pitch Bend but without modify the tone (Time Streching) UP
       Useful for ajust the song during a mixing between two songs.
 F12 - Another Pitch Bend but without modify the tone (Time Streching) DOWN

 ALT+F5 - Half increase pitch
 ALT+F6 - Half decrease pitch

        Forward 5 seconds
        Rewind 5 seconds 
        Increase volume
        Decrease volume
  /      Pause / Resume
  o      Decrease constant time streching
  p      Increase time streching
  <-     BackSpace Restart the song
  Spc    Vinyl Stop
  .      Stop the sound
  s      Surround Sound
  f      Go back to the original frequency of the song
  Supr   Mark a song position
  Insr   Goto to mark position
  Home   Mark a song position #2 (This position will be saved on the file
	 framemp3.cfg with the song number)
  End    Goto to mark position #2 (Position will be loaded on the file 
	 framemp3.cfg)
  AvPg   Forward 2 minutes
  RePg   Rewind 1 minute
  Number Play the selected song of the songlist by the number
  +      Play the next song of the list
  -      Play the previous song of the list
  i      Show the information about the current mp3 from ID3 tag.
  TAB    Playback Rewind, try it! it's a classic effect.
  
-In mp3 playing and CD-Audio playing: when a 1 minute remains for end of the
 a song, the Caps Lock led will switch on, and when 15 seconds remains, the
 Scroll Lock led of keyboard will switch on.


4-Mod/Xm/S3m Playing keys
~ ~~~~~~~~~~~~~~~~~~~~~~~

      Next Pattern
      Previous Pattern
      Increase volume
      Decrease volume
  /    Mod Pause
  <-   ReStart the song
  F5   Pitch Up 
  F6   Pitch Down
  F8   Mute
  Supr Mark a song pattern
  Insr Goto to mark pattern
  i    Show the list of samples/instruments
  f    Go back to the original frequency of the song
  o    Decrease constant time streching
  p    Increase time streching


5-CD AUDIO Playing keys
~ ~~~~~~~~~~~~~~~~~~~~~

  c    Play next CD Track
  x    Play previous CD Track
      Fast Forward (1 second)
      Fast Rewind  (1 second)
      Increase volume
      Decrease volume
  /    Pause
  <-   BackSpace Restart the song
 Supr  Mark a song position   (Mixing Utilities)
 Insr  Goto to mark position
 Home  Mark a song position -#2
 End   Goto to mark position -#2
 AvPg  Forward 2 minutes
 RePg  Rewind 1 minute
 F8  - Volume to 0 / Volume to the max (DJ mute)
 TAB   Enable/Disable continuous CD playing of all tracks

6-Jukemp3.cfg  Drive Configuration file
~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 In this file you specify the drive when the songs (mod and mp3) will be
 searched. If you put x like a drive the program will search in the current
 drive when the program has been executed.

 You can also specify the number of the CD-ROM drive, if you have several
 CD-ROMs in your system and you can play CD-AUDIO music from the second CD-ROM
 you must put the number 2 in the section "Number of CD unit" of jukemp3.cfg.

 In the section "Volumen" you can set the initial volumen of Jukemp3, by default
 it's set to the maximun (255).

7-Command line options
~ ~~~~~~~~~~~~~~~~~~~~

 General sintax:

      jukemp3 [options] [songs]

 You can specify songs to play from the command line.
 Ej:  jukemp3 c:\sound\track2.mp3              -> Play c:\sound\track2.mp3
      jukemp3 c:\trackers\*.xm c:\sound\*.mp3

 or if you are in windows, you can drag and drop song files to jukemp3.exe
 program.

 also you can use Winamp playlists:
      jukemp3 playlist.m3u

 -Options:

	-a     If you thing that the sound volumen is lower than the Windows
	       players use this option to amplify, but remember that if
	       you use it you won't be able to play talkover samples while
	       a mp3 is playing (Alt + Number).

	-nomp3 Any .mp3, .mp2 won't be inserted in the song list.

	-nomod No .Xm, .Mod, .S3m will be inserted.

	-fast  Use it if you need a instantly seek without delays in mp3 files
	       without this option when you use fast forward/rewind or go to
	       a marked position, the player spend a few miliseconds that
	       can dislike to the users if they are mixing.
	       This option is not recommended, I'm going to improve the seeking functions,
	       but for now this is the only solution if you need that the
	       player go quickly to a marked point of the song.

        -vumeter Display a graphical vumeter while a mp3 file is playing

8-Samples
~ ~~~~~~~
   You can play sample .wavs (like voices,effects, jingles, etc...) while 
   a song is playing. You have to edit the file samples.ini, put one filename
   of the .wav in each line.
   To trigger a sample, use  the keys ALT + assignated number of sample.


9-External player
~ ~~~~~~~~ ~~~~~~

  If you have an old computer like a pentium 90 Mhz, 486 100Mhz, etc... you
  can make a mp3 player for heard your songs in your home, pub...
  You will need a

  BOOTABLE DISK:
       1-Make in Windows 95,98 a Bootable Disk (Control-Panel,Add/Remove Programs,
         Bootable disk) or you can format a disk and copy the system files to make
         a disk bootable by using the command: Format /s   (Ms-Dos,Windows 95,98)

       2-Copy the files of Jukemp3 (jukemp3.exe, jukemp3.cfg, sound.cfg...) to
         the disk.

       3-If you are using a SB 16/64 perhaps you need to use the ctcm drivers
         you can download it from jukemp3.20m.com/download
         Copy them in the disk

       4-Modify the autoexec.bat file in the disk adding the call to the program
         JUKEMP3.EXE.

  You won't need monitor,hard-disk,mouse... only insert this disk and a Cd-rom
  with mp3.


10-FAQ
~~ ~~~
  Mp3 Jukebox has been tested successfully with the next sound cards: 

	-Sound Blaster 16 (Original and PnP) at 44100 Hz 
	-Sound Blaster 64 Gold (Recomended) at 44100 Hz 
	-Sound Blaster 32 Awe at 44100 Hz
 	-Maxi Sound 64 with the ESS chip (Tested under Windows 98) at 44194 Hz 
	-Sound Blaster 64 PCI with Ensoniq sound chip at 48000 Hz (only under W98) 
	-Sound Blaster 128 PCI (Sb 16 Compatible, under Win98) at 44100 Hz
	-Sound Blaster Live (with DOS SBEMU) (thanks to RayerR for test it)

  Problems with sound cards: 

	-If you have a SB pro, SB 16 (ISA), you won't need any driver under DOS, but if you have
         a SB64, execute the program CTCM.EXE first jukemp3.20m.com/download. 

	-Jukemp3 starts detect correctly the sound card but it dont start to play mp3: 

	You must setting correctly the DMA channel, IRQ and its Port address of your sound card 		by typing over the command line something like this: 

	SET BLASTER=A220 I5 D1 H5 
	
	This example means that the sound card will use the port 220, the IRQ 5 using the channel 	1 for Dma and the channel 5 for High Dma. 

	You can specify this settings in the file sound.cfg: 

	# SB port address 
	sb_port =  220 
	  
	
	# SB DMA channel 
	sb_dma = 1 
	  
	
	# SB IRQ number 
	sb_irq = 5 
	
	#Frequency 
	sb_freq = 44100 

	If you dont know this parameters you can see they in Windows: Control 			Panel->System->Sound devices.


  What happens with Windows XP, NT...
	
	-No problem look this http://www.ece.mcgill.ca/~vromas/vdmsound/ (VDMSound provides sound 	support to DOS boxes under Windows NT 4.0 and Windows 2000) 
	Run Dosdrv before Jukemp3 and it will run ok.



11-Author
~~ ~~~~~~
  David Aranda Alonso (davidj@ozu.es)
  C/12 de Octubre N4 2-A
  47005 Valladolid
  Spain


12-Web Page
~~ ~~~~~~~~
  http://jukemp3.20m.com

13-THANKS!!!
~~ ~~~~~~~~~
 Jukemp3 would not exist without the work of this people:
      Shawn Hargreaves    (Allegro will arrive long away)
      Ove Kaaven 
      Guan Foo Wah        (Modules by courtesy of his library JGMOD)
      Brennan Underwood
      and DJ Deloire      (DJGPP Cool!)

