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.