Peter Pentchev > Audio-Scrobbler-0.01 > scrobbler-helper

Download:
Audio-Scrobbler-0.01.tar.gz

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Source  

NAME ^

scrobbler-helper - submit a track to AudioScrobbler

SYNOPSIS ^

 scrobbler-helper [-nv] [-e encoding] [-f configfile] -P progname
   -V progver title artist album year comment genre length

DESCRIPTION ^

The scrobbler-helper utility uses the Audio::Scrobbler module to submit a single track's information to Last.fm's AudioScrobbler - http://www.audioscrobbler.com/. It requires the program (plug-in) name and version to be specified on the command line, and also requires all seven track attributes, although some of them may be omitted by supplying empty strings.

The following command-line options are recognized:

-e encoding

Specify the character encoding of the track info, if it is neither UTF-8 nor the one specified via default_encoding in the configuration file.

-f configfile

Specify a different configuration file, not ~/.scrobbler-helper.conf.

-n

Do not actually perform the handshake and submission (sets the Audio::Scrobbler "fake" option).

-P progname

Specify the name of the AudioScrobbler plug-in submitting the data. This option is mandatory!

-v

Verbose operation - display diagnostic messages to the standard output (sets the Audio::Scrobbler "verbose" option).

-V progver

Specify the version of the AudioScrobbler plug-in submitting the data. This option is mandatory!

Besides the command line, the scrobbler-helper utility also retrieves information from a per-user configuration file, usually ~/.scrobbler-helper.conf; it is a INI-style file, which must contain a secion named "global". The following variables are recognized, with username and password being mandatory:

  [global]
  username=jrandomlistener
  password=mylittlesecret
  # Optional (the default is UTF-8)
  default_encoding=windows-1251
  # Optional (the default is "no")
  fix_track_name=yes

TODO ^

SEE ALSO ^

Audio::Scrobbler

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

AUTHOR ^

Peter Pentchev, <roam@ringlet.net>

COPYRIGHT AND LICENSE ^

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-helper 88 2006-01-02 09:16:32Z roam $

syntax highlighting: