mp3diags(1) [debian man page]

MP3DIAGS(1)						      General Commands Manual						       MP3DIAGS(1)

NAME

       mp3diags - find issues in MP3 files

SYNOPSIS

       mp3diags

DESCRIPTION

       MP3  Diags is a simple graphical application that allows end-users to identify issues with their MP3 files, fix some of them and make other
       changes, like adding track information.

       It looks at both the audio part (VBR info, quality, normalization) and the tags containing track information (ID3).

       MP3 Diags provides a tag editor, which can download album information (including cover art) from MusicBrainz and Discogs, as well as  paste
       data  from  the clipboard, and a file renamer, which can rename groups of file automatically, based on their ID3 fields (artist, track num-
       ber, album, genre, etc).

       MP3 Diags has been written with QT4 libraries, and after the installation the application is available from the Applications menu.

AUTHOR

       mp3diags was written by Marian Ciobanu <ciobi@inbox.com>.

       This manual page was written by Alessio Treglia <quadrispro@ubuntu.com>, for the Ubuntu project (and may be used by others).

								   June 29, 2009						       MP3DIAGS(1)

ID3_GET_TAG(3)								 1							    ID3_GET_TAG(3)

id3_get_tag - Get all information stored in an ID3 tag

SYNOPSIS

       array id3_get_tag (string  $filename, [int  $version = ID3_BEST])

DESCRIPTION

       id3_get_tag(3) is used to get all information stored in the id3 tag of the specified file.

PARAMETERS

	      o $filename
		- The path to the MP3 file  Instead of a filename you may also pass a valid stream resource

	      o $version
		-  Allows you to specify the version of the tag as MP3 files may contain both, version 1.x and version 2.x tags  Since version 0.2
		id3_get_tag(3) also supports ID3 tags of version 2.2, 2.3 and 2.4. To extract information from these tags, pass one  of  the  con-
		stants ID3_V2_2, ID3_V2_3 or ID3_V2_4 as the second parameter. ID3 v2.x tags can contain a lot more information about the MP3 file
		than ID3 v1.x tags.

RETURN VALUES

	Returns an associative array with various keys like: title, artist, ..

	The key genre will contain an integer between 0 and 147. You may use id3_get_genre_name(3) to convert it to a human readable string.

EXAMPLES

       Example #1

	      id3_get_tag(3) example

	      <?php
	      $tag = id3_get_tag( "path/to/example.mp3" );
	      print_r($tag);
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [title] => DN-38416
		  [artist] => Re:Legion
		  [album] => Reflections
		  [year] => 2004
		  [genre] => 19
	      )

       Example #2

	      id3_get_tag(3) example

	      <?php
	      $tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 );
	      print_r($tag);
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [copyright] => Dirty Mac
		  [originalArtist] => Dirty Mac
		  [composer] => Marcus Gotze
		  [artist] => Dirty Mac
		  [title] => Little Big Man
		  [album] => Demo-Tape
		  [track] => 5/12
		  [genre] => (17)Rock
		  [year] => 2001
	      )

SEE ALSO

       id3_set_tag(3), id3_remove_tag(3), id3_get_version(3).

PHP Documentation Group 													    ID3_GET_TAG(3)