
-------------------------------------------------------------------------
OneWeb MP3 SERVER Development Version (soon to be Version 1) 19 June 2002
-------------------------------------------------------------------------

http://www.oneweb.co.uk/


WHAT IS IT?
MP3 Server is an ASP website that allows users to search, browse and stream MP3 files as well as make 
and save custom playlists. 

FEATURES
Browse folders & MP3 files
Stream MP3s using built in or external MP3 player
Create custom playlists
Save playlists
Drag and drop playlist sorting
ID3 tag reader
File and folder searching
Secure feature and search index administration pages

SCENARIOS
Problem: I have all my MP3s on one computer at home but want to be able listen to them on 
different machines, in different rooms without all the hassle of going through Network 
Neighborhood, finding the files, and dragging them into my MP3 player.
Solution: By installing MP3 Server on my main computer and the client application on all 
other machines I can start streaming MP3s, from anywhere in the house, with two clicks!


MINIMUM SYSTEM REQUIREMENTS

Server:
Windows NT, 2000 or XP (Server or Professional) running Internet Information Services (IIS)
200MHz Processor
32Mb RAM
30Mb Free Disk Space (MP3s are stored on the server so the more space the better)

Client:
Windows 98, ME, NT, 2000 or XP
100MHz Processor
32Mb RAM
30Mb Free Disk Space
Windows Compatible Sound Card
Speakers/Hi-Fi
Client Application (music.exe)
NB. Windows 98 users will need to install the Visual Basic 6 runtime files on their PC in 
order for the client application (music.exe) to run. You can download the installer from 
http://www.oneweb.co.uk/
Internet Explorer 5
Windows Media Player 7 (for internal player)
MP3 Player that (for external player - I recommend Winamp: http://www.winamp.com/)

SETTING UP YOUR MP3 SERVER
1. Extract the contents of this zip file to a folder in your wwwroot (usually C:\Inetpub\wwwroot) 
   eg. C:\Inetpub\wwwroot\music\

2. Change the username and password for the administration pages by opening admin/default.asp in a 
   text editor (such as notepad) and chaging the words "username" & "password" to something 
   unique. This will be your login when you go to http://yourserveraddress/admin/

3. Move your MP3 files to the mp3 folder
   eg. C:\Inetpub\wwwroot\music\mp3s\
   (You can change this location through the Admin pages).

4. Register the ID3 component for reading ID3 tags in the playlist
   Extract id3.dll from id3.zip in the _Resources folder and register.
   eg. If you extracted it C:\temp\ then click "Start", "Run" and 
   enter "Regsvr32.exe C:\temp\id3.dll"
   You should receive a message confirming the component is registered.

5. Index your files for the search page. Go to http://yourserveraddress/admin/
   eg. http://localhost/music/admin - log in with the username and password you entered in 
   step 2 and click "Index all files".

6. Some other new features
   . Dynamic playlist creation - you do not need write permissions on the site folder
   . When files are in your playlist, right click one to play, move or delete it
   . Internal Player Macintosh support using embeded QuickTime player

SERVER TIPS
1. If you have a cover image for an album, resize it to around 100x100px
   put it in the same folder as the MP3 files for the album and save it as cover.gif, 
   cover.jpg or cover.jpeg. It'll now be displayed above the "Play All" link when a user browses
   to that album. If you have a larger version of the cover put it in the same location and call
   it cover_big.gif, cover_big.jpg or cover_big.jpeg then when you click the 100x100px image 
   the larger version will be displayed
 
2. If you have a large amount of MP3s it's a good idea set up a directory structure as shown:
   Genre\Artist\Album
   Here's a few real ones: 
   Club\Infected Mushroom\B.P. Empire
   Other Stuff\Chemical Brothers\Come With Us
   Now when a user first accesses the server they get "Choose a Genre" with a nice list of genres.
   One click gets them to the artists in the genre, another the albums, and one more to choose an
   album - nice and simple.
   Of course you may want to create further genre choices:
   House\Hard\Lisa Lashes\Hard House Euphoria
   House\Cheesy\Ministry of Sound\Clubbers Guide to Cheddar
   Ethnic\Arabian\Percussion\Isa Salman\Arab Drum
   http://www.mp3.com/ is a good example of genre sorting.
   
3. If you want to configure your web server go into your "Control Panel" and open 
   "Administrative Tools", "Internet Services Manager".


SETTING UP YOUR CLIENT MACHINE(S)
1. Copy Music.exe to the client machine(s)
2. Open Music.exe and set the "Default URL" (in "Options", "Settings") to your new music server.
   eg. http://10.0.0.1/music/
NB. Windows 98 users will need to install the Visual Basic 6 runtime files on their PC in 
order for the client application (music.exe) to run. You can download the installer from 
http://www.oneweb.co.uk/

--------------------------------------------------
Comments, bug reports and feature requests welcome
http://www.oneweb.co.uk/
Contact: acidmen@hotmail.com
--------------------------------------------------

This application remains the copyright of, One Web, and can NOT be sold, have links to 
One Web removed, or passed off as your own work without permission from One Web. 

However, you may use this application and scripts for both personal and commercial 
purposes and customise it as much as you like as long as the copyright and links to 
One Web remain intact. 
