summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorYour Name <you@example.com>2021-05-11 22:18:40 +0200
committerYour Name <you@example.com>2021-05-11 22:18:40 +0200
commitadcf51dccdddc806c7da7172f4e162e69f392370 (patch)
tree5363975f937c0e89855b12e7a9ec8d766a745aa3 /DOCS
parentea89e813f730aaf4e97ea6c2b22c6a405d34955c (diff)
downloadmpv-adcf51dccdddc806c7da7172f4e162e69f392370.tar.bz2
mpv-adcf51dccdddc806c7da7172f4e162e69f392370.tar.xz
edl: add a way to add tags
Add new header which shows up as tags/metadata (associated with --display-tags). The way this is added means it doesn't always work, because root->meta (see code) can be NULL for some absurd reason. But it works for the one case I intended to use it (ytdl_hook, see next commit), though only in default configurations.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/edl-mpv.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/DOCS/edl-mpv.rst b/DOCS/edl-mpv.rst
index 78da44a8bf..0e4d2b410e 100644
--- a/DOCS/edl-mpv.rst
+++ b/DOCS/edl-mpv.rst
@@ -239,6 +239,26 @@ title. The subtitle stream will use ``ducks`` as title.
The ``track_meta`` header is not part of the core EDL format. It may be changed
or removed at any time, depending on mpv's internal requirements.
+Global metadata
+===============
+
+The special ``global_tags`` header can set metadata fields (aka tags) of the EDL
+file. This metadata is supposed to be informational, much like for example ID3
+tags in audio files. Due to lack of separation of different kinds of metadata it
+is unspecified what names are allowed, how they are interpreted, and whether
+some of them affect playback functionally. (Much of this is unfortunately
+inherited from FFmpeg. Another consequence of this is that FFmpeg "normalized"
+tags are recognized, or stuff like replaygain tags.)
+
+Example::
+
+ !global_tags,title=bla,something_arbitrary=even_more_arbitrary
+
+Any parameter names are allowed. Repeated use of this adds to the tag list. If
+``!new_stream`` is used, the location doesn't matter.
+
+May possibly be ignored in some cases, such as delayed media opening.
+
Delayed media opening
=====================