MPXPLAY Audio Mpeg and uncompressed Wav Player, CD ripper v1.42 by PDSoft

Send suggestions and error reports to 

      padara@hotmail.com

important notes and requests before you send me mail:
 - write MPXPLAY in the subject line!!!
 - before You ask something from me or you would like to send me a bug report, 
   plase read README.TXT (this), MOREINFO.TXT and FAQ.TXT files!
 - sorry, but I can't answer to everybody 
   (I usually don't answer, if your question is answered somewhere in the text files)
 - and please write the name of your country and city too


Check http://www.dailymp3.com  
      http://www.bestdownload.com

or VISIT MY HOMEPAGES
      http://members.tripod.com/padara
      http://www.geocities.com/mpxplay

for latest version.
(sometimes you can find a newer version on my pages)

System requirements:
- CPU: 80486 DX2-50 (DX2-66) for MP2 and DX2-80 (DX4-100) for MP3 playing
- Soundcard:
   - SB16 or compatible (DSP 4.x), AWE-32/64, SB Live (SB16 emu)
   - ESS 688,1688,1868,1869,1878,1879,1887,1888 chips (?)
   - WSS compatible (Crystal Sound, Yamaha OPL3, CMI8330 (?), some ESS cards)
   - SB Pro or compatible (DSP 1.x, 2.x, 3.x)
   - Some GUS cards (Advanced GUS Classic) (?)
   ((?) means: not tested, maybe doesn't work properly)
- Memory:
   - 200kbyte conventional
   - 2Mb XMS (+0.5Mb for MIDAS)(+2*1Mb for -bp)
- Display: VGA (or EGA)
- OS: MS-DOS 5.x,6.x, Windows 95/98 (dos window)
  (if you have memory allocation problems under MS-DOS 7.x
   try the DOS4GW version of Mpxplay (Mpxp_4gw.zip, download from the homepage))

Command line options:

usage: MPXPLAY.EXE [option(s)] audiofile    (play one audio file (.mp3,.wav,.cdw))
   or: MPXPLAY.EXE [option(s)] -@ list.m3u  (load a playlist file)
   or: MPXPLAY.EXE [option(s)] d:\*.*\*.*   (scan (sub)directories for files)
   or: MPXPLAY.EXE [option(s)] -ds cde      (scan c: d: e: drives for files)
   or: MPXPLAY.EXE [option(s)] d:\*.cdw     (play all audio CD tracks)
   or: MPXPLAY.EXE -o -sl 3 in.mp3 out.wav  (decode mp3 to a wav file)
   or: MPXPLAY.EXE -o -sl 3 d:\1.cdw 1.wav  (copy the 1. audio CD track into a wav file (ripp))

for slow computers (below 486DX4-100):
       MPXPLAY.EXE -sl 0 -ddma -bl -bni -f0 -v -@ playlist.m3u

Playlist functions:
 -@  PLAYLIST : use a playlist
 -@d PLAYLIST : doombox (jukebox) mode (load playlist to the left side, push song to queue)
 -@x PLAYLIST : extended playlist (same like -@ -ig), also use this, when you've got a very large playlist
 -@s PLAYLIST : save playlist from editor to PLAYLIST file on exit (default:MPXPLAY.M3U)
 -@sx PLAYLIST: save playlist in extended mode (for -@x)
 -ds DRIVES : multiple drive scan (-ds cde -> scans c: d: e: drives)(-ds cde *.wav -> search wav files only)
 -db disable directory browser in playlist editor
 -dd use doombox mode (load files to the left side)(at -@x, drive scan (-ds) and directory browser)
 -prn  random play
 -prn2 randomize playlist at start
 -pre  replay playlist (after the last song the program go to the first song)
 -pre1 repeat only 1 song (use: -bl -xr -xs -pre1 song.mp3 for background playing)
 -psf NUM : start song at NUM. frame (PlayStartFrame)
 -psp NUM : start song at NUM-16%    (PlayStartPercent)
 -pss NUM : start play at NUM. song  (PlayStartSong)
 -psc NUM : exit after NUM song      (PlaySongCount)
 -pap enable auto pause (before each song)

Display settings (default: spectrum analiser,playlist editor,browser):
 -f0  no screen output
 -ff  only framepos and actual filename are displayed
 -fl  one line display output
 -v   verbose mode (mpeg info,id3tag info; use it with -f0 or -fl options)
 -fe  full screen playlist-editor (without analiser & browser)
 -fs  program doesn't change the display to double lines mode (25->50)
 -ef  display filenames in playlist-editor
 -ebs editor border size (def:67)

Input buffer settings (def. 128(4*32)kbyte prebuffer without interrupt decoding):
 -bn  no input buffer (not recommended)
 -bp  input file pre(ring)buffer (decoder runs in interrupt)
 -bl  input fullbuffer (it loads the (whole) song into memory before playing (max. 13mbyte))
 -bni disable interrupt decoding (for -bl)
 -bbn prebuffer blocks (1 block=32kbytes)(use: 8 - 64 (MP3-WAV))(def.: 4, 32 for -bp)

Sound card and output settings (def. autodetect SB16,ESS,WSS,SBpro,MIDAS)
 -scs num  soundcard select (0:auto, 1:SB16, 2:ESS, 3:WSS, 14:SBpro, 15:MIDAS)
 -sct num  soundcard test (0:all, 1:SB16 ...)
 -scm      configure manually MIDAS and save it to MPXMIDAS.INI file
 -scv num  sound card volume (master & voice)(1-100(%))
 -sctr num sound card treble (1-199(%)) (old SB16 (OPL) & AWE32/64 only)
 -scbs num sound card bass   (1-199(%))
 -ddma     double dma (32k->64k) (output buffer)
 -t        testmode (no sound output, only decoding)
 -o        write pcm data to a wav file

Sound mixing and output modifying:
 -sl  limit    soundlimit (playlimit)(def.:50)
 -sv  volnum   software volume setting (def. 100 (%))
 -sva [volnum] auto volume correction [with initial volume]
 -sr  surnum   surround (def.:100 (%) = no surround)(recommended:130-150)
 -sp  speed    playing speed (freq) control (def.:100 (%))

 -cl  decode channel left only
 -cm  downmix channels (stereo to mono)
 -hq  minor sound (mpeg decoder) correction

 -cf  auto crossfade at the end of files
 -cfp [num] crossfade point (def. 120)(start crossfade at num. frame, relative to begining of fade-out)
 -cfo [num] fade-out length (def. 250)
 -cfi [num] fade-in length  (def. 200)
 -cfl [num] crossfade limit (def. 0) (start crossfade, when volume less than num (don't use crossfade point))
 -cft [num] crossfadetype   (def. 1) (0.bit:fade out, 1.bit:fade-in)(-cft 3 : fade out+in)
 (crossfade only: -cfo 150 -cfp 0 -cfi 150 , fade-out & fade-in only: -cfo 150 -cfp 150 -cfi 100 )

ID3-info, file-info and ID3-list settings:
 -ipl load file infos under play (start playing 1. song, after load infos)
 -ini don't preload file informations in playlist (header,id3tag)(load at playing)
 -in  don't load id3tag info from mpeg files (but -il works)
 -il  [infofile] load LOCAL id3info listfile (for current directory entries, reload after every dir change)
 -ig  [infofile] load GLOBAL id3info listfile (for playlist entries)(create:mpxplay -@ playlist.m3u -is d:listfile.txt -ist 448)
 -is  [infofile] save id3 infos to a listfile
 -iw  [infofile] write id3tag into mpeg files (load it from the infofile)
 (if you don't give an infofile,the program tries to use default infofile:!FILES)

 -ist NUM type for id3 savelist (the bits of the NUM changes the type)(def.:63)
   0. bit (  +1): list directory names
   1. bit (  +2): list filenames
   2. bit (  +4): artist-title list mode (non-fixed/fixed position)
   3. bit (  +8): list time of file
   4. bit ( +16): list bitrate (kbit/s)
   5. bit ( +32): list filesize in megabytes
   6. bit ( +64): list filenames with full path
   7. bit (+128): append file (header&size) information in hex format
   8. bit (+256): '' (176) separator behind filenames (instead of space)(recommended for long filenames)

 -8  convert 852 code page (windows characters) to 437 (dos characters)
 -8 1 : for hungarian language (default, equal to -8)
 -8 2 : for greek language
 (if you write the id3tags or an infofile under w95 and plays those mp3 under dos)

Other setting(s):
 -x PRGNAME : set program name for DOS shell (i.e. -x nc.exe)
 -xs : load song (playlist), jump to DOS shell automatically
 -xr : TSR mode (for CDW files only)

Keyboard controls (set the keyboard speed to 30 char/sec in BIOS):

 ESC        - exit
 CTRL-C     - exit
 gray-'-' - step back one song in playlist
 gray-'+' - step forward one song in playlist
 white-'-'- step back like a CD player (if framenum>38, step to begin of song, else step to previous song)
 gray-'/' - step back one subdirectory (album) in playlist
 gray-'*' - step forward one subdirectory (album) in playlist
      ->  - forward (right arrow) (50 frames)
      <-  - rewind  (left arrow)
 CTRL- -> - fast forward (200 frames)
 CTRL- <- - fast rewind 
 BACKSPACE- skip to begining of the song
  C       - auto crossfade enable/disable
 CTRL-'D' - open dos-shell (at -bl or -bp only)
  E       - editor filenames enable/disable
  F       - (cross) fade out/in enable/disable
  H       - sound correction (hq)
  M       - mute sound
  N       - random play
  P       - pause playing
  R       - replay enable/disable
 CTRL-'R' - order the playlist of actual editorside by path\filename
  T       - time mode:elapsed,remaining,allelapsed,allremaining
  V       - volume correction mode (auto/manual)
  X       - swap channels (reverse stereo)
  .       - volume up   ('white home' too)
  ,       - volume down ('white end' too)
 CTRL-V   - reset volume, surround, treble, bass and speed to 100%
  '       - surround up   (superb stereo)
  ;       - surround down (to mono)
  >       - bass up    (hardware tone on SB16, AWE32/64 (?))
  <       - bass down
  "       - treble up
  :       - treble down
  ]       - playing speed up
  [       - playing speed down
 NUMBER   - type a playlist number on keypad (numlock on)(1-7000)(step to n. song)

   ALT-F9 - 25/50 lines mode change
  CTRL-F9 - full screen editor mode (analiser and browser disabled)
 SHIFT-f9 - equal to ALT-F9 + CTRL-F9
 F2 (or d)- load directory browser if it wasn't loaded (-db at command line)

 Unofficial keys:
  I       - enable/disable interpolating
 CTRL-'P' - enable/disable autopause

 Editor keys: 
  up & down arrow,pgup,pgdown,home=ctrl-pgup,end=ctrl-pgdown
  ENTER or SPACE      : start the selected song OR load playlist OR change dir
  CTRL-ENTER          : select next song
  TAB                 : change editorside
  CTRL-'\'            : jump to root dir (in directory browser)
  CTRL-UP or DOWN     : shift highlighted song up or down in playlist
  F5 or Ins           : add highlighted file or playlist to other side
  F8 or Del           : delete file from playlist (except directories)
  CTRL-F5 or CTRL-Ins : copy all playlist entries to the other side
  ALT-LEFT or RIGHT   : change size of editorsides
  ALT-'A'-'Z'         : search artist (or filename) in playlist

 Mouse buttons:   
  left button: 
   in fullscreen mode:
     - one click on position line () to move in song (to set a new position)
     - one click on browser to skip (to select and start) to a new song
     - one click in the playlist to move the editor highline (and change editorside)
     - double click in the playlist to start a new (selected) song
   in non-fullscreen mode (-f0,-ff,-fl):
     - short press (click) to pause playing
     - long press (hold on) to mute sound

  center button: step back in playlist   / fast rewind    (click/long press)
  right button:  step forward in playlist/ fast forward
