<page xmlns="http://projectmallard.org/1.0/"
      xmlns:e="http://projectmallard.org/experimental/"
      type="topic" style="task"
      id="lastfm">

  <info>
    <link type="guide" xref="extend#official"/>
    <link type="seealso" xref="sync"/>
    <desc>Enable Last.fm, song reporting and Last.fm radio.</desc>
    <revision pkgversion="1.6" version="0.1" date="2010-07-15" status="draft"/>
    <credit type="author">
      <name>Paul Cutler</name>
      <email>pcutler@gnome.org</email>
    </credit>    
<!--
    <copyright>
      <year>2010</year>
      <name>GNOME Documentation Project</name>
    </copyright>
-->
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

  <title>Last.fm</title>    
  
  <p>Last.fm is a popular online service that offers both free and paid
  versions.  Last.fm offers information on music artists and albums and if you 
  create a user profile Last.fm allows you to track the music you listen to 
  in Banshee for free.  If you subscribe as a paying member, you can also listen
  to streaming music from Last.fm in various music clients, including Banshee.
  Last.fm offers multiple channels to stream, including recommended music for
  you based on your listening habits, your favorites and more.</p>
  
  <section id="enable-lastfm">
  <title>Enable Last.fm</title> 
  <p>To get the most out of Last.fm, you will want to create a Last.fm profile.
  Visit <link href="http://www.last.fm/join">http://www.last.fm/join</link>
   to create an account or choose 
  <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> from the Banshee
  menu. Once in the preferences select the <gui>Source Specific</gui> tab, press the
  <gui>Source</gui> drop down menu, choose <gui>Last.fm</gui> and finally select the
  <em>Sign up for Last.fm</em> link.
  </p>
  
  <p>To enable Banshee to report the songs you play on your computer to Last.fm,
  sign in to Last.fm in Banshee in the <gui>Source Specific</gui> preferences.
  Enter your username and press the <gui>Log in to Last.fm</gui> button.  You 
  will be directed to a Last.fm webpage in your browser to grant Banshee access.
  Press the <gui>Yes, allow access</gui> link in your browser and you will be 
  redirected to a webpage that displays a message that Banshee now has access to
  Last.fm.  Return to Banshee and press the <gui>Finish Logging In</gui> button
  to complete the process.
  </p>
  
  </section>
  
  <section id="songreporting">
  <title>Enable Last.fm Song Reporting From Banshee</title> 
  <p>After you have successfully linked Banshee to your Last.fm profile you must
  ensure that you have enabled Banshee to report your songs.  To enable Banshee to
  report the songs to your Last.fm profile go to Banshee's preferences, select the
  <gui>Source Specific</gui> tab, select <gui>Last.fm</gui> from the dropdown, and
  press the <gui>Enable Song Reporting From Banshee</gui> checkbox. If you have an active internet
  connection Banshee will now send Last.fm information regarding the songs
  you play.  To view your play history visit your profile on the Last.fm
  website.  Last.fm will automatically update your music metadata if any of your
  artist, song title, or album information is incorrect (although we recommend that
  you use the Metadata Fixer extension to correct your files instead).

  </p>
  
  </section>

  <section id="devicesongreporting">
  <title>Enable Last.fm Song Reporting From Your Device</title>
  <p>After successfully linking Banshee to your Last.fm profile and enabling Banshee to 
  report songs to Last.fm you can also enable scrobbling from a connected device. Banshee 
  will, upon connection of your device, attempt to scrobble the songs you have played since the 
  device was last connected and submit them to Last.fm.
  </p>

  <p>To enable scrobbling of a connected device go to Banshee's preferences, select the 
  <gui>Source Specific</gui> tab, select <gui>Last.fm</gui> from the dropdown, and press 
  the <gui>Enable Song Reporting From Device</gui> checkbox.  If you have an 
  active internet connection Banshee will, upon connection of your device, now attempt to gather 
  information regarding the songs that you have played since it was last connected.
  </p>

  <p>As with regular Banshee scrobbling submissions Last.fm will automatically update 
  your music metadata if any of your artist, title, or album information is incorrect (although we 
  again recommend that you use the Metadata Fixer extension to correct your files instead).
  </p>

  <p>Please note that currently Banshee only supports this feature with Apple products that are
  supported by the AppleDevice extension.
  </p>

  </section>
  
  <section id="lastfm-radio">
  <title>Listen to Last.fm Radio</title> 
  <p>Last.fm radio is free for residents of the United States, United Kingdom
  and Germany.  Residents of other countries will have to pay for a premium 
  account with Last.fm to listen to radio.  Premium members, in all countries,
  also receive premium radio features: listening to playlists and stations of 
  music you've loved or tagged.
  </p>
  
  <p>In Banshee's sources pane on the left hand side, you will now have a 
  Last.fm section, including your Last.fm radio stations.  You will need an
  active internet connection to listen to Last.fm radio.  Choose the radio
  station you wish to listen to and Banshee will communicate with Last.fm
  to populate songs for that radio station.  Press the <gui>Play</gui> button
  in Banshee or <key>Spacebar</key> to start streaming a Last.fm radio
  station.  You can also press the <gui>Next</gui> button in Banshee, 
  <key>N</key> or choose <guiseq><gui>Playback</gui><gui>Next</gui></guiseq>
  to play the next song in your radio station queue.
  </p>
  
  </section>
	
</page>
