Local video editor for coding agents: 42 FFmpeg tools with a machine-readable contract and an MCP server, for Claude Code, Cursor and Codex. Cut, captions, reframe, loudness, platform exports. No cloud, no API keys.
Python agent-skillsai-agentsaudio-processingcaptionsclaude-codecodexcoding-agentcursorffmpegloudness-normalizationmcpmcp-servermodel-context-protocolpythonsubtitlestranscodingvideovideo-editingvideo-processingwhisper
tests: cover overlay.py --image on an audio-less video (#49)
Shogo Kajiyama9559a29b2004
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 71cbbad..72fa3be 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,6 +4,13 @@## Unreleased+- **Tests: `overlay.py --image` on an audio-less video is now covered.** Every existing overlay test used a+ source with audio; investigating a downstream report of `overlay.py` "hanging" on audio-less input (the+ historical 0.9.x defect this tool's own `-t <duration>` fix, added in 0.10.0, was meant to close) found the+ fix already works — the run had just been mistaken for a hang under a too-short timeout while it was still+ transcoding a 1080p60 frame with a fade filter. No code change; `test_overlay_on_audio_less_video_terminates`+ closes the coverage gap so this defect class can't silently regress.+## 0.11.0 — 2026-09-07 — Pixel crop, still-to-clip, rotate/flip/PiP/reverse/chromakey/stabilize/sequence/Ken Burns, fail-loudly output verification, capability mapCloses the video-editing-skill ADR-002/ADR-003 gap investigation (11 confirmed gaps): `crop.py`, `insert.py` (incl. Ken Burns), `fit.py --rotate`/`--flip`, `overlay.py --video`/`--chromakey` (video-on-video PiP, chroma key), `reverse.py`, `stabilize.py`, `sequence.py`, `background.py`, `proxy.py`, `contract --json`'s `capability_map`, and a repo-wide "fail loudly" pass making `verify_output()` the single success criterion for every writing tool. 28 tools total (was 21 at 0.10.0); README/package.json's stale "21"/"22" tool-count strings are also corrected to the real count here — see [#50](https://github.com/kajisho5/ffmpeg-skill/issues/50) for making that count self-maintaining going forward.diff --git a/tests/test_all.py b/tests/test_all.pyindex 35f7c16..85b2014 100644--- a/tests/test_all.py+++ b/tests/test_all.py@@ -1632,6 +1632,21 @@ class FFmpegSkillTests(unittest.TestCase):self.assertIn("-t", data["commands"][0])self.assertClose(data["probe"]["duration"], 12.0, 0.15)+ def test_overlay_on_audio_less_video_terminates(self):+ """Every other overlay test uses self.src, which has audio. Cover the audio-less case too:+ overlay is documented elsewhere as risky on inputs with no audio stream to help -shortest+ bound the looped-image (-loop 1) input, so pin down that it completes and the output duration+ matches the source exactly (the explicit -t, not -shortest, is what actually bounds it)."""+ noaudio = OUT / "overlay_noaudio_source.mp4"+ sh("ffmpeg", "-y", "-hide_banner", "-loglevel", "error", "-i", self.src, "-an", "-c:v", "copy", noaudio)+ self.assertIsNone(probe(str(noaudio)).get("audio"))+ out = OUT / "overlay_noaudio.mp4"+ proc = subprocess.run(+ [sys.executable, str(SCRIPTS / "overlay.py"), str(noaudio), "--image", str(self.logo),+ "--position", "bottom-right", "--start", "1", "--end", "5", "--fade", "0.3", "-o", str(out)],+ stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, encoding="utf-8", errors="replace", timeout=60)+ self.assertEqual(proc.returncode, 0, f"STDOUT:\n{proc.stdout}\nSTDERR:\n{proc.stderr}")+ self.assertClose(probe(str(out))["duration"], probe(str(noaudio))["duration"], 0.15)def test_overlay_video_pip_composites_at_the_right_position(self):red_bg = OUT / "red_bg.mp4"blue_quad = OUT / "blue_quad.mp4"