# id3mux

This element adds ID3v2 tags to the beginning of a stream, and ID3v1 tags to the end.

It defaults to writing ID3 version 2.3.0 tags (since those are the most widely supported), but can optionally write version 2.4.0 tags.

Applications can set the tags to write using the GstTagSetter interface. Tags sent by upstream elements will be picked up automatically (and merged according to the merge mode set via the tag setter interface).

## Example pipelines

     gst-launch-1.0 -v filesrc location=foo.ogg ! decodebin ! audioconvert ! id3mux ! filesink location=foo.mp3

A pipeline that transcodes a file from Ogg/Vorbis to mp3 format with ID3 tags that contain the same metadata as the the Ogg/Vorbis file. Make sure the Ogg/Vorbis file actually has comments to preserve.

     gst-launch-1.0 -m filesrc location=foo.mp3 ! id3demux ! fakesink silent=TRUE

Verify that tags have been written.

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstTagMux
                        ╰──id3mux

## Implemented interfaces

    GstTagSetter

## Factory details

Authors: – Michael Smith <msmith>, Tim-Philipp Müller <tim centricular net></tim></msmith>

Classification: – `Formatter/Metadata`

Rank – primary

Plugin – id3tag

Package – GStreamer Bad Plug-ins

## Pad Templates

### `sink`

    ANY

Presence – always

Direction – sink

Object type – GstPad

### `src`

    application/x-id3:

Presence – always

Direction – src

Object type – GstPad

## Properties

### v2-version

    “v2-version” gint

Set version (3 for id3v2.3, 4 for id3v2.4) of id3v2 tags

Flags : Read / Write / Construct

Default value : 3

### write-v1

    “write-v1” gboolean

Write an id3v1 tag at the end of the file

Flags : Read / Write / Construct

Default value : false

### write-v2

    “write-v2” gboolean

Write an id3v2 tag at the start of the file

Flags : Read / Write / Construct

Default value : true

The results of the search are