From adcf51dccdddc806c7da7172f4e162e69f392370 Mon Sep 17 00:00:00 2001 From: Your Name Date: Tue, 11 May 2021 22:18:40 +0200 Subject: 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. --- DOCS/edl-mpv.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'DOCS/edl-mpv.rst') 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 ===================== -- cgit v1.2.3