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:
- * default_encoding
- The encoding to assume for the track info, if none is supplied with the
-e command-line option. If neither -e is given on the
command line nor default_encoding specified in the configuration
file, the scrobbler-helper utility assumes UTF-8.
- * fix_track_name
- A boolean flag specifying whether to do some trivial fixes on the song
name before submitting it. Currently, this only removes a "DD. "
sequence at the start of the name, where 'D' is a digit.
The values "on", "true", "yes", and 1 are
considered to be true.
- * password
- The password for the AudioScrobbler account.
- * username
- The username for the AudioScrobbler account.
[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¶
- •
- Command-line options, so people don't have to submit everything...
- •
- Storing and caching of unsuccessful submissions for later retrying.
SEE ALSO¶
Audio::Scrobbler
- * 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/
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 $