README

mafw-lastfm
-----------

mafw-lastfm is a small daemon that scrobbles your listening habits to last.fm.

setting up
----------

As of mafw-lastfm 0.0.2 a control panel applet for Maemo is available. In order
to set up mafw-lastfm, simply access Settings -> Last.fm settings.

Alternatively, you can create a file $HOME/.osso/mafw-lastfm with the
following contents:

       [Credentials]
       username=[your lastfm username]
       password=[a md5sum of your lastfm password]

For instance, for a user named 'jamesthehacker' with password 'james':

	[Credentials]
	username=jamesthehacker
	password=b4cc344d25a2efe540adbf2678e2304c

To generate the md5sum of your password, you can simply run

   $ echo -n password | md5sum


project page and source packages
--------------------------------

mafw-lastfm has a garage.maemo.org page, where you can find the latest releases:

  https://garage.maemo.org/projects/mafw-lastfm/

mailing list
------------

mfaw-lastfm development (and users, why not) mailing list is <mafw-lastfm-devel@garage.maemo.org>.
You can suscribe in

  https://garage.maemo.org/mailman/listinfo/mafw-lastfm-devel

bug reports
-----------

You can report bugs in

  https://bugs.maemo.org/enter_bug.cgi?product=mafw-lastfm

source code
-----------

The source code is kept in a gitorious project. The web interface is

    http://gitorious.org/mafw-lastfm

You can clone it from

    git clone git://gitorious.org/mafw-lastfm/mafw-lastfm.git


limitations
-----------

mafw-lastfm is in an early stage and has plenty of limitations:

- The daemon won't work properly behind a proxy.
- Libre.fm is not yet supported.

These features will come with time.

audioscrobbler
--------------

The audioscrobbler icon is part of the sources of the Last.fm player.