id3mux

id3mux

Properties

gint v2-version Read / Write / Construct
gboolean write-v1 Read / Write / Construct
gboolean write-v2 Read / Write / Construct

Types and Values

struct GstId3Mux

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GstObject
            ╰── GstElement
                ╰── GstTagMux
                    ╰── GstId3Mux

Implemented Interfaces

GstId3Mux implements GstTagSetter.

Description

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

1
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.

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

Verify that tags have been written.

Synopsis

Element Information

plugin

id3tag

author

Michael Smith <msmith@songbirdnest.com>, Tim-Philipp Müller <tim centricular net>

class

Formatter/Metadata

Element Pads

name

sink

direction

sink

presence

always

details

ANY

name

src

direction

source

presence

always

details

application/x-id3

Functions

Types and Values

struct GstId3Mux

struct GstId3Mux;

Property Details

The “v2-version” property

  “v2-version”               gint

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

Flags: Read / Write / Construct

Allowed values: [3,4]

Default value: 3


The “write-v1” property

  “write-v1”                 gboolean

Write an id3v1 tag at the end of the file.

Flags: Read / Write / Construct

Default value: FALSE


The “write-v2” property

  “write-v2”                 gboolean

Write an id3v2 tag at the start of the file.

Flags: Read / Write / Construct

Default value: TRUE

See Also

GstID3Demux, GstTagSetter