====== lastfm2gmb Script ======
== Author/Maintainer ==
Author/Maintainer: Sergiy Borodych

== Short description ==
Script to import (sync) playcount, lastplay and rating from last.fm to gmusicbrowser.\\
tags - not realized yet, see [[https://github.com/bor/lastfm2gmb/blob/master/TODO|TODO]]

== Usage ==
gmusicbrowser must be running and the music files must be in its library.

$ lastfm2gmb.pl [-c] [-q|-d debuglevel] [-k api_key] -u lastfm_username

-c, --cache     - enable cache results enable cache results (only for 'playcount & lastplay' mode), //example: this can eat about ~8M for 160 weeks in tmp dir//\\
-d, --debug     - debug level (0..2), default 0\\
-k, --key       - lastfm api key, by default script using 'lastfm2gmb' user API key\\
-q, --quiet     - set debug to 0 and suppress any other output\\
-u, --user      - lastfm username

== Dependencies ==

perl v5.8 (for utf8 correct use)\\
LWP::UserAgent\\
Net::DBus\\
XML::Simple\\
gmusicbrowser (with Dbus implemented, tested on 1.0.X & 1.1.6)


== Installation ==
Just [[https://github.com/bor/lastfm2gmb|download]] and run
([[https://github.com/bor/lastfm2gmb/Changes|Changes]], [[https://github.com/bor/lastfm2gmb/TODO|TODO]], [[https://github.com/bor/lastfm2gmb/|Source]])

== Known Issues ==

  * Problem with duplicate track_title's in different albums - now it only skip these tracks
  * Dbus maybe failing to update values on high traffic (?) - so you may want run the script several times