     **********************************************************************   
     *                MP3 Library Shell v1.03 "Freeware"                  *   
     *           Copyright (C) 1998-2000 by Alexander Eltsyn              *   
     *                      E-Mail : ae@ae.inc.ru                         *   
     *                     WWW : http://ae.inc.ru                         *   
     *                       ICQ ID : 14645087                            *   
     **********************************************************************   

Contents:
   COPYRIGHT NOTES
   FEATURES
   HOW TO INSTALL AND USE MP3Shell
   CONFIGURATION FILE DESCRIPTION


                               COPYRIGHT NOTES

    MP3Shell is a freeware. You may use or distribute it for any 
purposes providing these copyright notices and distribution package 
to be unchanged. 
   This restriction is not applied in a case of using MP3Shell as a
part of your redistributable audio collections (freeware or commercial).
The only restriction in this case is to leave inact copyright notices
in config file. 

    This software is written using MPEG player engine, which is subject of 
the following copyright states:
              
    Copyright (c)1998 Eugene Mayevski (Eugene-Mayevski@usa.net).
    MPEG decoder engine is based on maplay - mpeg player  for unix.Tobias 
Bading (bading@cs.tu-berlin.de) wrote the original maplay source for UNIX.
    The ISO MPEG Audio Subgroup Software Simulation Group wrote the public 
C code for a MPEG Audio decoder, and the layer III code of maplay for 
Win32 was adapted from here.
    Jeff Tsay (ctsay@pasteur.eecs.berkeley.edu) ported the original maplay 
to Win32, wrote the interface code and adapted and optimized the layer III 
code from the public C code.
    

                               FEATURES
      
   MP3 Audio Library Shell is intended for trouble-free organizing of 
large MP3 collections. It is also perfect for MP3 CDROM production. 

   The key features of this shell are:
  - it requires no special MP3 files database maintenance. All of the 
tracks description are gathered from the .mp3 tags, and files like
'files.bbs' and 'dirinfo.';
  - each of the directioy or .mp3 file may have they own text description
(plain text or Reach Text Format are supported) and image;
  - it supports WinAmp playlist format;
  - partially customizable multi-language interface;
  - in "edit allowed" mode: TAG and files.bbs edit functions (this 
mode is disabled if started from CD-ROM);



                   HOW TO INSTALL AND USE MP3Shell

   The program itself requires no installation. Simply unpack 
"MP3Shell.exe", "MP3Shell.ini" and "MPEG.DLL" to your MP3 audio 
collection directory tree root and run it.

   After MP3Shell starts, it reads configuration from MP3Shell.ini file
in the same directory as MP3Shell.exe. You may rename both files (e.g. 
autorun.exe and autorun.ini). The format of .ini file is described in 
the following section. Then MP3Shell scans directories starting with
MP3RootDir (see below) and builds audio collection tree.
   Each of the MP3 collection directories may contain optional plain text 
or Reach Text Format description and optional image file. All of the 
directory description filenames are defined in configuration file.
   Each of the .MP3 and .M3U files also may have description and image. 
These files are searched by names:

  XXXXXXX.mp3 (XXXXXXX.m3u)  - MP3 or playlist file
  XXXXXXX.rtf - Reach Text Format description filename
  XXXXXXX.txt - Plain Text Format description filename (not used 
                if XXXXXXX.rtf was found)
  XXXXXXX.bmp - Optional image file

   To use MP3Shell as automatically loadable MP3 CDROM audio 
collection shell, you shoud create file autorun.inf in the CDROM 
root dir. If MP3Shell is also placed in the root directory,  
autorun.inf may look like this:

--------------------- file autorun.inf begin ----------------------
[Autorun]
Open=mp3shell.exe
icon=mp3shell.exe,0
---------------------- file autorun.inf end -----------------------

where icon parameter is used by Windows to display CDROM drive icon.
First value is the file name to load icon from (.ICO files may be 
also used) and second value is the icon number (if file contains
some of them).


                      CONFIGURATION FILE DESCRIPTION

   This section contains an example of MP3Shell.ini file. All of the 
marked by ";" lines are comments and not to appear in real MP3Shell.ini.

;--------------------- file MP3Shell.ini begin ----------------------
; The configuration file should begin with the following copiright notice
;
     **********************************************************************   
     *                MP3 Library Shell v1.03 "Freeware"                  *   
     *           Copyright (C) 1998-2000 by Alexander Eltsyn              *   
     *                      E-Mail : ae@ae.inc.ru                         *   
     *                     WWW : http://ae.inc.ru                         *   
     *                       ICQ ID : 14645087                            *   
     **********************************************************************   

; The value of WindowTitle parameter is used for MainMP3Shell window 
; caption.
; Optional. Default value - empty string.
WindowTitle = MP3 Shell (C) by Alexander Eltsyn

; The value of Icon parameter is the file name to load custom 
; MainMP3Shell window icon.
; Optional. If omitted, default icon is used.
Icon = Icon.ico

; Tre name of the MP3 collection root node.
; Optional. If undefined, the root tree node is not appeared.
MP3RootName = 'MPEG audio files collection'

; Root directory of the MP3 collection. Use the relative path to 
; exclude drive letter dependence (".\", "..\MP3\" etc.)
; MainMP3Shell window icon. 
; Optional. If omitted, the MP3Shell.exe directory is used.
MP3RootDir = .\

; Short files info filename. This file may be placed in each
; directory and contains a list of file names with short descriptions.
; The example of such a file (";" are to be omitted):
;
;track01.mp3  You And I
;track02.mp3  White Dove
;track03.mp3  Wind Of Change
;"Scorpions Best Ballads (4).mp3"  Still Loving You
;
; Typical file lists file names are "files.bbs" and "Descript.ion"
; Optional. Default value "files.bbs".
FilesBBS = files.bbs

; Directory description filename (plain text format). Each of the 
; MP3 collection directory may contain a description file. Depending
; of the text codepage (see below) description may be converted while 
; reading.
; Optional. Default value is "dirinfo."
DirInfoTXT = dirinfo.

; The same as above, but in the Reach Text format (RTF). RTF files have 
; the precedence on the text file
; Optional. Default value is "dirinfo.rtf"
DirInfoRTF = dirinfo.rtf

; Directory bitmap file name, similar to DirInfoTXT
; Optional. Default value is "dirinfo.bmp"
DirInfoBMP = dirinfo.bmp

; Either plain text codepage to be converted before displaying or not.
; Possible values:
; OEM  - plain text descriptions are in the OEM codepage and should be 
;        converted into ANSI before displaying.
; ANSI - plain text descriptions are already in ANSI codepage.
;
; Optional. Default value is "OEM".
TXTCodePage = OEM

; Either MPEG TAG records to be converted before displaying or not.
; Possible values: See above.
; Optional. Default value is "ANSI".
TAGCodePage = ANSI

; Should MP3Shell be used as TAG editor/filelist generator.
; Possible values:
; YES  - enable editing functions
; NO   - disable editing functions. Should be "NO" for CDROM mode.
;
; Optional. Default value is "NO".
AllowEdit = YES



; Language-specific string table. 
; These strings should be defined.
String1 = ' sec.'
String2 = ' min. '
String3 = ' h. '
String4 = 'Title : '
String5 = 'Album : '
String6 = 'Artist : '
String7 = 'Year : '
String8 = 'Time : '
String9 = 'File name : '
String10 = 'File size : '
String11 = 'Sample rate : '
String12 = 'Bitrate : '
String13 = 'Picture file : '
String14 = 'Text file : '
String15 = 'Total time : '
String16 = 'Directory : '
String17 = 'Total file size : '
String18 = 'Loaded track:'
String19 = 'WinAmp playlists'
String20 = 'Picture'
String21 = 'Notes'
String22 = 'Info'
String23 = 'TAG Editor'
String24 = 'Genre : '
String25 = 'Comment : '
String26 = 'Description in '
String27 = 'Idle priority'
String28 = 'Normal priority'
String29 = 'High priority'
String30 = 'Realtime priority'
String31 = 'Play'
String32 = 'Pause'
String33 = 'Previous'
String34 = 'Next'
String35 = 'Open'
String36 = 'Close'
String37 = 'Initializing...'
String38 = 'Collecting library information...'
String39 = 'Analyzing playlists...'
String40 = 

; Genre list. You may change, add or remove them. 
; The maximum number of "genre" strings is 255.
; These strings should be defined.
Genre000 = Blues
Genre001 = Classic Rock
Genre002 = Country
Genre003 = Dance
Genre004 = Disco
Genre005 = Funk
Genre006 = Grunge
Genre007 = Hip-Hop
Genre008 = Jazz
Genre009 = Metal
Genre010 = New Age
Genre011 = Oldies
Genre012 = Other
Genre013 = Pop
Genre014 = R&B
Genre015 = Rap
Genre016 = Reggae
Genre017 = Rock
Genre018 = Techno
Genre019 = Industrial
Genre020 = Alternative
Genre021 = Ska
Genre022 = Death Metal
Genre023 = Pranks
Genre024 = Soundtrack
Genre025 = Euro-Techno
Genre026 = Ambient
Genre027 = Trip-Hop
Genre028 = Vocal
Genre029 = Jazz+Funk
Genre030 = Fusion
Genre031 = Trance
Genre032 = Classical
Genre033 = Instrumental
Genre034 = Acid
Genre035 = House
Genre036 = Game
Genre037 = Sound Clip
Genre038 = Gospel
Genre039 = Noise
Genre040 = Alt. Rock
Genre041 = Bass
Genre042 = Soul
Genre043 = Punk
Genre044 = Space
Genre045 = Meditative
Genre046 = Instrumental Pop
Genre047 = Instrumental Rock
Genre048 = Ethnic
Genre049 = Gothic
Genre050 = Darkwave
Genre051 = Techno-Industrial
Genre052 = Electronic
Genre053 = Pop-Folk
Genre054 = Eurodance
Genre055 = Dream
Genre056 = Southern Rock
Genre057 = Comedy
Genre058 = Cult
Genre059 = Gangsta Rap
Genre050 = Top 40
Genre061 = Christian Rap
Genre062 = Pop/Funk
Genre063 = Jungle
Genre064 = Native American
Genre065 = Cabaret
Genre066 = New Wave
Genre067 = Psychedelic
Genre068 = Rave
Genre069 = Showtunes
Genre070 = Trailer
Genre071 = Lo-Fi
Genre072 = Tribal
Genre073 = Acid Punk
Genre074 = Acid Jazz
Genre075 = Polka
Genre076 = Retro
Genre077 = Musical
Genre078 = Rock & Roll
Genre079 = Hard Rock
Genre080 = Folk
Genre081 = Folk/Rock
Genre082 = National Folk
Genre083 = Swing
Genre084 = Fast-Fusion
Genre085 = Bebob
Genre086 = Latin
Genre087 = Revival
Genre088 = Celtic
Genre089 = Bluegrass
Genre090 = Avantgarde
Genre091 = Gothic Rock
Genre092 = Progressive Rock
Genre093 = Psychedelic Rock
Genre094 = Symphonic Rock
Genre095 = Slow Rock
Genre096 = Big Band
Genre097 = Chorus
Genre098 = Easy Listening
Genre099 = Acoustic
Genre100 = Humour
Genre101 = Speech
Genre102 = Chanson
Genre103 = Opera
Genre104 = Chamber Music
Genre105 = Sonata
Genre106 = Symphony
Genre107 = Booty Bass
Genre108 = Primus
Genre109 = Porn Groove
Genre110 = Satire
Genre111 = Slow Jam
Genre112 = Club
Genre113 = Tango
Genre114 = Samba
Genre115 = Folklore
Genre116 = Ballad
Genre117 = Power Ballad
Genre118 = Rhythmic Soul
Genre119 = Freestyle
Genre120 = Duet
Genre121 = Punk Rock
Genre122 = Drum Solo
Genre123 = A Cappella
Genre124 = Euro-House
Genre125 = Dance Hall
Genre126 = Goa
Genre127 = Drum & Bass
Genre128 = Club-House
Genre129 = Hardcore
Genre130 = Terror
Genre131 = Indie
Genre132 = BritPop
Genre133 = Negerpunk
Genre134 = Polsk Punk
Genre135 = Beat
Genre136 = Christian Gangsta Rap
Genre137 = Heavy Metal
Genre138 = Black Metal
Genre139 = Crossover
Genre140 = Contemporary Christian
Genre141 = Christian Rock
Genre142 = Merengue
Genre143 = Salsa
Genre144 = Thrash Metal

;-_-------------------- file MP3Shell.ini end ---------------------_-





