MP3Mystic – v1.08 By Jason Rahaim Jason@mp3mystic.com http://www.MP3Mystic.com/ Introduction MP3Mystic is a personal MP3 streaming web server. It is easy to set up (3 required settings, Server name (can be anything), Music Directory, and the port (Leave it at 80 for ease of use, set it to anything for a little more security). MP3mystic is also very customizable (paid registration required). The most current version is always available from www.mp3mystic.com. Installation Double click the installer application. Choose a directory to install the software (DO NOT Install the software in the same directory tree as your music). C:\program files\mp3mystic is the default. Run mp3mystic. Choose “File”-“Setup”. Enter a server name, Mp3 Directory, Port, and check “Start server on launch”. Click save. If you are running a registered version, don’t forget to run “File”->”Rebuild Cache”. The default Admin username is ‘Admin’ the default Password is ‘MP3Mystic’. It is recommended that you change this IMMEDIATELY. Got to _admin then click on users to change the password. See below for details on how to fill out those fields. Upgrading instructions NOTE: If you are upgrading from any version prior to 1.07b3 to any version 1.07b3 or greater PLEASE read this carefully. The supervisor name and password has been removed from the setup screen. The supervisor name/password has been copied to your regular user list, and flagged as an admin. You SHOULD be able to log in with your old supervisor name and password. You will receive a dialog box confirming the admin username and password the first time you start this version. If you cannot log in with your old supervisor name/password exit mp3mystic and delete USERS.TXT. When you restart mp3mystic the default administrator will be created (User: admin password: MP3Mystic). You will then need to recreate your users. ADVANCED users can edit the users.txt to remove the duplicate names. For more information please email me. If you have modified either of the default themes, and don’t wish them overwritten, deselect them from the installation. Install as above. Cost MP3Mystic comes in 3 versions. The Basic version is a fully functional Personal web server allowing one connection at a time. For $9.95 you can upgrade to the Plus version which is fully configurable, and allows an additional connection. For $29.95 you get the Commercial version. It includes the ability to serve multiple directories/drives as well as support for unlimited connections. When you first install MP3Mystic you will have all the features of the Plus Version for 30 days. After that it will revert to features of the free version. http://mp3mystic.com/mp3mystic/purchase.php for more information, and purchasing. You may distribute this program freely, but you may NOT share Registration codes. Setup General Server name: This is displayed at the top of each screen. For example “My Rock’n MP3 Server”. MP3 Directory: this is the path to the route of your mp3 files. For example “c:\my music”. ALL directories below this will be browse able. For registered versions use the Semi-Colon to separate multiple paths. Port: The IP port to listen on. The default port for web servers is 80. If you use a port other than 80 (8000, 8080, and 8008 are common) you will need to append the port # to the address of your server. Start Server on Launch: if this is checked the server will start when the application is started. If this is not checked you must chose start from the main menu. IPs tab - Optional “Allow all IPs except” – Default. This option lets the world connect to your server, EXCEPT for the IPs listed in the box below. “Deny all IPs Except” – This option shuts the world out of your server except for the IPs listed in the IP box. If you type in a partial IP address (ie “192.168.”) It will allow/deny the whole block. Allow Direct linking: (default on) Allows other web sites to link directly to individual files on your machine instead of having to go threw the index.html file. If you are concerned about popular websites linking directly to your files you should turn this off. Any request other than the index.htm file will be redirected to the index file. – Please Note: This option is being redesigned. It will be re-enabled eventually. Advanced Tab -Optional Music Types: File Extensions that you want MP3Mystic to serve, that CAN be streamed. Files with these extensions will have play lists automatically generated for them. (Example MP3, OGG, Etc.). File Types: Files you want users to be able to down load from your site that are not streamable. These might include pictures (JPG, GIF, etc), text files, and documents. M3Us must be listed here. Types MUST be separated by Semicolons or colons. IP Address: You only need to set this if you machine has Multiple IP Addresses (Usually do to multiple Ethernet cards) and you only want MP3Mystic to reply to one IP address. Otherwise it MUST be set to 0.0.0.0 Display “Download”: Turning this off will hide the “download” link on all internally generated web pages. This doesn’t actually prevent people form downloading music, since they can always type in the path by hand. Display “Listen”: Turning this off will hide the “stream” link on all generated web pages. Registration Tab Registration code: Entering a valid MP3Mystic registration code (purchased from MP3Mystic.com) will fill in your name and valid serial #. Please contact Jason@mp3mystic.com for more information. Hide Powered by MP3Mystic text: Commercial users have the ability to hide the “powered by MP3Mystic” text found at the bottom of every page. I would still appreciate a link to mp3mystic.com somewhere on your site. But it is NOT required. Uploads Tab – (registration required) Allow Uploads: If checked AND your HTML files have the Tag in them users will be allowed to upload files to your server. Upload Directory: Directory to store uploaded files. Only allow uploading of MP3 Files: This will allow you to restrict uploading of MP3 files only. The server will reject any other files. Require ID3v1 Tags: If you only allow MP3 files you can also require that the files contain a valid ID3v1 Tag (Minimally song name and artists). Auto Rebuild – (Registration Required) This option will automatically rebuild your cache at specified intervals. I recommend “daily at” 0200 (2am) if you frequently change your music collection. Users who allow uploads may want to set this to be more often. Maximum Logfile size: To keep the log files MP3Mystic writes from growing out of control, you can specify a maximum size. This defaults to 1000KB (or 1MB). If you don’t want your log files to be trimmed, set this to 0. Logs are trimmed two ways, from the menu “Utilities”->“Trim Logs” and when the Auto Rebuild runs. Main Screen This screen shows connection information (Current, Maximum concurrent, and total) and current user activity. The second box on the status bar shows weather the server is active or not, and if it is active (and someone has connected to it) it shows the web address of the server. This is purely for debugging purposes. Accessing the server: Ok, so you have the server running. Now what. If you are on the same machine as the server you can launch a browser, and connect to http://127.0.0.1/ (if you chose the default port of 80, if you chose a different port for example 8080 you would type. http://127.0.0.1:8080/ Machines connected to Routers, and some dsl/cable may have 2 different IP addresses. A local one (LAN) (usually in the form 10.x.x.x or 192.168.x.x.x If you have an ip address with either of these formats you need to find out your true IP address.) and a global one (internet). To find out your real IP address (the one you would use outside your local network) go you “help”->”Get my IP address”. Special Pages: (the supervisor username and password are required to access these pages) _version – Returns the current version string. (User/password not required) _admin – Admin page. (These pages can all be accessed from the _admin page). _users – Add/Edit/Remove users to your system. _log – Shows a log of ALL accesses to the server (logs are kept in c:\) _stats – Shows the most frequently access files. _shutdown – Shuts the server down. (there is no way to restart it remotely). _restart – Restarts the web server. _ipallow – Add/remove IP addresses/blocks. _rebuild – Rebuilds the search cache. _access – Summarizes server accesses by IP address. _activity For example http://127.0.0.1/_log Themes: (Registration Required!!) Themes are stored in Themes\”Theme name” in the installation directory. MP3Mystic ships with 2 themes. “Basic” and “MysticTheme”. You can download additional themes or create your own theme in a new directory under “Themes”. To set the default theme, go to Setup “general” tab (Registration required). Setting the default theme to “Random Theme” will cause each connection to use a random theme (of the ones you have installed). The Server Defaults to “index.htm” if no name is entered in the URL. (“http://127.0.0.1/” as an example) Special HTML tags are: List of mp3 files and directories. If you want to use ID3 information instead of filenames, the format is where id3str con consist of any characters/symbols with the following special codes (this are the same codes that Winamp uses) %1 – Artist %2 – Title %3 – Album %4 – Year %5 – Comment %6 – Genre %7 – File name (With Extension) %8 – Directory %9 – File extension %d – Date Modified %f – Filename (No Extension) %s – File Size %x – File Extension Example You can also use the following subtags inside MP3Files= Surpresses display of “listen” “download” “playlist” tags. You will need to display them manually with: - displays “listen” or listen icon (). - displays “download” or listen icon (). - - displays “Playlist” or listen icon (). - Displays a track infor screen if ID3 Information is Available. Example %2”> where nn is a number 1-100. and format uses the same commands as . Displays the most recent files. For example %2(%D)
”> will display the most recent 10 files, with a listen link. With the date added in parenthesis. Displays all files added yesterday. Format is the same as above so: %2
"> will display all files added yesterday with a Listen link. Displays all files added in the last n days. Where n can be any number. The default is 7 days. Example: %2
"> Will display all the files added within the last 5 days with a listen link. Relative path to the current directory. If the page was generated as a result of a search the text will be “Search results “ plus the search string. Search string. This is should only be used if you have special page for search results (as opposed to just using the same page as your browsing page. This returns JUST the search string. the MP3 file search box. Specify a html file to display the results of the search with. If you don’t use this then index.htm will be used. Your target html page must exist in appropriate theme directory. Display the most frequently downloaded files. Display the current number of active connections. Displays the list of active users. Display the maximum number of concurrent connections. Show the current number of connections. Display the Current Version Number. Display the Server name as entered in the Config screen. Displays UPLOAD box if enabled on the server. Displays the total number of files on your system. Displays the listen to all songs text or icon. Displays the listen to all songs and directories icon or text. Displays the PlayListShuffle text or icon. Only displays in the playlist manager. , , , , , , , , , , , , , Define icons to use instead of the appropriate text. Example will use Listen.gif instead of the text ‘listen’ on custom webpages. The Icon file should be stored in your MP3Mystic route directory. Displays login box if you are not logged in, or displays your username and a logout link. Displays links to Browse by ID3tags. Example file: (save this to index.htm in your ‘route path’ directory then browse to http://127.0.0.1/ ) mp3Mystic test Page

Test!

Some other special links: “/index.htm?browseby=ArtAlbum” – Browse by Id3v1 tags. \id3v1 artist\id3v1 Album structure. “/index.htm?browseby=Artist” – Browse by Id3v1 tags. \id3v1 artist “/index.htm?browseby=Genre” – Browse by Id3v1 tags. \id3v1 Genre “/index.htm?browseby=Year” – Browse by Id3v1 tags. \id3v1 Year “/index.htm?browseby=All” – Your entire collection without a directory structure (This may be slow with large collections. 8500 songs take about a minute to come up) “/index.htm?browseby=” – Turn off id3v1 based browsing. INI Settings – Advanced users only Section Tag Value [Advanced] StartUpDelay Number of seconds between launching MP3Mystic and opening ports. To be used if you are launching MP3Mystic on startup with Zone Alarm or any other Software based firewall. Can be overridden with command line parameter delay=x where x is the number of seconds to delay. [Advanced] UseCache Turns off directory caching. If your collection changes regularly and you don’t want to keep rebuilding the cache you will want to turn caching off. General Warnings: This is a web server. You will be giving people access to your files by running this software. By Design it ONLY serves mp3 and m3u files. I believe it to be well behaved in this manner. I do not believe there is a way to get access to anything outside of the MP3Music directory you specify, be careful creating shortcuts in the route directory you setup. Crackers are VERY resourceful. Jason Rahaim Jason@mp3mystic.com To Do – (email Jason@mp3mystic.com if there is something you would like added) Better user support – Download/listen limits. Separate “look” for directories and files. Auto Trim Log Files. Standardize Logfiles. All Settings changeable from the Web. tags. Eye candy tags for “most popular song”, “songs/artists of the day”, “Last Song”, “Random song”, “Random song for a particular Genre”, Etc. Arrays/Scripting language. Optionally installing new versions and updates. Resume interrupted downloads. Paths Linkable. Loading Progress HTML files stored in a different place. Option for directories to open a new window. Recently Removed from the To Do List: Support for players that don’t support http://user:password@server/ (Sessions). (Also includes support for “no deep linking”) Done! [1.06b3] Define a particular Server name to listen to. (Like Apache) Done! [1.06b4] More stylish screen for the free version.(with Adds/links) Done! [1.06b4] Active Connection List Done! [1.07b3] Track info screen. Done! [1.07b5] Revisit id3v2 tags. Started! [1.07b5] Checking for new versions and updates. Done! [1.07b11]