Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

id3_set_tag(3) [php man page]

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)

Check Out this Related Man Page

MP3TAG(1)						      General Commands Manual							 MP3TAG(1)

NAME

       mp3tag - view and manipulate ID3v1 tags.

SYNOPSIS

       mp3tag [ -s song ] [ -a artist ] [ -l album ] [ -y year ] [ -e comment ] [ -k track ] [ -g genre ] [ -r ] file [ file ... ]

DESCRIPTION

       This manual page briefly documents the mp3tag command. This manual page was written for the Debian GNU/Linux distribution because the orig-
       inal program does not have one.

       mp3tag is a program that allows you to both view and manipulate ID3v1 metadata tags. Running the command with just a filename will  display
       the file's current tag. Setting some options will cause the tag to be updated and displayed.

OPTIONS

       -a artist
	      Set the artist name to artist. Strings over thirty characters are truncated.

       -e comment
	      Set the comment to comment. Strings over thirty characters are truncated.

       -g genre
	      Set  the	genre to genre. This is a single integer with a value of 0 to 254 corresponding to the appropriate Winamp compatible genre
	      (use '-g list' to list all supported genres).

       -k track
	      Set the track number to track. This is a single integer with a value of 0 to 255. Specifying this field truncates the comment  field
	      to twenty-eight characters, as per the ID3v1.1 standard.

       -l album
	      Set the album name to album. Strings over thirty characters are truncated.

       -r     Merge new tag with any preexisting tag in the file.

       -s song
	      Set the song name to song. Strings over thirty characters are truncated.

       -y year
	      Set the year to year. Strings over four characters are truncated.

EXAMPLES

       Display foo.mp3's current ID3v1 info:

	      mp3tag foo.mp3

       Set foo.mp3's artist to 'Bar', and album to 'Baz':

	      mp3tag -a Bar -l Baz foo.mp3

       Set foo.mp3's year to 2001, merging it with any tag already present:

	      mp3tag -y 2001 -r foo.mp3

AUTHOR

       mp3tag was written by Bram Avontuur <bram@avontuur.org>.

       This manual page was written by Brian Boucheron <brian@boucheron.org>, for the Debian GNU/Linux distribution (but may be used by others).

SEE ALSO

       More info on ID3v1 can be found at <http://www.id3.org/id3v1.html>.

								 February 19, 2004							 MP3TAG(1)
Man Page