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


Manual Reference Pages  -  SCROBBLER-HELPER (1)

.ds Aq ’

NAME

scrobbler-helper - submit a track to AudioScrobbler

CONTENTS

SYNOPSIS



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



DESCRIPTION

The <B>scrobbler-helperB> 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 <B>default_encodingB> 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 <B>fakeB> option).
-P progname Specify the name of the AudioScrobbler plug-in submitting the data. This option is <B>mandatoryB>!
-v Verbose operation - display diagnostic messages to the standard output (sets the Audio::Scrobbler <B>verboseB> option).
-V progver Specify the version of the AudioScrobbler plug-in submitting the data. This option is <B>mandatoryB>!
Besides the command line, the <B>scrobbler-helperB> 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 <B>globalB>. The following variables are recognized, with <B>usernameB> and <B>passwordB> being mandatory:
o default_encoding

The encoding to assume for the track info, if none is supplied with the <B>-eB> command-line option. If neither <B>-eB> is given on the command line nor <B>default_encodingB> specified in the configuration file, the <B>scrobbler-helperB> utility assumes UTF-8.

o 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.

o password

The password for the AudioScrobbler account.

o 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

o Command-line options, so people don’t have to submit everything...
o Storing and caching of unsuccessful submissions for later retrying.

SEE ALSO

<B>Audio::ScrobblerB>
o http://www.last.fm/
o http://www.audioscrobbler.com/
o 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 $

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


perl v5.20.3 SCROBBLER-HELPER (1) 2006-01-02

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