[%- pagetitle = 'PLUGIN_LASTFM_MODULE_NAME' | string; pageicon = 'RADIO' -%]
[%- pwd_list = BLOCK -%]
	/ <a href="index.html?player=[% player | uri %]"> [% "PLUGIN_LASTFM_MODULE_NAME" | string %] </a> 
	/ <a href="help.html?player=[% player | uri %]"> Help </a>
[% END -%]
[%- pageHeaderInfo = BLOCK %]
[% END -%]
[%- PROCESS pageheader.html %]

<!-- start plugins output -->
<h1>LastFM Help</h1>
<ul>
	<li><a href="#configuration">Configuration</a></li>
	<li><a href="#usage">Usage</a></li>
	<li><a href="#stations">Stations</a></li>
	<li><a href="#remote">Remote Shortcuts</a></li>
	<li><a href="#redirect">Configuring lastfm: links</a></li>
	<li><a href="#links">External Links</a></li>
</ul>
<a name="configuration"><h2>Configuration</h2></a>
Configuration options are found in Server Settings / Internet Radio<br>
If you do not have the SlimScrobbler plugin installed, enter your LastFM username and password. 
If you do have it installed, the logins as configured for SlimScrobbler will be used by default.
(This behaviour can be changed with the 'Use SlimScrobbler login' setting).

<a name="usage"><h2>Usage</h2></a>
There are two ways to control the LastFM music; From the player itself, or from the SlimServer web interface. The Web interface offers features that are not available from the player interface, such as editing your favourite stations, track artwork and a recently played history.
<h3>From the player</h3>
The LastFM menu can be found within the Internet Radio menu by default.
<br>When entering the menu without LastFM playing, the list of favourite stations is shown. (The default is the last station you listened to.)
<br>Press play to start playing the displayed station or use the arrow keys to move between the available stations. 
When playback is started the display will change to 'waiting for track details' and LastFM playback will start (this can take up to 30 seconds). 
<br>The track details should be updated within 60 seconds of the music starting.
<br>While playing, the display is shows the name of the track playing on the bottom line, and the station name on the top right.
<br>Options to send the LastFM commands are now available from the menu, as well as a sub menu to change stations.
<h3>From the web interface</h3>
Operation from the web interface is very similar to the player. 
Make sure that you have the correct player selected in your interface, and then enter
the LastFM plugin page found in the Internet Radio section (in the drop-down box in some skins).
Select a station to start playback.<br>
Once playback has started, the track and station details are shown, along with artwork and recently played tracks (depending on configuration) and the LastFM commands are available.
<a name="stations"><h2>Stations</h2></a>
Your saved favourite stations are available to choose from in both interfaces.<br>
Your own user's stations are always available so do not need to be saved.<br>
The SlimScrobbler group station is added automatically on installation.<br>
When playing additional stations are automatically generated, such as similar artists to those recently played, or a feed from the current user or group.<br>
<br>Stations can be entered, saved and deleted  only in the web interface.<br>
Enter a station address in the blank text box and then either play it (click the play icon) or add to saved stations (hit enter or click the add button). 
<br>Saved user stations (e.g. user/craigjam) automatically generate all of the options such as recommended or neighbours (and personal and loved for subscribers).  
<br>Use the play button alongside saved stations to play, or remove with the delete button. Use the 'add' button alongside automatically generated stations to save them permanently.
<h3>Station Addresses</h3>
Enter stations into the interface formatted like this:
<ul>
	<li>User stations:  "user/craigjam"</li>
	<li>Group stations: "group/SlimScrobbler"</li>
	<li>Global tag stations: "globaltags/rock"</li>
	<li>Similar Artist station: "artist/Blur/similarartists"</li>
</ul>
<br>You can copy station addresses from the LastFM web page (use 'copy link location' in Firefox) into the plugin.The lastfm:// prefix will be automatically removed.
<br>You can preface the station addresses with a 'nickname' which will be displayed rather than the full station name. Separate the nickname and the station address with a semi-colon e.g.
<br>"like Beck &amp; Boo Radleys;artists/1001148,1001741,3325,956,1001286,711,1035181,58,2138580..."
<a name="remote"><h2>Remote Shortcuts</h2></a>
You can use the following commands in the SlimServer remote map file to
direct access LastFM actions:
<ul>
	<li>modefunction_PLUGIN.LastFM::Plugin-&gt;lastfm_love</li>
	<li>modefunction_PLUGIN.LastFM::Plugin-&gt;lastfm_ban</li>
	<li>modefunction_PLUGIN.LastFM::Plugin-&gt;lastfm_skip</li>
</ul>
See the SlimServer technical information for more details of changing the remote map file.<br>
<a name="redirect"><h2>Redirect lastfm:// links to SlimServer</h2></a>
<h3>REQUIREMENTS</h3>
<ul>
	<li>Windows XP</li>
	<li>firefox</li>
</ul>

<br>To make the radio links playable you need to
<ul>
	<li>Make sure firefox understands the protocol</li>
	<li>make sure Windows understands the protocol</li>
</ul>
<br>For the following I will use the following attributes:
<ul>
	<li>$SERVERHOST$ the ip address/name of your SlimServer</li>
	<li>$WEBPORT$ the port of the web interface (usually 9000)</li>
	<li>$LASTFMDIR$ directory of the lastfm plugin</li>
	<li>$PERLEXE$ full path to perl.exe</li>
</ul>
 <br>Note: you can use wperl.exe (this does not open a command line window so you don't get the brief 'black box on screen' that you would with perl.exe).

<h3>FIREFOX</h3>
Fire up firefox and browse to about:config
<br>in the main pane right click "New String"
<br>Create a string network.protocol-handler.app.lastfm = $PERLEXE$ $LASTFMDIR$\playStation.pl

<h3>WINDOWS</h3>
You need to make some changes in the registry to make the protocol work in particular you need to add LastFM to the HKEY_CLASSES_ROOT. The structure of the entries is as follows
<br>
<br>[HKEY_CLASSES_ROOT\lastfm]
<br>(Default)		= "LastFM protocol"
<br>"URL Protocol"		= ""
<br>
<br>[HKEY_CLASSES_ROOT\lastfm\DefaultIcon]
<br>(Default)="Notepad.exe"
<br>
<br>[HKEY_CLASSES_ROOT\lastfm\shell]
<br>
<br>[HKEY_CLASSES_ROOT\lastfm\shell\open]
<br>
<br>[HKEY_CLASSES_ROOT\lastfm\shell\open\command]
<br>(Default)="$PERLEXE$ \"$LASTFMDIR$\\playStation.pl\" \"$SERVERHOST$\" \"$WEBPORT$\" \"%1\""
<br>
<br>If you have more than one player, add the name of the player you want to use to the end of that last property; for example:
<br>
<br>"$PERLEXE$ \"$LASTFMDIR$\\playStation.pl\" \"$SERVERHOST$\" \"$WEBPORT$\" \"%1\" \"Study\""
<br>
<br>After all that restart firefox and click on a radio link. It should throw up a prompt to confirm you want to launch the program - say yes. Slim server should start playing the stream.

<a name="links"><h2>External Links</h2></a>
<a href="http://www.last.fm" target="_blank">Last.FM</a><br>
<a href="http://slimscrobbler.sourceforge.net" target="_blank">SlimScrobbler Home Page</a><br>
<a href="http://www.jamescraig.co.uk/SlimServer" target="_blank">James Craig's plugin page</a><br>
<br>
<!-- end plugins output -->
[% PROCESS pagefooter.html %]