Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

scrobbler-helper(1p) [debian man page]

SCROBBLER-HELPER(1p)					User Contributed Perl Documentation				      SCROBBLER-HELPER(1p)

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 configura-
	   tion 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 ~/.scrob-
       bler-helper.conf; it is a INI-style file, which must contain a secion named "global".  The following variables are recognized, with user-
       name 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

       o   Command-line options, so people don't have to submit everything...

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

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

Check Out this Related Man Page

Audio::File(3pm)					User Contributed Perl Documentation					  Audio::File(3pm)

NAME

       Audio::File - Audio file abstraction library

SYNOPSIS

	 use Audio::File;
	 my $file = Audio::File->new( "foo.bar" );

	 print "The ". $file->type() ."-file ". $file->name
		       ." is ". int $file->audio_properties->length() ." seconds long.
";

	 print "It's interpreted by ". $file->tag->artist()
		       ." and called ". $file->tag->title() ".
";

DESCRIPTION

       Audio::File abstracts a single audio file, independant of its format. Using this module you can access a files meta-info like title, album,
       etc. as well as the files audio-properties like its length and bitrate.

       Currently only the formats flac, ogg vorbis and mp3 are supported, but support for other formats may be easily added.

METHODS

   new
	 $file = Audio::File->new( "foobar.flac" );

       Constructor. It takes the filename of the your audio file as its only argument and returns an instance of Audio::File::${Type} if the
       corresponding file type is supported. The file type will be determined using the file extension.  Currently flac, ogg and mp3 are supported
       but new formats may be added easily by creating a Audio::File::${Type} that inherits from Audio::File::Type, which is the base class for
       all file type classes.

       The methods and behaviour of the returned are documented in Audio::File::Type.

TODO

       o   Add possibility to change file and its tags.

       o   better (easier) interface?

       o   user shouldn't be forced to use Audio::File if he only want's the files tag or audio properties.

       o   Add possibility to access raw audio data (Audio::File::Data)

	   That could be done via Audio::Data or equivalent.

SEE ALSO

       Audio::File::Type, Audio::File::Tag, Audio::File::AudioProperties

AUTHOR

       Florian Ragwitz <flora@cpan.org>

COPYRIGHT AND LICENSE

       Copyright (C) 2004 Florian Ragwitz

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation,
       Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

perl v5.10.0							    2009-08-09							  Audio::File(3pm)
Man Page