ffmpeg-metadata

Automate FFmpeg metadata workflows for tagging, chapters, and cover art.

15|4|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/damionrashford/media-os --skill ffmpeg-metadata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ffmpeg-metadata
Source: https://github.com/damionrashford/media-os/tree/main/skills/ffmpeg-metadata
Command: npx skills add https://github.com/damionrashford/media-os --skill ffmpeg-metadata

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

ffmpeg-metadata automates the tedious process of applying and updating metadata, chapters, and cover art across common media containers using FFmpeg, reducing manual editing and ensuring consistency.

Core Features & Use Cases

  • Set container and per-stream tags with ffmpeg metadata flags, including per-stream language and track titles.
  • Create and apply chapters either from an ffmetadata file or via inline timestamp entries.
  • Embed cover art, attach fonts to MKV, and manage dispositions to control playback behavior.
  • Strip metadata and chapters for privacy or clean handoffs, while preserving the rest of the media.
  • Manage Matroska edition entries and maintain language tagging across streams.

Quick Start

Provide an input media file, specify the desired metadata or chapters, and the skill will compose and run the appropriate ffmpeg commands to update the file in place or generate a new tagged output.

Frequently Asked Questions about ffmpeg-metadata

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I embed cover art and set metadata tags in MP4 and MKV files using ffmpeg?

You can embed cover art, set container tags, and apply per-stream language tagging across MP4 and MKV files by constructing safe ffmpeg commands that use -c copy for metadata-only edits without re-encoding the media streams.

Can I add chapters to media files from an ffmetadata file without re-encoding the video?

Yes, chapters can be created and applied from an ffmetadata file or inline timestamp entries. The process uses -c copy to preserve the original media streams while updating the chapter metadata in the container.

What is the best way to attach fonts to MKV files and manage stream dispositions for playback?

Attaching fonts to MKV files and managing dispositions controls playback behavior. This is handled by constructing ffmpeg commands that add attachments and set disposition flags while copying existing streams.

Does ffmpeg support stripping metadata and chapters for clean handoffs while preserving the media?

Yes, ffmpeg supports stripping metadata and chapters for privacy or clean handoffs. The process removes specified metadata and chapters while preserving the rest of the media using stream copy.

How do I apply per-stream language tagging and track titles across MP3 and FLAC files?

Per-stream language tagging and track titles are applied across MP3 and FLAC files using ffmpeg metadata flags. The workflow constructs safe commands that update tags while using -c copy to avoid re-encoding.

Can I dry-run ffmpeg metadata commands and clean up temporary ffmetadata files automatically?

Yes, the workflow supports dry-run execution to preview commands before applying changes. It also handles temporary ffmetadata file creation and cleans up these temporary files after the metadata update completes.