GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Audio::Scrobbler(3) User Contributed Perl Documentation Audio::Scrobbler(3)

Audio::Scrobbler - Perl interface to audioscrobbler.com/last.fm

  use Audio::Scrobbler;

  $scrob = new Audio::Scrobbler(cfg => { ... });

  $scrob->handshake();
  $scrob->submit(artist => "foo", album => "hello", track => "world",
    length => 180);

The "Audio::Scrobbler" module provides a Perl interface to the track submission API of Last.fm's AudioScrobbler - http://www.audioscrobbler.com/. So far, only track submissions are handled; the future plans include access to the various statistics.

The "Audio::Scrobbler" class defines the following methods:
  • new ( cfg => { ... } )

    Create a new "Audio::Scrobbler" object and initialize it with the provided configuration parameters. The parameters themselves are discussed in the description of the handshake and submit methods below.

  • err (message)

    Retrieves or sets the description of the last error encountered in the operation of this "Audio::Scrobbler" object.

  • handshake ()

    Perfors a handshake with the AudioScrobbler API via a request to http://post.audioscrobbler.com/.

    This method requires that the following configuration parameters be set:

  • progname

    The name of the program (or plug-in) performing the AudioScrobbler handshake.

  • progver

    The version of the program (or plug-in).

  • username

    The username of the user's AudioScrobbler registration.

If the handshake is successful, the method returns a true value, and the submit method may be invoked. Otherwise, an appropriate error message may be retrieved via the err method.

If the fake configuration parameter is set, the handshake method does not actually perform the handshake with the AudioScrobbler API, just simulates a successful handshake and returns a true value.

If the verbose configuration parameter is set, the handshake method reports its progress with diagnostic messages to the standard output.

submit ( info )

Submits a single track to the AudioScrobbler API. This method may only be invoked after a successful handshake. The track information is contained in the hash referenced by the info parameter; the following elements are used:

  • title

    The track's title.

  • artist

    The name of the artist performing the track.

  • length

    The duration of the track in seconds.

  • album

    The name of the album (optional).

Also, the submit method requires that the following configuration parameters be set for this "Audio::Scrobbler" object:

  • username

    The username of the user's AudioScrobbler registration.

  • password

    The password for the AudioScrobbler registration.

If the submission is successful, the method returns a true value. Otherwise, an appropriate error message may be retrieved via the err method.

If the fake configuration parameter is set, the submit method does not actually submit the track information to the AudioScrobbler API, just simulates a successful submission and returns a true value.

If the verbose configuration parameter is set, the submit method reports its progress with diagnostic messages to the standard output.

There are also several methods and functions for the module's internal use:

  • get_ua ()

    Creates or returns the cached "LWP::UserAgent" object used by the "Audio::Scrobbler" class for access to the AudioScrobbler API.

  • URLDecode (string)

    Decode a URL-encoded string.

    Obtained from http://glennf.com/writing/hexadecimal.url.encoding.html

  • URLEncode (string)

    Return the URL-encoded representation of a string.

    Obtained from http://glennf.com/writing/hexadecimal.url.encoding.html

  • Do something with UPDATE responses to the handshake.
  • Honor INTERVAL in some way.
  • Figure out a way to cache unsuccesful submissions for later retrying.
  • Web services - stats!

scrobbler-helper(1)
  • http://www.last.fm/
  • http://www.audioscrobbler.com/
  • http://www.audioscrobbler.net/

The home site of the "Audio::Scrobbler" module is http://devel.ringlet.net/audio/Audio-Scrobbler/

Peter Pentchev, <roam@ringlet.net>

Copyright (C) 2005, 2006 by Peter Pentchev.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.7 or, at your option, any later version of Perl 5 you may have available.

$Id: Scrobbler.pm 88 2006-01-02 09:16:32Z roam $

2006-01-02 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.