id3(1) [suse man page]

ID3(1)							      General Commands Manual							    ID3(1)

NAME

       id3 - an ID3 tag editor.

SYNOPSIS

       id3 [-tTaAycg newdata] file1 [file2 [file3...]]
       id3 -l file1 [file2 [file3...]]
       id3 -d file1 [file2 [file3...]]
       id3 -L

DESCRIPTION

       id3 is an ID3 v1.1 tag editor. ID3 tags are traditionally put at the end of compressed streamed audio files to denote information about the
       audio contents. Up to thirty characters of Title, Artist, and Album information can be stored, as well as  a  28-character  comment,  four-
       digit year, track number up to 255, and an enumerated genre.

OPTIONS

       -t title
	      Sets the title tag to the first 28 characters of title.

       -T track
	      Sets the track tag to a number between 0 and 255.

       -a artist
	      Sets the artist tag to the first 28 characters of artist.

       -A album
	      Sets the album tag to the first 28 characters of album.

       -y year
	      Sets the year tag to the first 4 characters of year.

       -c comment
	      Sets the comment tag to the first 28 characters of comment.

       -g genre
	      Sets the genre number tag using a genre number or predefined genre label.

       -l     List/view the ID3 tag.

       -L     List all genre tags.

       -R     Use rfc822-style output for tag printout.

       -d     Delete the ID3 tag.

BUGS

       The  ID3  format has some shortcomings. There is a 1 in 16777216 chance of your mp3 having a certain bit-pattern, causing id3 to write over
       the last 128 bytes of your mp3 upon tag creation. If you add a track number to an ID3 v1.0 tag, the last  two  characters  of  the  comment
       string will be truncated. Any bugs found in id3 should be forwarded to the author, Robert Woodcock <rcw@debian.org>.

																	    ID3(1)

ID3_SET_TAG(3)								 1							    ID3_SET_TAG(3)

id3_set_tag - Update information stored in an ID3 tag

SYNOPSIS

       bool id3_set_tag (string  $filename, array  $tag, [int  $version = ID3_V1_0])

DESCRIPTION

       id3_set_tag(3) is used to change the information stored of an ID3 tag. If no tag has been present, it will be added to the file.

PARAMETERS

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

	      o $tag
		- An associative array of tag keys and values  The following keys may be used in the associative array:

	      Keys in the associative array

	      +--------+--------------------------------------+---+
	      |  key   |				      |   |
	      |        |				      |   |
	      |        |	    possible value	      |   |
	      |        |				      |   |
	      |        |	 available in version	      |   |
	      |        |				      |   |
	      +--------+--------------------------------------+---+
	      | title  |				      |   |
	      |        |				      |   |
	      |        | string with maximum of 30 characters |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      |artist  |				      |   |
	      |        |				      |   |
	      |        | string with maximum of 30 characters |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      | album  |				      |   |
	      |        |				      |   |
	      |        | string with maximum of 30 characters |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      | year   |				      |   |
	      |        |				      |   |
	      |        |	       4 digits 	      |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      | genre  |				      |   |
	      |        |				      |   |
	      |        |   integer value between 0 and 147    |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      |comment |				      |   |
	      |        |				      |   |
	      |        | string with maximum of 30 characters |   |
	      |        | (28 in v1.1)			      |   |
	      |        |				      |   |
	      |        |	      v1.0, v1.1	      |   |
	      |        |				      |   |
	      | track  |				      |   |
	      |        |				      |   |
	      |        |      integer between 0 and 255       |   |
	      |        |				      |   |
	      |        |		 v1.1		      |   |
	      |        |				      |   |
	      +--------+--------------------------------------+---+
	      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

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      id3_set_tag(3) example

	      <?php
	      $data = array(
			    "title" => "Re:Start",
			    "artist" => "Re:Legion",
			    "comment" => "A nice track"
			   );
	      $result = id3_set_tag( "path/to/example.mp3", $data, ID3_V1_0 );
	      if ($result === true) {
		  echo "Tag successfully updated
";
	      }
	      ?>

	       If the file is writable, this will output:

	      Tag successfully updated

NOTES

       Note

	       Currently id3_set_tag(3) only supports version 1.0 and 1.1.

SEE ALSO

       id3_remove_tag(3), id3_get_tag(3), id3_get_version(3).

PHP Documentation Group 													    ID3_SET_TAG(3)