ffmpeg-playback

Preview and debug ffplay-based media playback and GaAs filter graphs via a Python wrapper.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Preview and debug media playback and filter graphs with ffplay from a dedicated wrapper.

Core Features & Use Cases

  • Unified playback preview: quick A/V preview, filter-graph testing (-vf/-af), and visual diagnostics (waveform, spectrum, vectorscope).
  • Diagnostics & timing: loudness meter (ebur128), AV-sync debugging, pixel format overlay, and frame-by-frame scrubbing for QA.
  • Workflow integration: supports scripted workflows via the included play.py wrapper to streamline QA and experimentation.

Quick Start

Run the provided play.py script to preview a video file and test filters using ffplay.

Frequently Asked Questions about ffmpeg-playback

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

FAQPage Schema
How do I preview media playback and test filter graphs with ffplay?

You can preview media playback and test filter graphs by running the included play.py wrapper, which executes ffplay subcommands like preview and filter-test for quick A/V visualization.

Can I debug AV-sync drift and measure loudness in video pipelines using ffplay?

Yes, you can debug AV-sync drift and measure loudness using the sync and loudness-meter subcommands, which provide timing diagnostics and ebur128 audio analysis within the ffplay wrapper.

What's the best way to visualize audio waveforms and video vectorscopes for QA?

The best way to visualize audio waveforms and video vectorscopes for QA is using the waveform, spectrum, and vectorscope subcommands, which render visual diagnostics directly via ffplay.

Do I need Python and FFmpeg installed to run ffplay playback diagnostics?

Yes, you need both a Python runtime and the FFmpeg suite installed, because the wrapper script requires Python to execute and the underlying ffplay binary to render media playback and visualizations.

Does ffplay support frame-by-frame scrubbing and pixel format overlays for video QA?

Yes, ffplay supports frame-by-frame scrubbing and pixel format overlays, enabling detailed visual inspection and debugging of video pipelines during QA and development workflows.

Why use a dedicated ffplay wrapper instead of command-line playback for filter testing?

A dedicated ffplay wrapper streamlines filter testing by exposing structured subcommands for -vf/-af graphs and diagnostics, integrating scripted workflows more efficiently than manual command-line entry.