mp3::tag::cue(3pm) [debian man page]

MP3::Tag::Cue(3pm)					User Contributed Perl Documentation					MP3::Tag::Cue(3pm)

NAME

       MP3::Tag::Cue - Module for parsing .cue files.

SYNOPSIS

	 my $db = MP3::Tag::Cue->new($filename, $track);       # Name of audio file
	 my $db = MP3::Tag::Cue->new_from($record, $track); # Contents of .cue file

	 ($title, $artist, $album, $year, $comment, $track) = $db->parse();

       see MP3::Tag

DESCRIPTION

       MP3::Tag::Cue is designed to be called from the MP3::Tag module.

       It parses the content of a .cue file.

       The .cue file is looked for in the same directory as audio file; one of the following conditions must be satisfied:

       o   The "audio" file is specified is actually a .cue file;

       o   There is exactly one .cue file in the directory of audio file;

       o   There is exactly one .cue file in the directory of audio file with basename which is a beginning of the name of audio file.

       o   There is exactly one .cue file in the directory of audio file with basename which matches (case-insensitive) a beginning of the name of
	   audio file.

       If no .cue file is found in the directory of audio file, the same process is repeated once one directory uplevel, with the name of the
       file's directory used instead of the file name.	E.g., with the files like this

	  Foo/bar.cue
	  Foo/bar/04.wav

       audio file Foo/bar/04.wav will be associated with Foo/bar.cue.

       parse()
	     ($title, $artist, $album, $year, $comment, $track) =
		$db->parse($what);

	   parse_filename() extracts information about artist, title, track number, album and year from the .cue file.	$what is optional; it
	   maybe title, track, artist, album, year, genre or comment. If $what is defined parse() will return only this element.

	   Additionally, $what can take values "artist_collection" (returns the value of artist in the whole-disk-info field "PERFORMER",
	   "songwriter".

       title()
	    $title = $db->title();

	   Returns the title, obtained from the 'Tracktitle' entry of the file.

       artist()
	    $artist = $db->artist();

	   Returns the artist name, obtained from the 'Performer' or 'Albumperformer' entries (the first which is present) of the file.

       track()
	    $track = $db->track();

	   Returns the track number, stored during object creation, or queried from the parent.

       year()
	    $year = $db->year();

	   Returns the year, obtained from the 'Year' entry of the file.  (Often not present.)

       album()
	    $album = $db->album();

	   Returns the album name, obtained from the 'Albumtitle' entry of the file.

       comment()
	    $comment = $db->comment();

	   Returns the 'REM COMMENT' entry of the file.  (Often not present.)

       genre()
	    $genre = $db->genre($filename);

perl v5.14.2							    2009-11-28							MP3::Tag::Cue(3pm)

TAGGREPPER(1)							   User Commands						     TAGGREPPER(1)

NAME

       taggrepper - search and match tags of media file for regular expressions

SYNOPSIS

       taggrepper [--tag-label regexp]... [--display-taglabel]... [FILE/DIRECTORY]...

DESCRIPTION

       Perform a regular expression search on the tags of specified media files.

       Mandatory  arguments  to  long options are mandatory for short options too. All regular expressions are Perl Compatible Regular expressions
       supported by the PCRE libraries. Note that all matches are ANDed, meaning that for a successful match, matches against all tags must occur.

       Support exists for MP3 files, and, if compiled in, for Ogg Vorbis and FLAC files as well.

       -t, --title=REGEXP
	      Match the title tag against REGEXP

       -a, --artist=REGEXP
	      Match the artist tag against REGEXP

       -l, --album=REGEXP
	      Match the album, tag against REGEXP

       -y, --year=REGEXP
	      Match the year tag against REGEXP

       -g, --genre=REGEXP
	      Match the genre tag against REGEXP

       -c, --comment=REGEXP
	      Match the comment tag against REGEXP

       --track=REGEXP
	      Match the track tag against REGEXP

       -c, --composer=REGEXP
	      Match the composer tag against REGEXP

       -o, --orig-artist=REGEXP
	      Match the original artist tag against REGEXP

       -c, --copyright=REGEXP
	      Match the copyright tag against REGEXP

       -u, --url=REGEXP
	      Match the URL tag against REGEXP

       -e, --encoded-by=REGEXP
	      Match the encoded-by tag against REGEXP

       --any-tag=REGEXP
	      Match the encoded-by tag against REGEXP.	Using this option makes every one of the above options to be ignored

       --display-title
	      display title tag of matching files

       --display-artist
	      display artist tag of matching files

       --display-album
	      display album tag of matching files

       --display-year
	      display year tag of matching files

       --display-genre
	      display genre tag of matching files

       --display-comment
	      display comment tag of matching files

       --display-track
	      display track tag of matching files

       --display-composer
	      display composer tag of matching files

       --display-orig-artist
	      display orig-artist tag of matching files

       --display-copyright
	      display copyright tag of matching files

       --display-url
	      display url tag of matching files

       --display-encoded-by
	      display encoded-by tag of matching files

       -0, --print0,
	      Use null character as delimiter. This option can be used with -0 option of xargs.

       -r, --recursive
	      Search directories recursively

       -v, --version
	      Display version and exit

       -h, --help
	      Display this help message

       All regular expressions are PCRE regular expressions.  Refer  to  the  PCRE  documentation  for	details.   Report  comments  and  bugs	to
       a.kumar@alumni.iitm.ac.in

COPYING

       Copyright (C) Kumar Appaiah

       License: BSD License (see COPYING file in the distribution tarball for details)

       This  program  is  free	software;  you	can  distribute  it  under  the  terms of the BSD License. See the file COPYING in the tarball, or
       /usr/share/common-licenses/BSD on Debian-based systems.

SEE ALSO

       pcre(3)

taggrepper 0.01 						     July 2009							     TAGGREPPER(1)