Metadata

Video Single output Transform

Manipulate video frame metadata.

FFmpeg filter: metadata — the official reference.

Add it to a graph. The explicit form works for every filter — bind it to its input and read the result from outputs():

$node   = $video->addFilter(new Metadata(…));
$result = $node->outputs()[0];

Shorthand. Single-output filters can skip the node — apply() returns the result stream directly:

$result = $video->apply(new Metadata(…));

When to use it

TODO — when this filter shines: what it’s the right tool for, what to reach for instead when it isn’t, and how it composes with neighbouring filters.

How to use it

TODO — prose: how the filter actually works and what its key parameters mean (the explanation FFmpeg’s terse option help omits).

Examples

TODO — runnable PHP, with the equivalent ffmpeg CLI alongside.

Gotchas

TODO

See also

TODO

Parameters

Parameter	Type	Default	Range / values	Description
mode	MetadataMode	select	select, add, modify, delete, print	set a mode of operation
key	string	—	—	set metadata key
value	string	—	—	set metadata value
function	MetadataFunction	same_str	same_str, starts_with, less, equal, greater, expr, ends_with	function for comparing values
expr	string	—	—	set expression for expr function
file	string	—	—	set file where to print metadata information
direct	bool	false	—	reduce buffering when printing to user-set file or pipe

---

Maps to FFmpeg’s metadata filter. Verified against ffmpeg n7.1.1.