Help index




When you have installed myMusic you access your music collection here. The installation program creates a default admin user named "admin" with the password "admin". Use this user to access your music the first time, you can update this user as you which at a later time.


Figure 0. Default user and password to access myMusic

Overview
What is myMusic ?
How does myMusic work ?
Prerequesits

Common functions
Find a song or an album
Play a song or an album
Play songs randomized
Create a playlist with selected songs
Listen and administrating your radio channel
Add a song , record or playlist to your radio channel
Find latest additions to your music collection

Configuration
Start myMusic
Make myMusic accessable from the internet
Change skin
Create your own skin
Create a new user
Change, lock or remove a user
Add a radio channel
Configure Apache as a proxy to myMusic
Configure Apache with SSL

 

 

 

 



What is myMusic ?

myMusic is a program you use to organize and play your music. myMusic is designed to make your music collection portable over the internet so you can access it were ever you are, at home, at the office, at the party or when you are running in the woods.

Figure 1. Example infrastructure

 

How does myMusic work?

myMusic is build by five separate components, a webserver, two CGI-programs, a streamserver and a streamsource. The webserver is responsible for dispaching the requests from the user and returning data to the client (mediaplayer or webbrowser), the data can be HTML, pictures or soundstreams. The first CGI-program renders the user interface och the second CGI-program generates playlists. The stream -server and -source together create a net radio channel.


Figure 2. Overview

 

Prerequesits

myMusic only runs on Microsoft Windows 2000, XP or later. myMusic requires that there is a mediaplayer and a webbrowser installed on the system. Your music must be organized in "Artists-folders" that contain "Album-folders" that contain MP3-music files on your harddrive. The artist- and album-folders should contain a picture file named Folder.jpg. An a example structure is installed under your music-folder, fi: c:\Documents and settings\user\My documents\My music.


Figure 3. Folder structure required by myMusic

 

Find a song or album

There are two ways to find a song/record/artist in myMusic. You can browse the index (1-2,4) until you find what you are looking for or you can seek the title directly in the the seek field (3).

Figure 4. Navigate your music using myMusic

 

Play a song or a record

When you have found the title you want to play, simply click the "Play" (4) button to start the mediaplayer with the selected title.


Figure 4a. Play a title from myMusic in your mediaplayer

 

Play a randomized playlist

You can create and listen to a randomized playlist by clicking the "Random play" (5) button. A randomized playlist is created by randomly select songs from your music collection. The number of songs in a randomized playlist depends on the size in bytes of the individual music files. myMusic select songs in a randomized playlist so that the totalsize of all songs doesn't exceed 650MB. This size is choosen so that you are able to fit (burn) the playlist's songs on a ordinary CD-RW. The created playlist is loaded to your mediaplayer directly after creation. If you want to play the playlist at a later time the list is saved under "My playlists".

 

Create a playlist with selected songs

To create a playlist with songs of your choise simply browse your music, and when you find a song, click "+" (1) to add the song to the playlist. To browse the playlist under creation, click "New playlist" (2).

Figure 5. Choose songs for a new playlist

You can remove songs from the playlist by clicking "-" (2). When you are finnished with the playlist, click "Save" (1) to save the playlist. The playlist is found under "My playlists" after it is saved. If you end your browser session before saving the playlist, the list is lost.


Figure 6. Edit a playlist in myMusic

 

Listen and administrating your radio channel

Your radio channel is accessed by clicking "My radio" (1). Here you can see what song is played, the song that's comming up and the whole song queue (2). The queue is created by adding song requests. You listen to the radio channel by clicking "Play" (4) which starts the mediaplayer with your radio channel stream. If you (logged on user) has admin rights you can change the "marker" for the next song forward and backwards, remix the queue, or empty the queue (4). When you stop myMusic's radio channel (Streamserver and streamsource services) the radio queue is saved in a playlist named My radio.m3u wich is stored under "My playlists". When you start myMusic again this playlist is reloaded into the radio channel queue.


Figure 7. Your radio channel in myMusic

 

Add a song, record or playlist to the radio queue

In the view's for albums and playlists there is a button. If you click this button the song, record or playlist is added to the radio channel queue.

 

Find latest additions to your music collection

By clicking the "Latest added" button, myMusic will list the latest added albums to your music collection based on the change date on the music files and music folders.

 

Start myMusic

myMusic has three windows services of wich at least "Webserver" must be started. The services "Streamer" and "Source" is only required if you want to use the radio channel. Start myMusic's configurationprogram "myMusic settings". Check the services you want to start and click "Start services". When a service is running this is marked with a green color, and when its stopped this is marked with a red color. You can also start the services i windows controlpanel applet "Services" and when you do you must know that the services must be started in the following order: 1. "Webserver", 2. "Streamer", 3. "Source". You can control myMusic services on another host if you supply this hostname in the textbox "Services hostname".


Figure 7a. Start myMusic services in the configuration program


Figure 7b. Start myMusic services in windows controlpanel applet

 

Make myMusic accessable from the internet

When you have installed myMusic you can access your music collection locally on the same machine in a webbrowser at this URL: http://localhost:800/myMusic/. To be able to reach the collection from another machine on the internet you must create an open route to your computer. To be alble to listen to your music from the internet you must have a broadband connection a minimum bandwidth of 250kbit/s (0,25Mbit/s).

Do like this:

1. If your computer is protected by a firewall you must open port 800. If you want to use another port you must configure myMusic to listen for incomming calls on this port. Change port in "myMusic setting " under the tabs "Webserver" and "CGI".


Figure 8a. Change port for myMusic's webserver

2. Open port 8000 in your firewall or change this port in the tabs "CGI" och "Streamserver".


Figure 8b. Change port for myMusic radio channel

If you don't want to open more than one port (fi. 80) in your firewall you can use a proxy. The free webserver Apache can be used for this perpose.

3. Create a alias for your IP-adress on a DNS. There are several ISP:s on the internet that supply DNS services for a fee or free of charge, fi.: dyndns.org. If you don't create a alias for your IP you can only access your collection by supplying your IP-adress directly in the webbrowser, example: http://123.123.123.123:800/myMusic/. Update myMusic, tabs "CGI" and "Streamserver", with the alias or your IP-adress. To find your IP-adress click "Find IP-adress in the CGI-tab.


Figure 8c. Change host alias or IP-adress for myMusic

 

Change skin

Change myMusic's skin is done in the configurationprogram "myMusic settings". Click tab "Skin" and choose skin in the dropdownlist.


Figure 9. Select skin in myMusic

 

Create your own skin

If you are not pleased with the supplied skins you can create your own variant, or even create a completely new user interface.

Create a variant skin based on the standard skin
The simplest way to create your own skin is to use the standard templates (.html) which are placed under the folder, {myMusic}/cgi-bin/en/{skin}, and update images, fonts and colors. The stylesheets for fonts and colors (mp3.css) and image files are installed under the folder: {myMusic}/root/static/en/{skin}/cgi-bin.

Do like this:

1. Create a new folder under {myMusic}/cgi-bin/en, example: c:/Program/tonjac.org/myMusic/cgi-bin/en/myskin
2. Copy all .html files from the standard skin to your new folder
3. Create a new folder under {myMusic}/root/static/en, example: c:/Program/tonjac.org/myMusic/root/static/en/myskin/cgi-bin
4. Copy all files from {myMusic}/root/static/en/standard/cgi-bin to your folder
5. Update mp3.css and .gif and .jpg in your folder
6. Test your skin by changing to your new skin (observe that the preview image doesn't work yet)
7. When you are satisfied, make a image dump of your skin in the browser and save it as preview.jpg under {myMusic}/cgi-bin/en/myskin

Create a new user interface
To create a completely new user interface is more advanced and requires that you are familiar with HTML-development.

myMusic's user interface is created from 10 different templates. These templates must by named according to table 1 below. Each templates dynamical content is rendered by myMusic's CGI-program. All dynamical data is represented by tags in the templates. A tag (table 2) is a symbolical name for dynamical data or a function call. The name is always prefixed with a '#'. Example: #AlbumTitle, that is expaned to a album title and #PlayLink is expaned to a function call in runtime. Observe that all tags don't work in all templates, look in the standard templates to see which tags that work in which templates.

Template Description
renderException.html Error message
renderHelp.html Help
renderInfo.html Info and statistics
renderList.html List artists, albums, playlists and radio channels
renderMyRadio.html My radio
renderPlaylist.html Playlist contents
renderSongs.html Song list
renderFrames.html Frames
renderTop.html Top frame
renderLeft.html Left frame

Table 1. Templates

Do like this:

1. Create a user interface project in a folder. Copy the standard templates to this folder.
3. Edit the templates according to your wiches with a HTML-editor like Dreamweaver or FrontPage
4. Install the skin by coping the templates to ~cgi-bin/en/{skin}. Stylesheets and images are to be copied to ~root/static/en/{skin}/cgi-bin.

 

Tag (#) Description Function Data
AddAlbumToRadio Add album to the radio channel queue x
AddPlaylistToRadio Add playlist to the radio channel queue x
AddSongToPlaylist Add song to playlist x
AddSongToRadio Add song to the radio channel queue x
AlbumTitle Album title x
Artist Artist x
BackURL Back URL x
Bitrate Bitrate x
ClearRadio Empty radio channel queue x
CommingUp Next song to be played in the radio channel x
CompName Component name x
CompVersion Component version x
copyright Copyright text x
EmptyLink Empty list x
ErrorMessage Error message x
headline Headline x
Help Show help x
helpHTML Help text x
Index0-9 List artists that begins with the letter 0-9 x
IndexA List artists that begins with the letter A x
IndexAE List artists that begins with the letter Ä x
IndexAO List artists that begins with the letter Ö x
IndexB List artists that begins with the letter B x
IndexC List artists that begins with the letter C x
IndexD List artists that begins with the letter D x
IndexE List artists that begins with the letter E x
IndexF List artists that begins with the letter F x
IndexG List artists that begins with the letter G x
IndexH List artists that begins with the letter H x
IndexI List artists that begins with the letter I x
IndexJ List artists that begins with the letter J x
IndexK List artists that begins with the letter K x
IndexL List artists that begins with the letter L x
IndexM List artists that begins with the letter M x
IndexN List artists that begins with the letter N x
IndexO List artists that begins with the letter O x
IndexOE List artists that begins with the letter Ö x
IndexP List artists that begins with the letter P x
IndexQ List artists that begins with the letter Q x
IndexR List artists that begins with the letter R x
IndexS List artists that begins with the letter S x
IndexT List artists that begins with the letter T x
IndexU List artists that begins with the letter U x
IndexV List artists that begins with the letter V x
IndexW List artists that begins with the letter W x
IndexX List artists that begins with the letter X x
IndexY List artists that begins with the letter Y x
IndexZ List artists that begins with the letter Z x
InfoLink Info link x
InfoRow Info row x
ip Client IP adress x
lang Choosen language x
ListArt Image in a list x
ListChannels List radio channels x
ListLatestAdded List latest news x
ListMyRadio List my radio queue x
ListPlaylist List a playlist x
ListPlaylists List all playlists x
ListRecord List albums x
LocalName My radio name x
No Number x
NoAlbums Number of albums x
NoArtists Number of artists x
NoSongs Number of songs
NowPlaying Song that is played in my radio just now x
PlayLink Play link x
PlaylistLatestAdded Latest added song to a playlist x
PlaySong Play song x
RadioLatestAdded Latest added song to my radio x
Randomize Create a randomized playlist x
RandRadio Randomize the my radio queue x
RemoveSong Remove a song x
RenderTopFrame Render top frame X
RenderLeftFrame Render left frame X
RenderMainFrame Render main frame X
SaveLink Save link x
SeekLink Seek link x
SeekSvc Seek service x
sid Session id x
Size Size of playlist i MB x
skin Choosen skin x
SkipBackward Skip my radio queue next song backwards x
SkipForward Skip my radio queue next song forward x
SongLength Songlength x
SongTitle Songtitle x
table Table marker x
Time Playlist length in minutes x
title Title x
TitleLink Title link x
TitleRow Title row x
user User id x
version Version x
Year Year x

Table 2. Tags that represent dynamical content in myMusic's user interface templates



Create a new user

A new user is created in the "Webserver" tab in myMusic's configuration program. Click the button "Add..." and enter username and password and click "Administrator" box if the user should have admin rights. A user with admin rights can empty and change the radio queue.


Figure 10. Create a new user

If you wich to limit the users access posibilites to one ore more IP-adresses you enter these adresses separated with a colon. If this field is left emty the user will have access from all IP-adresses.


Change, lock or remove a user

To change a user you check the user in the list and clicks the button "Change..". If you want to delete a user you click "Remove" after you have marked the user in the list. If you temporary want to lock out a user you can change the field IP-adress to an impossibly adress like 999.999.999.999.


Figure 11. Change a user in myMusic

 


Add a radio channel

If you want to add a radio channel to myMusic radio list, do like this:

1. Create a file with the same name as the radio channel with the extention .m3u. Save the file under the folder you have set as "My radio" under the tab "Common" in myMusic settings.

2. Edit the file so that it supports the format below:

#EXTM3U
#EXTINF:-1,{NAME OF RADIO CHANNEL}
{URL TO LISTEN TO THE RADIO CHANNEL}

Example: (CLUB 977 The 80s Channel.m3u)
#EXTM3U
#EXTINF:-1,CLUB 977 The 80's Channel
http://64.236.34.196:80/stream/1040


Configure Apache as a proxy to myMusic

If you want Apache to be a proxy to myMusic (see figure) edit apache configuration file ({Apache}/conf/httpd.conf) according to the describtion that follows below:



Figure 12. Apache as a proxy to myMusic

Do like this:

1. Check the the following row exist and isn't prefixed with a #:

LoadModule proxy_module modules/mod_proxy.so

2. Add the following rows:

ProxyRequests Off  
ProxyPass /stream http://localhost:8000/stream
ProxyPassReverse /stream http://localhost:8000/stream
ProxyPass /myMusic/ http://localhost:800/myMusic/
ProxyPassReverse /myMusic/ http://localhost:800/myMusic/
ProxyPass /mp3/ http://localhost:800/mp3/
ProxyPassReverse /mp3/ http://localhost:800/mp3/


3. Update the URL's in the myMusic settings:


Figur 13. Update the URL:s in myMusic

When you have configured Apache as proxy as described above you will reach myMusic at: http://localhost/myMusic/.


Configure SSL with Apache as a proxy

To strengthen the security even more and protect your passwords you should protect the access to myMusic with SSL (encryption). myMusic builtin webserver doesn't support SSL but you can use the SSL implemented in Apache if you use Apache as a proxy-server to myMusic. You can read how to setup Apache with SSL here.



Figur 14. SSL and Apache as a proxy