"Fossies" - the Fresh Open Source Software Archive
Member "ffmpeg-3.4.2/doc/metadata.texi" (31 Dec 2017, 2449 Bytes) of package /linux/misc/ffmpeg-3.4.2.tar.xz:
Caution: As a special service "Fossies" has tried to format the requested Texinfo source page into HTML format but that may be not always succeeeded perfectly.
Alternatively you can here view
the uninterpreted Texinfo source code.
A member file download can also be achieved by clicking within a package contents listing on the according byte size field.
FFmpeg is able to dump metadata from media files into a simple UTF-8-encoded
INI-like text file and then load it back using the metadata muxer/demuxer.
The file format is as follows:
A file consists of a header and a number of metadata tags divided into sections,
each on its own line.
The header is a ‘;FFMETADATA’ string, followed by a version number (now 1).
Metadata tags are of the form ‘key=value’
Immediately after header follows global metadata
After global metadata there may be sections with per-stream/per-chapter
A section starts with the section name in uppercase (i.e. STREAM or CHAPTER) in
brackets (‘[’, ‘]’) and ends with next section or end of file.
At the beginning of a chapter section there may be an optional timebase to be
used for start/end values. It must be in form
‘TIMEBASE=num/den’, where num and den are
integers. If the timebase is missing then start/end times are assumed to
be in milliseconds.
Next a chapter section must contain chapter start and end times in form
‘START=num’, ‘END=num’, where num is a positive
Empty lines and lines starting with ‘;’ or ‘#’ are ignored.
Metadata keys or values containing special characters (‘=’, ‘;’,
‘#’, ‘\’ and a newline) must be escaped with a backslash ‘\’.
Note that whitespace in metadata (e.g. ‘foo = bar’) is considered to be
a part of the tag (in the example above key is ‘foo ’, value is
A ffmetadata file might look like this:
;this is a comment
artist=FFmpeg troll team
#chapter ends at 0:01:00
By using the ffmetadata muxer and demuxer it is possible to extract
metadata from an input file to an ffmetadata file, and then transcode
the file into an output file with the edited ffmetadata file.
Extracting an ffmetadata file with ‘ffmpeg’ goes as follows:
ffmpeg -i INPUT -f ffmetadata FFMETADATAFILE
Reinserting edited metadata information from the FFMETADATAFILE file can
be done as:
ffmpeg -i INPUT -i FFMETADATAFILE -map_metadata 1 -codec copy OUTPUT
This document was generated on February 13, 2018 using texi2html.