.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "SCROBBLER-HELPER 1p" .TH SCROBBLER-HELPER 1p "2023-07-20" "perl v5.36.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" scrobbler\-helper \- submit a track to AudioScrobbler .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 2 \& scrobbler\-helper [\-nv] [\-e encoding] [\-f configfile] \-P progname \& \-V progver title artist album year comment genre length .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" The \fBscrobbler-helper\fR utility uses the \f(CW\*(C`Audio::Scrobbler\*(C'\fR 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. .PP The following command-line options are recognized: .IP "\-e encoding" 4 .IX Item "-e encoding" Specify the character encoding of the track info, if it is neither \s-1UTF\-8\s0 nor the one specified via \fBdefault_encoding\fR in the configuration file. .IP "\-f configfile" 4 .IX Item "-f configfile" Specify a different configuration file, not ~/.scrobbler\-helper.conf. .IP "\-n" 4 .IX Item "-n" Do not actually perform the handshake and submission (sets the \f(CW\*(C`Audio::Scrobbler\*(C'\fR \fB\*(L"fake\*(R"\fR option). .IP "\-P progname" 4 .IX Item "-P progname" Specify the name of the AudioScrobbler plug-in submitting the data. This option is \fBmandatory\fR! .IP "\-v" 4 .IX Item "-v" Verbose operation \- display diagnostic messages to the standard output (sets the \f(CW\*(C`Audio::Scrobbler\*(C'\fR \fB\*(L"verbose\*(R"\fR option). .IP "\-V progver" 4 .IX Item "-V progver" Specify the version of the AudioScrobbler plug-in submitting the data. This option is \fBmandatory\fR! .PP Besides the command line, the \fBscrobbler-helper\fR 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 \fB\*(L"global\*(R"\fR. The following variables are recognized, with \&\fBusername\fR and \fBpassword\fR being mandatory: .IP "\(bu" 4 default_encoding .Sp The encoding to assume for the track info, if none is supplied with the \fB\-e\fR command-line option. If neither \fB\-e\fR is given on the command line nor \fBdefault_encoding\fR specified in the configuration file, the \&\fBscrobbler-helper\fR utility assumes \s-1UTF\-8.\s0 .IP "\(bu" 4 fix_track_name .Sp A boolean flag specifying whether to do some trivial fixes on the song name before submitting it. Currently, this only removes a \*(L"\s-1DD. \*(R"\s0 sequence at the start of the name, where 'D' is a digit. .Sp The values \f(CW\*(C`on\*(C'\fR, \f(CW\*(C`true\*(C'\fR, \f(CW\*(C`yes\*(C'\fR, and \f(CW1\fR are considered to be true. .IP "\(bu" 4 password .Sp The password for the AudioScrobbler account. .IP "\(bu" 4 username .Sp The username for the AudioScrobbler account. .PP .Vb 7 \& [global] \& username=jrandomlistener \& password=mylittlesecret \& # Optional (the default is UTF\-8) \& default_encoding=windows\-1251 \& # Optional (the default is "no") \& fix_track_name=yes .Ve .SH "TODO" .IX Header "TODO" .IP "\(bu" 4 Command-line options, so people don't have to submit everything... .IP "\(bu" 4 Storing and caching of unsuccessful submissions for later retrying. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBAudio::Scrobbler\fR .IP "\(bu" 4 http://www.last.fm/ .IP "\(bu" 4 http://www.audioscrobbler.com/ .IP "\(bu" 4 http://www.audioscrobbler.net/ .PP The home site of the \f(CW\*(C`Audio::Scrobbler\*(C'\fR module is http://devel.ringlet.net/audio/Audio\-Scrobbler/ .SH "AUTHOR" .IX Header "AUTHOR" Peter Pentchev, .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" Copyright (C) 2005, 2006 by Peter Pentchev. .PP 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. .PP \&\f(CW$Id:\fR scrobbler-helper 88 2006\-01\-02 09:16:32Z roam $