draft-ietf-cellar-tags-06.txt   draft-ietf-cellar-tags-07.txt 
cellar S. Lhomme cellar S. Lhomme
Internet-Draft Internet-Draft
Intended status: Informational M. Bunkus Intended status: Standards Track M. Bunkus
Expires: 14 October 2021 Expires: 12 April 2022
D. Rice D. Rice
12 April 2021 9 October 2021
Matroska Media Container Tag Specifications Matroska Media Container Tag Specifications
draft-ietf-cellar-tags-06 draft-ietf-cellar-tags-07
Abstract Abstract
This document defines the Matroska tags, namely the tag names and This document defines the Matroska tags, namely the tag names and
their respective semantic meaning. their respective semantic meaning.
Status of This Memo Status of This Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79. provisions of BCP 78 and BCP 79.
skipping to change at page 1, line 33 skipping to change at page 1, line 33
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/. Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on 14 October 2021. This Internet-Draft will expire on 12 April 2022.
Copyright Notice Copyright Notice
Copyright (c) 2021 IETF Trust and the persons identified as the Copyright (c) 2021 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents (https://trustee.ietf.org/ Provisions Relating to IETF Documents (https://trustee.ietf.org/
license-info) in effect on the date of publication of this document. license-info) in effect on the date of publication of this document.
Please review these documents carefully, as they describe your rights Please review these documents carefully, as they describe your rights
skipping to change at page 2, line 39 skipping to change at page 2, line 39
6.17. Legal . . . . . . . . . . . . . . . . . . . . . . . . . . 20 6.17. Legal . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.18. Notes . . . . . . . . . . . . . . . . . . . . . . . . . . 21 6.18. Notes . . . . . . . . . . . . . . . . . . . . . . . . . . 21
7. Normative References . . . . . . . . . . . . . . . . . . . . 21 7. Normative References . . . . . . . . . . . . . . . . . . . . 21
8. Informative References . . . . . . . . . . . . . . . . . . . 22 8. Informative References . . . . . . . . . . . . . . . . . . . 22
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 22 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 22
1. Introduction 1. Introduction
Matroska aims to become THE standard of multimedia container formats. Matroska aims to become THE standard of multimedia container formats.
It can store timestamped multimedia data but also chapters and tags. It can store timestamped multimedia data but also chapters and tags.
The "Tag Elements" add important metadata to identify and classify The Tag Elements add important metadata to identify and classify the
the information found in a "Matroska Segment". It can tag a whole information found in a Matroska Segment. It can tag a whole Segment,
"Segment", separate "Track Elements", individual Chapter elements or separate Track Elements, individual Chapter elements or Attachment
"Attachment Elements". Elements.
While the Matroska tagging framework allows anyone to create their While the Matroska tagging framework allows anyone to create their
own custom tags, it's important to have a common set of values for own custom tags, it's important to have a common set of values for
interoperability. This document intends to define a set of common interoperability. This document intends to define a set of common
tag names used in Matroska. tag names used in Matroska.
2. Status of this document 2. Status of this document
This document is a work-in-progress specification defining the This document is a work-in-progress specification defining the
Matroska file format as part of the IETF Cellar working group Matroska file format as part of the IETF Cellar working group
(https://datatracker.ietf.org/wg/cellar/charter/). It uses basic (https://datatracker.ietf.org/wg/cellar/charter/). It uses basic
elements and concepts already defined in the Matroska specifications elements and concepts already defined in the Matroska specifications
defined by this workgroup. defined by this workgroup.
3. Security Considerations 3. Security Considerations
"Tag" values can be either strings or binary blobs. This document Tag values can be either strings or binary blobs. This document
inherits security considerations from the EBML and Matroska inherits security considerations from the EBML and Matroska
documents. documents.
4. IANA Considerations 4. IANA Considerations
To be determined. To be determined.
5. Notation and Conventions 5. Notation and Conventions
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
skipping to change at page 7, line 14 skipping to change at page 7, line 14
An upper level value tag applies to the lower level. That means if a An upper level value tag applies to the lower level. That means if a
CD has the same artist for all tracks, you just need to set the CD has the same artist for all tracks, you just need to set the
ARTIST tag at level 50 (ALBUM) and not to each TRACK (but you can). ARTIST tag at level 50 (ALBUM) and not to each TRACK (but you can).
That also means that, if some parts of the CD have no known ARTIST, That also means that, if some parts of the CD have no known ARTIST,
the value MUST be set to nothing (a void string ""). the value MUST be set to nothing (a void string "").
When a level doesn't exist it MUST NOT be specified in the files, so When a level doesn't exist it MUST NOT be specified in the files, so
that the TOTAL_PARTS and PART_NUMBER elements match the same levels. that the TOTAL_PARTS and PART_NUMBER elements match the same levels.
Here is an example of how these "organizational" tags work: If you Here is an example of how these organizational tags work: If you set
set 10 TOTAL_PARTS to the ALBUM level (40) it means the album 10 TOTAL_PARTS to the ALBUM level (40) it means the album contains 10
contains 10 lower parts. The lower part in question is the first lower parts. The lower part in question is the first lower level
lower level that is specified in the file. So, if it's TRACK (30), that is specified in the file. So, if it's TRACK (30), then that
then that means it contains 10 tracks. If it's MOVEMENT (20), that means it contains 10 tracks. If it's MOVEMENT (20), that means it's
means it's 10 movements, etc. 10 movements, etc.
6.4. Official tags 6.4. Official tags
The following is a complete list of the supported Matroska Tags. The following is a complete list of the supported Matroska Tags.
While it is possible to use Tag names that are not listed below, this While it is possible to use Tag names that are not listed below, this
is not recommended as compatibility will be compromised. If you find is not recommended as compatibility will be compromised. If you find
that there is a Tag missing that you would like to use, then please that there is a Tag missing that you would like to use, then please
contact the Matroska team for its inclusion in the specifications contact the Matroska team for its inclusion in the specifications
before the format reaches 1.0. before the format reaches 1.0.
skipping to change at page 12, line 28 skipping to change at page 12, line 28
+-------------------------+-------+-------------------------------+ +-------------------------+-------+-------------------------------+
| ACTOR | UTF-8 | An actor or actress playing a | | ACTOR | UTF-8 | An actor or actress playing a |
| | | role in this movie. This is | | | | role in this movie. This is |
| | | the person's real name, not | | | | the person's real name, not |
| | | the character's name the | | | | the character's name the |
| | | person is playing. | | | | person is playing. |
+-------------------------+-------+-------------------------------+ +-------------------------+-------+-------------------------------+
| CHARACTER | UTF-8 | The name of the character an | | CHARACTER | UTF-8 | The name of the character an |
| | | actor or actress plays in | | | | actor or actress plays in |
| | | this movie. This SHOULD be a | | | | this movie. This SHOULD be a |
| | | sub-tag of an "ACTOR" tag in | | | | sub-tag of an ACTOR tag in |
| | | order not to cause | | | | order not to cause |
| | | ambiguities. | | | | ambiguities. |
+-------------------------+-------+-------------------------------+ +-------------------------+-------+-------------------------------+
| WRITTEN_BY | UTF-8 | The author of the story or | | WRITTEN_BY | UTF-8 | The author of the story or |
| | | script (used for movies and | | | | script (used for movies and |
| | | TV shows). | | | | TV shows). |
+-------------------------+-------+-------------------------------+ +-------------------------+-------+-------------------------------+
| SCREENPLAY_BY | UTF-8 | The author of the screenplay | | SCREENPLAY_BY | UTF-8 | The author of the screenplay |
| | | or scenario (used for movies | | | | or scenario (used for movies |
| | | and TV shows). | | | | and TV shows). |
skipping to change at page 14, line 44 skipping to change at page 14, line 44
+---------------------+-------+------------------------------------+ +---------------------+-------+------------------------------------+
| INITIAL_KEY | UTF-8 | The initial key that a musical | | INITIAL_KEY | UTF-8 | The initial key that a musical |
| | | track starts in. The format is | | | | track starts in. The format is |
| | | identical to "TKEY" tag in | | | | identical to "TKEY" tag in |
| | | [ID3v2]. | | | | [ID3v2]. |
+---------------------+-------+------------------------------------+ +---------------------+-------+------------------------------------+
| PERIOD | UTF-8 | Describes the period that the | | PERIOD | UTF-8 | Describes the period that the |
| | | piece is from or about. For | | | | piece is from or about. For |
| | | example, "Renaissance". | | | | example, "Renaissance". |
+---------------------+-------+------------------------------------+ +---------------------+-------+------------------------------------+
| LAW_RATING | UTF-8 | Depending on the "COUNTRY" it's | | LAW_RATING | UTF-8 | Depending on the COUNTRY it's the |
| | | the format of the rating of a | | | | format of the rating of a movie |
| | | movie (P, R, X in the USA, an age | | | | (P, R, X in the USA, an age in |
| | | in other countries or a URI | | | | other countries or a URI defining |
| | | defining a logo). | | | | a logo). |
+---------------------+-------+------------------------------------+ +---------------------+-------+------------------------------------+
Table 7 Table 7
6.11. Temporal Information 6.11. Temporal Information
+================+=======+========================================+ +================+=======+========================================+
| Tag Name | Type | Description | | Tag Name | Type | Description |
+================+=======+========================================+ +================+=======+========================================+
| DATE_RELEASED | UTF-8 | The time that the item was originally | | DATE_RELEASED | UTF-8 | The time that the item was originally |
 End of changes. 9 change blocks. 
22 lines changed or deleted 22 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/