Legend

  • Element Name — The full name of the described element
  • L — The level within an EBML tree that the element may occur at. + is for a recursive level (can be its own child). g: global element (can be found at any level)
  • EBML ID — The Element ID displayed as octets
  • Ma — "mand." means that the element is mandatory and must be present if the parent element is present unless the element has a default value
  • Mu — "mult." means that the element may occur multiple times as a child of the same parent
  • Rng — Valid range of values to store in the element
  • Default — The default value of the element to use if the parent element is present but this element is not
  • T — The element's type, the form of data the element contains (m: master; b: binary; f: floating point number; u: unsigned integer; i: signed integer; 8: Unicode string; s: ASCII string; d: date & time)
  • 1, 2, 3, 4 — the Matroska specification versions this element is contained in (v4 is still work in progress; additions and changes are possible)
  • W — All elements available for use in WebM.
  • Description — A short description of the element's purpose.

Matroska v4 element specification

Note: this is Matroska version 4 generated from ebml_matroska.xml git revision 3e2aeab @ 2020-07-04 10:30:18 +0200

Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
EBMLMaxIDLength 1 0x42F2 mand. - 4 4 u * * * * *
EBMLMaxSizeLength 1 0x42F3 mand. - 1-8 8 u * * * * *
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Segment
Segment 0 0x18538067 mand. - - - m * * * * * The Root Element that contains all other Top-Level Elements (Elements defined only at Level 1). A Matroska file is composed of 1 Segment.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Meta Seek Information
SeekHead 1 0x114D9B74 - mult. - - m * * * * * Contains the Segment Position of other Top-Level Elements.
Seek 2 0x4DBB mand. mult. - - m * * * * * Contains a single seek entry to an EBML Element.
SeekID 3 0x53AB mand. - - - b * * * * * The binary ID corresponding to the Element name.
SeekPosition 3 0x53AC mand. - - - u * * * * * The Segment Position of the Element.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Segment Information
Info 1 0x1549A966 mand. mult. - - m * * * * * Contains general information about the Segment.
SegmentUID 2 0x73A4 - - not 0 - b * * * * A randomly generated unique ID to identify the Segment amongst many others (128 bits). If the Segment is a part of a Linked Segment then this Element is REQUIRED.
SegmentFilename 2 0x7384 - - - - 8 * * * * A filename corresponding to this Segment.
PrevUID 2 0x3CB923 - - - - b * * * * A unique ID to identify the previous Segment of a Linked Segment (128 bits). If the Segment is a part of a Linked Segment that uses Hard Linking then either the PrevUID or the NextUID Element is REQUIRED. If a Segment contains a PrevUID but not a NextUID then it MAY be considered as the last Segment of the Linked Segment. The PrevUID MUST NOT be equal to the SegmentUID.
PrevFilename 2 0x3C83AB - - - - 8 * * * * A filename corresponding to the file of the previous Linked Segment. Provision of the previous filename is for display convenience, but PrevUID SHOULD be considered authoritative for identifying the previous Segment in a Linked Segment.
NextUID 2 0x3EB923 - - - - b * * * * A unique ID to identify the next Segment of a Linked Segment (128 bits). If the Segment is a part of a Linked Segment that uses Hard Linking then either the PrevUID or the NextUID Element is REQUIRED. If a Segment contains a NextUID but not a PrevUID then it MAY be considered as the first Segment of the Linked Segment. The NextUID MUST NOT be equal to the SegmentUID.
NextFilename 2 0x3E83BB - - - - 8 * * * * A filename corresponding to the file of the next Linked Segment. Provision of the next filename is for display convenience, but NextUID SHOULD be considered authoritative for identifying the Next Segment.
SegmentFamily 2 0x4444 - mult. - - b * * * * A randomly generated unique ID that all Segments of a Linked Segment MUST share (128 bits). If the Segment is a part of a Linked Segment that uses Soft Linking then this Element is REQUIRED.
ChapterTranslate 2 0x6924 - mult. - - m * * * * A tuple of corresponding ID used by chapter codecs to represent this Segment.
ChapterTranslateEditionUID 3 0x69FC - mult. - - u * * * * Specify an edition UID on which this correspondence applies. When not specified, it means for all editions found in the Segment.
ChapterTranslateCodec 3 0x69BF mand. - - - u * * * * The chapter codec
0 - Matroska Script,
1 - DVD-menu
ChapterTranslateID 3 0x69A5 mand. - - - b * * * * The binary value used to represent this Segment in the chapter codec data. The format depends on the ChapProcessCodecID used.
TimestampScale 2 0x2AD7B1 mand. - not 0 1000000 u * * * * * Timestamp scale in nanoseconds (1.000.000 means all timestamps in the Segment are expressed in milliseconds).
Duration 2 0x4489 - - > 0.0 - f * * * * * Duration of the Segment in nanoseconds based on TimestampScale.
DateUTC 2 0x4461 - - - - d * * * * * The date and time that the Segment was created by the muxing application or library.
Title 2 0x7BA9 - - - - 8 * * * * * General name of the Segment.
MuxingApp 2 0x4D80 mand. - - - 8 * * * * * Muxing application or library (example: "libmatroska-0.4.3"). Include the full name of the application or library followed by the version number.
WritingApp 2 0x5741 mand. - - - 8 * * * * * Writing application (example: "mkvmerge-0.3.3"). Include the full name of the application followed by the version number.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Cluster
Cluster 1 0x1F43B675 - mult. - - m * * * * * The Top-Level Element containing the (monolithic) Block structure.
Timestamp 2 0xE7 mand. - - - u * * * * * Absolute timestamp of the cluster (based on TimestampScale).
SilentTracks 2 0x5854 - - - - m * * * * The list of tracks that are not used in that part of the stream. It is useful when using overlay tracks on seeking or to decide what track to use.
SilentTrackNumber 3 0x58D7 - mult. - - u * * * * One of the track number that are not used from now on in the stream. It could change later if not specified as silent in a further Cluster.
Position 2 0xA7 - - - - u * * * * The Segment Position of the Cluster in the Segment (0 in live streams). It might help to resynchronise offset on damaged streams.
PrevSize 2 0xAB - - - - u * * * * * Size of the previous Cluster, in octets. Can be useful for backward playing.
SimpleBlock 2 0xA3 - mult. - - b * * * * Similar to Block but without all the extra information, mostly used to reduced overhead when no extra feature is needed. (see SimpleBlock Structure)
BlockGroup 2 0xA0 - mult. - - m * * * * * Basic container of information containing a single Block and information specific to that Block.
Block 3 0xA1 mand. - - - b * * * * * Block containing the actual data to be rendered and a timestamp relative to the Cluster Timestamp. (see Block Structure)
BlockVirtual 3 0xA2 - - - - b A Block with no data. It MUST be stored in the stream at the place the real Block would be in display order. (see Block Virtual)
BlockAdditions 3 0x75A1 - - - - m * * * * * Contain additional blocks to complete the main one. An EBML parser that has no knowledge of the Block structure could still see and use/skip these data.
BlockMore 4 0xA6 mand. mult. - - m * * * * * Contain the BlockAdditional and some parameters.
BlockAddID 5 0xEE mand. - not 0 1 u * * * * * An ID to identify the BlockAdditional level. If BlockAddIDType of the corresponding block is 0, this value is also the value of BlockAddIDType for the meaning of the content of BlockAdditional.
BlockAdditional 5 0xA5 mand. - - - b * * * * * Interpreted by the codec as it wishes (using the BlockAddID).
BlockDuration 3 0x9B - - - [desc.] u * * * * * The duration of the Block (based on TimestampScale). The BlockDuration Element can be useful at the end of a Track to define the duration of the last frame (as there is no subsequent Block available), or when there is a break in a track like for subtitle tracks. When not written and with no DefaultDuration, the value is assumed to be the difference between the timestamp of this Block and the timestamp of the next Block in "display" order (not coding order). BlockDuration MUST be set if the associated TrackEntry stores a DefaultDuration value.
ReferencePriority 3 0xFA mand. - - 0 u * * * * This frame is referenced and has the specified cache priority. In cache only a frame of the same or higher priority can replace this frame. A value of 0 means the frame is not referenced.
ReferenceBlock 3 0xFB - mult. - - i * * * * * Timestamp of another frame used as a reference (ie: B or P frame). The timestamp is relative to the block it's attached to.
ReferenceVirtual 3 0xFD - - - - i The Segment Position of the data that would otherwise be in position of the virtual block.
CodecState 3 0xA4 - - - - b * * * The new codec state to use. Data interpretation is private to the codec. This information SHOULD always be referenced by a seek entry.
DiscardPadding 3 0x75A2 - - - - i * * Duration in nanoseconds of the silent data added to the Block (padding at the end of the Block for positive value, at the beginning of the Block for negative value). The duration of DiscardPadding is not calculated in the duration of the TrackEntry and SHOULD be discarded during playback.
Slices 3 0x8E - - - - m * * * * Contains slices description.
TimeSlice 4 0xE8 - mult. - - m * Contains extra time information about the data contained in the Block. Being able to interpret this Element is not REQUIRED for playback.
LaceNumber 5 0xCC - - - 0 u * The reverse number of the frame in the lace (0 is the last frame, 1 is the next to last, etc). Being able to interpret this Element is not REQUIRED for playback.
FrameNumber 5 0xCD - - - 0 u The number of the frame to generate from this lace with this delay (allow you to generate many frames from the same Block/Frame).
BlockAdditionID 5 0xCB - - - 0 u The ID of the BlockAdditional Element (0 is the main Block).
Delay 5 0xCE - - - 0 u The (scaled) delay to apply to the Element.
SliceDuration 5 0xCF - - - 0 u The (scaled) duration to apply to the Element.
ReferenceFrame 3 0xC8 - - - - m DivX trick track extensions
ReferenceOffset 4 0xC9 mand. - - - u DivX trick track extensions
ReferenceTimestamp 4 0xCA mand. - - - u DivX trick track extensions
EncryptedBlock 2 0xAF - mult. - - b Similar to SimpleBlock but the data inside the Block are Transformed (encrypt and/or signed).
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Track
Tracks 1 0x1654AE6B - mult. - - m * * * * * A Top-Level Element of information with many tracks described.
TrackEntry 2 0xAE mand. mult. - - m * * * * * Describes a track with all Elements.
TrackNumber 3 0xD7 mand. - not 0 - u * * * * * The track number as used in the Block Header (using more than 127 tracks is not encouraged, though the design allows an unlimited number).
TrackUID 3 0x73C5 mand. - not 0 - u * * * * * A unique ID to identify the Track. This SHOULD be kept the same when making a direct stream copy of the Track to another file.
TrackType 3 0x83 mand. - 1-254 - u * * * * * A set of track types coded on 8 bits.
1 - video,
2 - audio,
3 - complex,
16 - logo,
17 - subtitle,
18 - buttons,
32 - control,
33 - metadata
FlagEnabled 3 0xB9 mand. - 0-1 1 u * * * * Set if the track is usable. (1 bit)
FlagDefault 3 0x88 mand. - 0-1 1 u * * * * * Set if that track (audio, video or subs) SHOULD be active if no language found matches the user preference. (1 bit)
FlagForced 3 0x55AA mand. - 0-1 0 u * * * * * Set if that track MUST be active during playback. There can be many forced track for a kind (audio, video or subs), the player SHOULD select the one which language matches the user preference or the default + forced track. Overlay MAY happen between a forced and non-forced track of the same kind. (1 bit)
FlagLacing 3 0x9C mand. - 0-1 1 u * * * * * Set if the track MAY contain blocks using lacing. (1 bit)
MinCache 3 0x6DE7 mand. - - 0 u * * * * The minimum number of frames a player SHOULD be able to cache during playback. If set to 0, the reference pseudo-cache system is not used.
MaxCache 3 0x6DF8 - - - - u * * * * The maximum cache size necessary to store referenced frames in and the current frame. 0 means no cache is needed.
DefaultDuration 3 0x23E383 - - not 0 - u * * * * * Number of nanoseconds (not scaled via TimestampScale) per frame ('frame' in the Matroska sense -- one Element put into a (Simple)Block).
DefaultDecodedFieldDuration 3 0x234E7A - - not 0 - u * The period in nanoseconds (not scaled by TimestampScale) between two successive fields at the output of the decoding process (see the notes)
TrackTimestampScale 3 0x23314F mand. - > 0.0 1.0 f * * * DEPRECATED, DO NOT USE. The scale to apply on this track to work at normal speed in relation with other tracks (mostly used to adjust video speed when the audio length differs).
TrackOffset 3 0x537F - - - 0 i A value to add to the Block's Timestamp. This can be used to adjust the playback offset of a track.
MaxBlockAdditionID 3 0x55EE mand. - - 0 u * * * * The maximum value of BlockAddID. A value 0 means there is no BlockAdditions for this track.
BlockAdditionMapping 3 0x41E4 - mult. - - m * Contains elements that extend the track format, by adding content either to each frame (with BlockAddID) or to the track as a whole (with BlockAddIDExtraData)
BlockAddIDValue 4 0x41F0 - - >=2 - u * If the track format extension needs content beside frames, the value refers to the BlockAddID value being described. To keep MaxBlockAdditionID as low as possible, small values SHOULD be used.
BlockAddIDName 4 0x41A4 - - - - s * A human-friendly name describing the type of BlockAdditional data as defined by the associated Block Additional Mapping.
BlockAddIDType 4 0x41E7 mand. - - 0 u * Stores the registered identifer of the Block Additional Mapping to define how the BlockAdditional data should be handled.
BlockAddIDExtraData 4 0x41ED - - - - b * Extra binary data that the BlockAddIDType can use to interpret the BlockAdditional data. The intepretation of the binary data depends on the BlockAddIDType value and the corresponding Block Additional Mapping.
Name 3 0x536E - - - - 8 * * * * * A human-readable track name.
Language 3 0x22B59C - - - eng s * * * * * Specifies the language of the track in the Matroska languages form. This Element MUST be ignored if the LanguageIETF Element is used in the same TrackEntry.
LanguageIETF 3 0x22B59D - - - - s * Specifies the language of the track according to BCP 47 and using the IANA Language Subtag Registry. If this Element is used, then any Language Elements used in the same TrackEntry MUST be ignored.
CodecID 3 0x86 mand. - - - s * * * * * An ID corresponding to the codec, see the codec page for more info.
CodecPrivate 3 0x63A2 - - - - b * * * * * Private data only known to the codec.
CodecName 3 0x258688 - - - - 8 * * * * * A human-readable string specifying the codec.
CodecSettings 3 0x3A9697 - - - - 8 A string describing the encoding setting used.
CodecInfoURL 3 0x3B4040 - mult. - - s A URL to find information about the codec used.
CodecDownloadURL 3 0x26B240 - mult. - - s A URL to download about the codec used.
CodecDecodeAll 3 0xAA mand. - 0-1 1 u * * * The codec can decode potentially damaged data (1 bit).
TrackOverlay 3 0x6FAB - mult. - - u * * * * Specify that this track is an overlay track for the Track specified (in the u-integer). That means when this track has a gap (see SilentTracks) the overlay track SHOULD be used instead. The order of multiple TrackOverlay matters, the first one is the one that SHOULD be used. If not found it SHOULD be the second, etc.
CodecDelay 3 0x56AA - - - 0 u * * CodecDelay is The codec-built-in delay in nanoseconds. This value MUST be subtracted from each block timestamp in order to get the actual timestamp. The value SHOULD be small so the muxing of tracks with the same actual timestamp are in the same Cluster.
SeekPreRoll 3 0x56BB mand. - - 0 u * * After a discontinuity, SeekPreRoll is the duration in nanoseconds of the data the decoder MUST decode before the decoded data is valid.
TrackTranslate 3 0x6624 - mult. - - m * * * * The track identification for the given Chapter Codec.
TrackTranslateEditionUID 4 0x66FC - mult. - - u * * * * Specify an edition UID on which this translation applies. When not specified, it means for all editions found in the Segment.
TrackTranslateCodec 4 0x66BF mand. - - - u * * * * The chapter codec.
0 - Matroska Script,
1 - DVD-menu
TrackTranslateTrackID 4 0x66A5 mand. - - - b * * * * The binary value used to represent this track in the chapter codec data. The format depends on the ChapProcessCodecID used.
Video 3 0xE0 - - - - m * * * * * Video settings.
FlagInterlaced 4 0x9A mand. - 0-2 0 u * * * * A flag to declare if the video is known to be progressive or interlaced and if applicable to declare details about the interlacement.
0 - undetermined,
1 - interlaced,
2 - progressive
FieldOrder 4 0x9D mand. - 0-14 2 u * Declare the field ordering of the video. If FlagInterlaced is not set to 1, this Element MUST be ignored.
0 - progressive,
1 - tff,
2 - undetermined,
6 - bff,
9 - bff(swapped),
14 - tff(swapped)
StereoMode 4 0x53B8 - - - 0 u * * * Stereo-3D video mode. There are some more details on 3D support in the Specification Notes.
0 - mono,
1 - side by side (left eye first),
2 - top - bottom (right eye is first),
3 - top - bottom (left eye is first),
4 - checkboard (right eye is first),
5 - checkboard (left eye is first),
6 - row interleaved (right eye is first),
7 - row interleaved (left eye is first),
8 - column interleaved (right eye is first),
9 - column interleaved (left eye is first),
10 - anaglyph (cyan/red),
11 - side by side (right eye first),
12 - anaglyph (green/magenta),
13 - both eyes laced in one Block (left eye is first),
14 - both eyes laced in one Block (right eye is first)
AlphaMode 4 0x53C0 - - - 0 u * * * Alpha Video Mode. Presence of this Element indicates that the BlockAdditional Element could contain Alpha data.
OldStereoMode 4 0x53B9 - - - - u DEPRECATED, DO NOT USE. Bogus StereoMode value used in old versions of libmatroska.
0 - mono,
1 - right eye,
2 - left eye,
3 - both eyes
PixelWidth 4 0xB0 mand. - not 0 - u * * * * * Width of the encoded video frames in pixels.
PixelHeight 4 0xBA mand. - not 0 - u * * * * * Height of the encoded video frames in pixels.
PixelCropBottom 4 0x54AA - - - 0 u * * * * * The number of video pixels to remove at the bottom of the image.
PixelCropTop 4 0x54BB - - - 0 u * * * * * The number of video pixels to remove at the top of the image.
PixelCropLeft 4 0x54CC - - - 0 u * * * * * The number of video pixels to remove on the left of the image.
PixelCropRight 4 0x54DD - - - 0 u * * * * * The number of video pixels to remove on the right of the image.
DisplayWidth 4 0x54B0 - - not 0 [desc.] u * * * * * Width of the video frames to display. Applies to the video frame after cropping (PixelCrop* Elements). If the DisplayUnit of the same TrackEntry is 0, then the default value for DisplayWidth is equal to PixelWidth - PixelCropLeft - PixelCropRight, else there is no default value.
DisplayHeight 4 0x54BA - - not 0 [desc.] u * * * * * Height of the video frames to display. Applies to the video frame after cropping (PixelCrop* Elements). If the DisplayUnit of the same TrackEntry is 0, then the default value for DisplayHeight is equal to PixelHeight - PixelCropTop - PixelCropBottom, else there is no default value.
DisplayUnit 4 0x54B2 - - - 0 u * * * * * How DisplayWidth & DisplayHeight are interpreted.
0 - pixels,
1 - centimeters,
2 - inches,
3 - display aspect ratio,
4 - unknown
AspectRatioType 4 0x54B3 - - - 0 u * * * * * Specify the possible modifications to the aspect ratio.
0 - free resizing,
1 - keep aspect ratio,
2 - fixed
ColourSpace 4 0x2EB524 - - - - b * * * * Specify the pixel format used for the Track's data as a FourCC. This value is similar in scope to the biCompression value of AVI's BITMAPINFOHEADER. ColourSpace MUST be set in TrackEntry when the CodecID Element of the TrackEntry is set to "V_UNCOMPRESSED".
GammaValue 4 0x2FB523 - - > 0.0 - f Gamma Value.
FrameRate 4 0x2383E3 - - > 0.0 - f Number of frames per second. Informational only.
Colour 4 0x55B0 - - - - m * Settings describing the colour format.
MatrixCoefficients 5 0x55B1 - - - 2 u * The Matrix Coefficients of the video used to derive luma and chroma values from red, green, and blue color primaries. For clarity, the value and meanings for MatrixCoefficients are adopted from Table 4 of ISO/IEC 23001-8:2016 or ITU-T H.273.
0 - Identity,
1 - ITU-R BT.709,
2 - unspecified,
3 - reserved,
4 - US FCC 73.682,
5 - ITU-R BT.470BG,
6 - SMPTE 170M,
7 - SMPTE 240M,
8 - YCoCg,
9 - BT2020 Non-constant Luminance,
10 - BT2020 Constant Luminance,
11 - SMPTE ST 2085,
12 - Chroma-derived Non-constant Luminance,
13 - Chroma-derived Constant Luminance,
14 - ITU-R BT.2100-0
BitsPerChannel 5 0x55B2 - - - 0 u * Number of decoded bits per channel. A value of 0 indicates that the BitsPerChannel is unspecified.
ChromaSubsamplingHorz 5 0x55B3 - - - - u * The amount of pixels to remove in the Cr and Cb channels for every pixel not removed horizontally. Example: For video with 4:2:0 chroma subsampling, the ChromaSubsamplingHorz SHOULD be set to 1.
ChromaSubsamplingVert 5 0x55B4 - - - - u * The amount of pixels to remove in the Cr and Cb channels for every pixel not removed vertically. Example: For video with 4:2:0 chroma subsampling, the ChromaSubsamplingVert SHOULD be set to 1.
CbSubsamplingHorz 5 0x55B5 - - - - u * The amount of pixels to remove in the Cb channel for every pixel not removed horizontally. This is additive with ChromaSubsamplingHorz. Example: For video with 4:2:1 chroma subsampling, the ChromaSubsamplingHorz SHOULD be set to 1 and CbSubsamplingHorz SHOULD be set to 1.
CbSubsamplingVert 5 0x55B6 - - - - u * The amount of pixels to remove in the Cb channel for every pixel not removed vertically. This is additive with ChromaSubsamplingVert.
ChromaSitingHorz 5 0x55B7 - - - 0 u * How chroma is subsampled horizontally.
0 - unspecified,
1 - left collocated,
2 - half
ChromaSitingVert 5 0x55B8 - - - 0 u * How chroma is subsampled vertically.
0 - unspecified,
1 - top collocated,
2 - half
Range 5 0x55B9 - - - 0 u * Clipping of the color ranges.
0 - unspecified,
1 - broadcast range,
2 - full range (no clipping),
3 - defined by MatrixCoefficients / TransferCharacteristics
TransferCharacteristics 5 0x55BA - - - 2 u * The transfer characteristics of the video. For clarity, the value and meanings for TransferCharacteristics are adopted from Table 3 of ISO/IEC 23091-4 or ITU-T H.273.
0 - reserved,
1 - ITU-R BT.709,
2 - unspecified,
3 - reserved,
4 - Gamma 2.2 curve - BT.470M,
5 - Gamma 2.8 curve - BT.470BG,
6 - SMPTE 170M,
7 - SMPTE 240M,
8 - Linear,
9 - Log,
10 - Log Sqrt,
11 - IEC 61966-2-4,
12 - ITU-R BT.1361 Extended Colour Gamut,
13 - IEC 61966-2-1,
14 - ITU-R BT.2020 10 bit,
15 - ITU-R BT.2020 12 bit,
16 - ITU-R BT.2100 Perceptual Quantization,
17 - SMPTE ST 428-1,
18 - ARIB STD-B67 (HLG)
Primaries 5 0x55BB - - - 2 u * The colour primaries of the video. For clarity, the value and meanings for Primaries are adopted from Table 2 of ISO/IEC 23091-4 or ITU-T H.273.
0 - reserved,
1 - ITU-R BT.709,
2 - unspecified,
3 - reserved,
4 - ITU-R BT.470M,
5 - ITU-R BT.470BG - BT.601 625,
6 - ITU-R BT.601 525 - SMPTE 170M,
7 - SMPTE 240M,
8 - FILM,
9 - ITU-R BT.2020,
10 - SMPTE ST 428-1,
11 - SMPTE RP 432-2,
12 - SMPTE EG 432-2,
22 - EBU Tech. 3213-E - JEDEC P22 phosphors
MaxCLL 5 0x55BC - - - - u * Maximum brightness of a single pixel (Maximum Content Light Level) in candelas per square meter (cd/m²).
MaxFALL 5 0x55BD - - - - u * Maximum brightness of a single full frame (Maximum Frame-Average Light Level) in candelas per square meter (cd/m²).
MasteringMetadata 5 0x55D0 - - - - m * SMPTE 2086 mastering data.
PrimaryRChromaticityX 6 0x55D1 - - 0-1 - f * Red X chromaticity coordinate as defined by CIE 1931.
PrimaryRChromaticityY 6 0x55D2 - - 0-1 - f * Red Y chromaticity coordinate as defined by CIE 1931.
PrimaryGChromaticityX 6 0x55D3 - - 0-1 - f * Green X chromaticity coordinate as defined by CIE 1931.
PrimaryGChromaticityY 6 0x55D4 - - 0-1 - f * Green Y chromaticity coordinate as defined by CIE 1931.
PrimaryBChromaticityX 6 0x55D5 - - 0-1 - f * Blue X chromaticity coordinate as defined by CIE 1931.
PrimaryBChromaticityY 6 0x55D6 - - 0-1 - f * Blue Y chromaticity coordinate as defined by CIE 1931.
WhitePointChromaticityX 6 0x55D7 - - 0-1 - f * White X chromaticity coordinate as defined by CIE 1931.
WhitePointChromaticityY 6 0x55D8 - - 0-1 - f * White Y chromaticity coordinate as defined by CIE 1931.
LuminanceMax 6 0x55D9 - - >= 0.0 - f * Maximum luminance. Represented in candelas per square meter (cd/m²).
LuminanceMin 6 0x55DA - - >= 0.0 - f * Minimum luminance. Represented in candelas per square meter (cd/m²).
Projection 4 0x7670 - - - - m * * Describes the video projection details. Used to render spherical and VR videos.
ProjectionType 5 0x7671 mand. - 0-3 0 u * * Describes the projection used for this video track.
0 - rectangular,
1 - equirectangular,
2 - cubemap,
3 - mesh
ProjectionPrivate 5 0x7672 - - - - b * * Private data that only applies to a specific projection.
Semantics
If ProjectionType equals 0 (Rectangular), then this element must not be present.
If ProjectionType equals 1 (Equirectangular), then this element must be present and contain the same binary data that would be stored inside an ISOBMFF Equirectangular Projection Box ('equi').
If ProjectionType equals 2 (Cubemap), then this element must be present and contain the same binary data that would be stored inside an ISOBMFF Cubemap Projection Box ('cbmp').
If ProjectionType equals 3 (Mesh), then this element must be present and contain the same binary data that would be stored inside an ISOBMFF Mesh Projection Box ('mshp').
Note: ISOBMFF box size and fourcc fields are not included in the binary data, but the FullBox version and flag fields are. This is to avoid redundant framing information while preserving versioning and semantics between the two container formats.
ProjectionPoseYaw 5 0x7673 mand. - - 0.0 f * * Specifies a yaw rotation to the projection.
Semantics
Value represents a clockwise rotation, in degrees, around the up vector. This rotation must be applied before any ProjectionPosePitch or ProjectionPoseRoll rotations. The value of this field should be in the -180 to 180 degree range.
ProjectionPosePitch 5 0x7674 mand. - - 0.0 f * * Specifies a pitch rotation to the projection.
Semantics
Value represents a counter-clockwise rotation, in degrees, around the right vector. This rotation must be applied after the ProjectionPoseYaw rotation and before the ProjectionPoseRoll rotation. The value of this field should be in the -90 to 90 degree range.
ProjectionPoseRoll 5 0x7675 mand. - - 0.0 f * * Specifies a roll rotation to the projection.
Semantics
Value represents a counter-clockwise rotation, in degrees, around the forward vector. This rotation must be applied after the ProjectionPoseYaw and ProjectionPosePitch rotations. The value of this field should be in the -180 to 180 degree range.
Audio 3 0xE1 - - - - m * * * * * Audio settings.
SamplingFrequency 4 0xB5 mand. - > 0.0 8000.0 f * * * * * Sampling frequency in Hz.
OutputSamplingFrequency 4 0x78B5 - - > 0.0 [desc.] f * * * * * Real output sampling frequency in Hz (used for SBR techniques). The default value for OutputSamplingFrequency of the same TrackEntry is equal to the SamplingFrequency.
Channels 4 0x9F mand. - not 0 1 u * * * * * Numbers of channels in the track.
ChannelPositions 4 0x7D7B - - - - b Table of horizontal angles for each successive channel.
BitDepth 4 0x6264 - - not 0 - u * * * * * Bits per sample, mostly used for PCM.
TrackOperation 3 0xE2 - - - - m * * Operation that needs to be applied on tracks to create this virtual track. For more details look at the Specification Notes on the subject.
TrackCombinePlanes 4 0xE3 - - - - m * * Contains the list of all video plane tracks that need to be combined to create this 3D track
TrackPlane 5 0xE4 mand. mult. - - m * * Contains a video plane track that need to be combined to create this 3D track
TrackPlaneUID 6 0xE5 mand. - not 0 - u * * The trackUID number of the track representing the plane.
TrackPlaneType 6 0xE6 mand. - - - u * * The kind of plane this track corresponds to.
0 - left eye,
1 - right eye,
2 - background
TrackJoinBlocks 4 0xE9 - - - - m * * Contains the list of all tracks whose Blocks need to be combined to create this virtual track
TrackJoinUID 5 0xED mand. mult. not 0 - u * * The trackUID number of a track whose blocks are used to create this virtual track.
TrickTrackUID 3 0xC0 - - - - u DivX trick track extensions
TrickTrackSegmentUID 3 0xC1 - - - - b DivX trick track extensions
TrickTrackFlag 3 0xC6 - - - 0 u DivX trick track extensions
TrickMasterTrackUID 3 0xC7 - - - - u DivX trick track extensions
TrickMasterTrackSegmentUID 3 0xC4 - - - - b DivX trick track extensions
ContentEncodings 3 0x6D80 - - - - m * * * * * Settings for several content encoding mechanisms like compression or encryption.
ContentEncoding 4 0x6240 mand. mult. - - m * * * * * Settings for one content encoding like compression or encryption.
ContentEncodingOrder 5 0x5031 mand. - - 0 u * * * * * Tells when this modification was used during encoding/muxing starting with 0 and counting upwards. The decoder/demuxer has to start with the highest order number it finds and work its way down. This value has to be unique over all ContentEncodingOrder Elements in the TrackEntry that contains this ContentEncodingOrder element.
ContentEncodingScope 5 0x5032 mand. - not 0 1 u * * * * * A bit field that describes which Elements have been modified in this way. Values (big endian) can be OR'ed.
1 - All frame contents, excluding lacing data,
2 - The track's private data,
4 - The next ContentEncoding (next ContentEncodingOrder. Either the data inside ContentCompression and/or ContentEncryption)
ContentEncodingType 5 0x5033 mand. - - 0 u * * * * * A value describing what kind of transformation is applied.
0 - Compression,
1 - Encryption
ContentCompression 5 0x5034 - - - - m * * * * Settings describing the compression used. This Element MUST be present if the value of ContentEncodingType is 0 and absent otherwise. Each block MUST be decompressable even if no previous block is available in order not to prevent seeking.
ContentCompAlgo 6 0x4254 mand. - - 0 u * * * * The compression algorithm used.
0 - zlib,
1 - bzlib,
2 - lzo1x,
3 - Header Stripping
ContentCompSettings 6 0x4255 - - - - b * * * * Settings that might be needed by the decompressor. For Header Stripping (ContentCompAlgo=3), the bytes that were removed from the beginning of each frames of the track.
ContentEncryption 5 0x5035 - - - - m * * * * * Settings describing the encryption used. This Element MUST be present if the value of ContentEncodingType is 1 (encryption) and MUST be ignored otherwise.
ContentEncAlgo 6 0x47E1 mand. - - 0 u * * * * * The encryption algorithm used. The value '0' means that the contents have not been encrypted but only signed.
0 - Not encrypted,
1 - DES - FIPS 46-3,
2 - Triple DES - RFC 1851,
3 - Twofish,
4 - Blowfish,
5 - AES - FIPS 187
ContentEncKeyID 6 0x47E2 - - - - b * * * * * For public key algorithms this is the ID of the public key the the data was encrypted with.
ContentEncAESSettings 6 0x47E7 - - - - m * * Settings describing the encryption algorithm used. If ContentEncAlgo != 5 this MUST be ignored.
AESSettingsCipherMode 7 0x47E8 mand. - - - u * * The AES cipher mode used in the encryption.
1 - AES-CTR / Counter, NIST SP 800-38A,
2 - AES-CBC / Cipher Block Chaining, NIST SP 800-38A
ContentSignature 6 0x47E3 - - - - b * * * * A cryptographic signature of the contents.
ContentSigKeyID 6 0x47E4 - - - - b * * * * This is the ID of the private key the data was signed with.
ContentSigAlgo 6 0x47E5 - - - 0 u * * * * The algorithm used for the signature.
0 - Not signed,
1 - RSA
ContentSigHashAlgo 6 0x47E6 - - - 0 u * * * * The hash algorithm used for the signature.
0 - Not signed,
1 - SHA1-160,
2 - MD5
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Cueing Data
Cues 1 0x1C53BB6B - - - - m * * * * * A Top-Level Element to speed seeking access. All entries are local to the Segment. This Element SHOULD be set when the Segment is not transmitted as a live stream (see #livestreaming).
CuePoint 2 0xBB mand. mult. - - m * * * * * Contains all information relative to a seek point in the Segment.
CueTime 3 0xB3 mand. - - - u * * * * * Absolute timestamp according to the Segment time base.
CueTrackPositions 3 0xB7 mand. mult. - - m * * * * * Contain positions for different tracks corresponding to the timestamp.
CueTrack 4 0xF7 mand. - not 0 - u * * * * * The track for which a position is given.
CueClusterPosition 4 0xF1 mand. - - - u * * * * * The Segment Position of the Cluster containing the associated Block.
CueRelativePosition 4 0xF0 - - - - u * * The relative position inside the Cluster of the referenced SimpleBlock or BlockGroup with 0 being the first possible position for an Element inside that Cluster.
CueDuration 4 0xB2 - - - - u * * The duration of the block according to the Segment time base. If missing the track's DefaultDuration does not apply and no duration information is available in terms of the cues.
CueBlockNumber 4 0x5378 - - not 0 1 u * * * * * Number of the Block in the specified Cluster.
CueCodecState 4 0xEA - - - 0 u * * * The Segment Position of the Codec State corresponding to this Cue Element. 0 means that the data is taken from the initial Track Entry.
CueReference 4 0xDB - mult. - - m * * * The Clusters containing the referenced Blocks.
CueRefTime 5 0x96 mand. - - - u * * * Timestamp of the referenced Block.
CueRefCluster 5 0x97 mand. - - - u The Segment Position of the Cluster containing the referenced Block.
CueRefNumber 5 0x535F - - not 0 1 u Number of the referenced Block of Track X in the specified Cluster.
CueRefCodecState 5 0xEB - - - 0 u The Segment Position of the Codec State corresponding to this referenced Element. 0 means that the data is taken from the initial Track Entry.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Attachment
Attachments 1 0x1941A469 - - - - m * * * * Contain attached files.
AttachedFile 2 0x61A7 mand. mult. - - m * * * * An attached file.
FileDescription 3 0x467E - - - - 8 * * * * A human-friendly name for the attached file.
FileName 3 0x466E mand. - - - 8 * * * * Filename of the attached file.
FileMimeType 3 0x4660 mand. - - - s * * * * MIME type of the file.
FileData 3 0x465C mand. - - - b * * * * The data of the file.
FileUID 3 0x46AE mand. - not 0 - u * * * * Unique ID representing the file, as random as possible.
FileReferral 3 0x4675 - - - - b A binary value that a track/codec can refer to when the attachment is needed.
FileUsedStartTime 3 0x4661 - - - - u DivX font extension
FileUsedEndTime 3 0x4662 - - - - u DivX font extension
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Chapters
Chapters 1 0x1043A770 - - - - m * * * * * A system to define basic menus and partition data. For more detailed information, look at the Chapters Explanation.
EditionEntry 2 0x45B9 mand. mult. - - m * * * * * Contains all information about a Segment edition.
EditionUID 3 0x45BC - - not 0 - u * * * * A unique ID to identify the edition. It's useful for tagging an edition.
EditionFlagHidden 3 0x45BD mand. - 0-1 0 u * * * * If an edition is hidden (1), it SHOULD NOT be available to the user interface (but still to Control Tracks; see flag notes). (1 bit)
EditionFlagDefault 3 0x45DB mand. - 0-1 0 u * * * * If a flag is set (1) the edition SHOULD be used as the default one. (1 bit)
EditionFlagOrdered 3 0x45DD - - 0-1 0 u * * * * Specify if the chapters can be defined multiple times and the order to play them is enforced. (1 bit)
ChapterAtom 3+ 0xB6 mand. mult. - - m * * * * * Contains the atom information to use as the chapter atom (apply to all tracks).
ChapterUID 4 0x73C4 mand. - not 0 - u * * * * * A unique ID to identify the Chapter.
ChapterStringUID 4 0x5654 - - - - 8 * * * A unique string ID to identify the Chapter. Use for WebVTT cue identifier storage.
ChapterTimeStart 4 0x91 mand. - - - u * * * * * Timestamp of the start of Chapter (not scaled).
ChapterTimeEnd 4 0x92 - - - - u * * * * * Timestamp of the end of Chapter (timestamp excluded, not scaled).
ChapterFlagHidden 4 0x98 mand. - 0-1 0 u * * * * If a chapter is hidden (1), it SHOULD NOT be available to the user interface (but still to Control Tracks; see flag notes). (1 bit)
ChapterFlagEnabled 4 0x4598 mand. - 0-1 1 u * * * * Specify whether the chapter is enabled. It can be enabled/disabled by a Control Track. When disabled, the movie SHOULD skip all the content between the TimeStart and TimeEnd of this chapter (see flag notes). (1 bit)
ChapterSegmentUID 4 0x6E67 - - >0 - b * * * * The SegmentUID of another Segment to play during this chapter. ChapterSegmentUID MUST be set if ChapterSegmentEditionUID is used.
ChapterSegmentEditionUID 4 0x6EBC - - not 0 - u * * * * The EditionUID to play from the Segment linked in ChapterSegmentUID. If ChapterSegmentEditionUID is undeclared then no Edition of the linked Segment is used.
ChapterPhysicalEquiv 4 0x63C3 - - - - u * * * * Specify the physical equivalent of this ChapterAtom like "DVD" (60) or "SIDE" (50), see complete list of values.
ChapterTrack 4 0x8F - - - - m * * * * List of tracks on which the chapter applies. If this Element is not present, all tracks apply
ChapterTrackUID 5 0x89 mand. mult. not 0 - u * * * * UID of the Track to apply this chapter to. In the absence of a control track, choosing this chapter will select the listed Tracks and deselect unlisted tracks. Absence of this Element indicates that the Chapter SHOULD be applied to any currently used Tracks.
ChapterDisplay 4 0x80 - mult. - - m * * * * * Contains all possible strings to use for the chapter display.
ChapString 5 0x85 mand. - - - 8 * * * * * Contains the string to use as the chapter atom.
ChapLanguage 5 0x437C mand. mult. - eng s * * * * * The languages corresponding to the string, in the bibliographic ISO-639-2 form. This Element MUST be ignored if the ChapLanguageIETF Element is used within the same ChapterDisplay Element.
ChapLanguageIETF 5 0x437D - mult. - - s * Specifies the language used in the ChapString according to BCP 47 and using the IANA Language Subtag Registry. If this Element is used, then any ChapLanguage Elements used in the same ChapterDisplay MUST be ignored.
ChapCountry 5 0x437E - mult. - - s * * * * * The countries corresponding to the string, same 2 octets as in Internet domains. This Element MUST be ignored if the ChapLanguageIETF Element is used within the same ChapterDisplay Element.
ChapProcess 4 0x6944 - mult. - - m * * * * Contains all the commands associated to the Atom.
ChapProcessCodecID 5 0x6955 mand. - - 0 u * * * * Contains the type of the codec used for the processing. A value of 0 means native Matroska processing (to be defined), a value of 1 means the DVD command set is used. More codec IDs can be added later.
ChapProcessPrivate 5 0x450D - - - - b * * * * Some optional data attached to the ChapProcessCodecID information. For ChapProcessCodecID = 1, it is the "DVD level" equivalent.
ChapProcessCommand 5 0x6911 - mult. - - m * * * * Contains all the commands associated to the Atom.
ChapProcessTime 6 0x6922 mand. - - - u * * * * Defines when the process command SHOULD be handled
0 - during the whole chapter,
1 - before starting playback,
2 - after playback of the chapter
ChapProcessData 6 0x6933 mand. - - - b * * * * Contains the command information. The data SHOULD be interpreted depending on the ChapProcessCodecID value. For ChapProcessCodecID = 1, the data correspond to the binary DVD cell pre/post commands.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description
Tagging
Tags 1 0x1254C367 - mult. - - m * * * * * Element containing metadata describing Tracks, Editions, Chapters, Attachments, or the Segment as a whole. A list of valid tags can be found here.
Tag 2 0x7373 mand. mult. - - m * * * * * A single metadata descriptor.
Targets 3 0x63C0 mand. - - - m * * * * * Specifies which other elements the metadata represented by the Tag applies to. If empty or not present, then the Tag describes everything in the Segment.
TargetTypeValue 4 0x68CA - - - 50 u * * * * * A number to indicate the logical level of the target.
70 - COLLECTION,
60 - EDITION / ISSUE / VOLUME / OPUS / SEASON / SEQUEL,
50 - ALBUM / OPERA / CONCERT / MOVIE / EPISODE / CONCERT,
40 - PART / SESSION,
30 - TRACK / SONG / CHAPTER,
20 - SUBTRACK / PART / MOVEMENT / SCENE,
10 - SHOT
TargetType 4 0x63CA - - - - s * * * * * An informational string that can be used to display the logical level of the target like "ALBUM", "TRACK", "MOVIE", "CHAPTER", etc (see TargetType).
COLLECTION - COLLECTION,
EDITION - EDITION,
ISSUE - ISSUE,
VOLUME - VOLUME,
OPUS - OPUS,
SEASON - SEASON,
SEQUEL - SEQUEL,
ALBUM - ALBUM,
OPERA - OPERA,
CONCERT - CONCERT,
MOVIE - MOVIE,
EPISODE - EPISODE,
PART - PART,
SESSION - SESSION,
TRACK - TRACK,
SONG - SONG,
CHAPTER - CHAPTER,
SUBTRACK - SUBTRACK,
PART - PART,
MOVEMENT - MOVEMENT,
SCENE - SCENE,
SHOT - SHOT
TagTrackUID 4 0x63C5 - mult. - 0 u * * * * * A unique ID to identify the Track(s) the tags belong to. If the value is 0 at this level, the tags apply to all tracks in the Segment.
TagEditionUID 4 0x63C9 - mult. - 0 u * * * * A unique ID to identify the EditionEntry(s) the tags belong to. If the value is 0 at this level, the tags apply to all editions in the Segment.
TagChapterUID 4 0x63C4 - mult. - 0 u * * * * A unique ID to identify the Chapter(s) the tags belong to. If the value is 0 at this level, the tags apply to all chapters in the Segment.
TagAttachmentUID 4 0x63C6 - mult. - 0 u * * * * A unique ID to identify the Attachment(s) the tags belong to. If the value is 0 at this level, the tags apply to all the attachments in the Segment.
SimpleTag 3+ 0x67C8 mand. mult. - - m * * * * * Contains general information about the target.
TagName 4 0x45A3 mand. - - - 8 * * * * * The name of the Tag that is going to be stored.
TagLanguage 4 0x447A mand. - - und s * * * * * Specifies the language of the tag specified, in the Matroska languages form. This Element MUST be ignored if the TagLanguageIETF Element is used within the same SimpleTag Element.
TagLanguageIETF 4 0x447B - - - - s * Specifies the language used in the TagString according to BCP 47 and using the IANA Language Subtag Registry. If this Element is used, then any TagLanguage Elements used in the same SimpleTag MUST be ignored.
TagDefault 4 0x4484 mand. - 0-1 1 u * * * * * A boolean value to indicate if this is the default/original language to use for the given tag.
TagString 4 0x4487 - - - - 8 * * * * * The value of the Tag.
TagBinary 4 0x4485 - - - - b * * * * * The values of the Tag if it is binary. Note that this cannot be used in the same SimpleTag as TagString.
Element Name L EBML ID Ma Mu Rng Default T 1 2 3 4 W Description