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
fix: date the Python 3.9 deprecation 2.10.9, the release that shipped it (#347)
Shogo Kajiyamaf13cd30a2272
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 465f917..0865f05 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,7 +4,9 @@## Unreleased-(nothing yet)+### Fixed++- **The Python 3.9 deprecation is dated 2.10.9, the release that shipped it.** The warning, `contract --json`'s `deprecated` entry and the docs said 2.11.0, the version the change was written for before the automated release numbered it 2.10.9.## 2.10.9@@ -16,7 +18,7 @@ _Automated release: version and notes generated from pull requests merged since### Deprecated-- **Python 3.9** (since 2.11.0, removed in 3.0.0). CPython 3.9 reached end of life in October 2025 and gets no security fixes. It still works throughout 2.x: the floor stays `>=3.9` and CI keeps testing it. On 3.9, `doctor` and the `npx` installer print one stderr line naming the replacement, Python 3.10+. `contract --json`'s `deprecated` list has the entry, and `requirements.python` says 3.10+ is recommended.+- **Python 3.9** (since 2.10.9, removed in 3.0.0). CPython 3.9 reached end of life in October 2025 and gets no security fixes. It still works throughout 2.x: the floor stays `>=3.9` and CI keeps testing it. On 3.9, `doctor` and the `npx` installer print one stderr line naming the replacement, Python 3.10+. `contract --json`'s `deprecated` list has the entry, and `requirements.python` says 3.10+ is recommended.### Fixeddiff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex f9bc618..8157c0e 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -47,7 +47,7 @@ npm run release-check # packaging + installer + MCP + doctor + full suitepython3 scripts/_contract.py doctor # what this machine can actually run```-Python 3.9+ standard library only — no new runtime dependencies. 3.9 is deprecated since 2.11.0 and+Python 3.9+ standard library only — no new runtime dependencies. 3.9 is deprecated since 2.10.9 andstill runs in CI until 3.0 drops it, so code must keep working on it until then. Every scriptmust keep working with nothing beyond `ffmpeg`/`ffprobe` on `PATH`.diff --git a/README.md b/README.mdindex 0413ae8..ae1413a 100644--- a/README.md+++ b/README.md@@ -419,7 +419,7 @@ The encode path a tool will actually take is Apple VideoToolbox, for h264, hevc## FFmpeg compatibility-The tools need FFmpeg 5.0 or later and Python 3.9 or later (standard library only); Python 3.10+ is recommended: 3.9 still works but is deprecated since 2.11.0 (CPython 3.9 is end of life), `doctor` and the `npx` installer warn on it, and 3.0 drops it. What CI actually exercises on every pull request is FFmpeg 5.1.1 (static build), 6.1 (Ubuntu apt), 7.1 (Debian trixie apt), 8.x (macOS Homebrew) and 9.x (Windows gyan.dev), on Python 3.9 and 3.13 (the two ends of the supported range). The capability parser has been run against the listings of these builds:+The tools need FFmpeg 5.0 or later and Python 3.9 or later (standard library only); Python 3.10+ is recommended: 3.9 still works but is deprecated since 2.10.9 (CPython 3.9 is end of life), `doctor` and the `npx` installer warn on it, and 3.0 drops it. What CI actually exercises on every pull request is FFmpeg 5.1.1 (static build), 6.1 (Ubuntu apt), 7.1 (Debian trixie apt), 8.x (macOS Homebrew) and 9.x (Windows gyan.dev), on Python 3.9 and 3.13 (the two ends of the supported range). The capability parser has been run against the listings of these builds:| FFmpeg | `-filters` row layout | Source ||---|---|---|diff --git a/bin/install.js b/bin/install.jsindex 96c9aef..394a786 100755--- a/bin/install.js+++ b/bin/install.js@@ -47,9 +47,9 @@ if (has('--help') || has('-h')) {// The probe also prints major.minor, so the installer can warn about a deprecated interpreter.const PYTHON_PROBE = ['-c', "import sys; sys.stdout.write('%d.%d' % sys.version_info[:2]); raise SystemExit(0 if sys.version_info >= (3, 9) else 1)"];-// 2.11.0 deprecates Python 3.9 (docs/contract.md "Deprecation policy"; `contract --json`'s+// 2.10.9 deprecates Python 3.9 (docs/contract.md "Deprecation policy"; `contract --json`'s// `deprecated`). The same line as scripts/_contract.py's PY39_DEPRECATION (a test keeps them equal).-const PY39_DEPRECATION = 'warning: Python 3.9 is deprecated since ffmpeg-skill 2.11.0 (CPython 3.9 reached end of life in October 2025 and gets no security fixes); it still works in 2.x and support ends in 3.0.0: use Python 3.10+.';+const PY39_DEPRECATION = 'warning: Python 3.9 is deprecated since ffmpeg-skill 2.10.9 (CPython 3.9 reached end of life in October 2025 and gets no security fixes); it still works in 2.x and support ends in 3.0.0: use Python 3.10+.';function pythonDeprecation(version) {return version === '3.9' ? PY39_DEPRECATION : null;diff --git a/docs/contract.md b/docs/contract.mdindex d8dd272..2e5be3b 100644--- a/docs/contract.md+++ b/docs/contract.md@@ -81,12 +81,12 @@ on, the line says so.`contract --json` carries a top-level `deprecated` list, next to `contract_version`: one entry perthing the next major removes, `{"what", "since", "replacement", "removed_in", "where"}` with `where`-naming the surface (`cli`, `json`, `mcp`, `behaviour`). It was empty in 2.0.0. Since 2.11.0 it lists one+naming the surface (`cli`, `json`, `mcp`, `behaviour`). It was empty in 2.0.0. Since 2.10.9 it lists oneentry: **running on Python 3.9** (`where: behaviour`, `removed_in: 3.0.0`). CPython 3.9 reached end of lifein October 2025 and gets no security fixes, but raising the floor is a break, so 2.x keeps running on 3.9(`requirements.python` stays `>=3.9`, and CI keeps testing it). It is deprecated, and Python 3.10+ isrecommended: on 3.9, `doctor` and the `npx` installer print one stderr line,-`warning: Python 3.9 is deprecated since ffmpeg-skill 2.11.0 (...); it still works in 2.x and support ends in 3.0.0: use Python 3.10+.`+`warning: Python 3.9 is deprecated since ffmpeg-skill 2.10.9 (...); it still works in 2.x and support ends in 3.0.0: use Python 3.10+.`Like every deprecation warning it is stderr only: `doctor --json`'s document has no key for it.`tests/test_contract.py` refuses a package.json major bump that still lists an entry that major should remove, or thatcomes before step 2's window has passed -- unless the waiver is written here, as 2.0.0's is.@@ -123,12 +123,12 @@ JSON would have been rewritten for that. The flat keys, typed per tool in `outpu```json{"contract_version": "1.0",- "deprecated": [{"what": "running on Python 3.9 (the requirements.python floor)", "since": "2.11.0", "replacement": "Python 3.10 or later; ...", "removed_in": "3.0.0", "where": "behaviour"}],+ "deprecated": [{"what": "running on Python 3.9 (the requirements.python floor)", "since": "2.10.9", "replacement": "Python 3.10 or later; ...", "removed_in": "3.0.0", "where": "behaviour"}],"removed": [{"what": "...", "since": "1.10.0", "replacement": "...", "removed_in": "2.0.0", "where": "cli | json | mcp | behaviour"}],"skill": {"id": "ffmpeg-skill", "version": "2.10.9", "execution_mode": "local", "kind": "execution","entrypoints": {"cli": "...", "mcp": "...", "contract": "...", "doctor": "..."},"not_provided": ["AI reasoning", "decisions", "production plans", "project IR", "approvals", "network access", "transcription engine"]},- "requirements": {"python": ">=3.9 (standard library only; 3.9 deprecated since 2.11.0, removed in 3.0.0; 3.10+ recommended)", "ffmpeg": ">=5.0", "ffprobe": ">=5.0"},+ "requirements": {"python": ">=3.9 (standard library only; 3.9 deprecated since 2.10.9, removed in 3.0.0; 3.10+ recommended)", "ffmpeg": ">=5.0", "ffprobe": ">=5.0"},"execution": {"shell": false, "arbitrary_executables": false, "network": false,"model_downloads": {"when": "...", "in_process": {"faster-whisper": "..."},"child_process": {"parakeet-mlx": "...", "openai-whisper": "..."},diff --git a/scripts/_contract.py b/scripts/_contract.pyindex cdf62b6..f386734 100644--- a/scripts/_contract.py+++ b/scripts/_contract.py@@ -832,9 +832,9 @@ def ffmpeg_security(versions: Dict[str, Optional[str]], sources: Optional[Dict[sreturn out-# 2.11.0 deprecates Python 3.9 (docs/contract.md "Deprecation policy"; DEPRECATED below). The same+# 2.10.9 deprecates Python 3.9 (docs/contract.md "Deprecation policy"; DEPRECATED below). The same# line is printed by bin/install.js (PY39_DEPRECATION there; a test keeps the two equal).-PY39_DEPRECATION = ("warning: Python 3.9 is deprecated since ffmpeg-skill 2.11.0 (CPython 3.9 reached end of life "+PY39_DEPRECATION = ("warning: Python 3.9 is deprecated since ffmpeg-skill 2.10.9 (CPython 3.9 reached end of life ""in October 2025 and gets no security fixes); it still works in 2.x and support ends in 3.0.0: use Python 3.10+.")@@ -1404,7 +1404,7 @@ DEPRECATED: List[Dict[str, str]] = [# CPython 3.9 reached end of life in October 2025. Raising the floor is a break, so 2.x keeps# running on it (CI still tests 3.9) and doctor / bin/install.js print PY39_DEPRECATION.{"what": "running on Python 3.9 (the requirements.python floor)",- "since": "2.11.0", "removed_in": "3.0.0", "where": "behaviour",+ "since": "2.10.9", "removed_in": "3.0.0", "where": "behaviour","replacement": "Python 3.10 or later; on 3.9, doctor and the npx installer print a one-line warning"},]@@ -1644,7 +1644,7 @@ def build(detect: bool = True) -> Dict[str, Any]:},"not_provided": ["AI reasoning", "decisions", "production plans", "project IR", "approvals", "network access", "transcription engine"],},- "requirements": {"python": ">=3.9 (standard library only; 3.9 deprecated since 2.11.0, removed in 3.0.0; 3.10+ recommended)", "ffmpeg": ">=5.0", "ffprobe": ">=5.0", "node": ">=16 (npx installer only)"},+ "requirements": {"python": ">=3.9 (standard library only; 3.9 deprecated since 2.10.9, removed in 3.0.0; 3.10+ recommended)", "ffmpeg": ">=5.0", "ffprobe": ">=5.0", "node": ">=16 (npx installer only)"},"execution": {"shell": False,"arbitrary_executables": False,diff --git a/tests/test_contract.py b/tests/test_contract.pyindex 6e251a0..d6b7d30 100644--- a/tests/test_contract.py+++ b/tests/test_contract.py@@ -1342,7 +1342,7 @@ class ContractTests(unittest.TestCase):# are what that major's own PR is checked against.# None: not released yet. Set it to the tag date when that version ships; a major bump fails# while it is None, because the 90-day window cannot be counted from an unknown date.- DEPRECATION_RELEASE_DATES = {"1.10.0": "2026-09-13", "2.11.0": None}+ DEPRECATION_RELEASE_DATES = {"1.10.0": "2026-09-13", "2.10.9": "2026-10-22"}# A major released before step 2's 90 days had passed, by the maintainer's decision. Each one# must be stated in docs/contract.md (the needle below), so it is a written waiver, not a slip.WINDOW_WAIVERS = {2: "**2.0.0 waived the 90-day half of step 2.**"}@@ -1694,12 +1694,12 @@ class ContractTests(unittest.TestCase):self.assertEqual(proc.returncode, 0, proc.stderr or proc.stdout)def test_python_3_9_is_deprecated_on_every_surface(self):- """2.11.0 deprecates Python 3.9 per docs/contract.md's policy: an entry in `deprecated`+ """2.10.9 deprecates Python 3.9 per docs/contract.md's policy: an entry in `deprecated`(removed in 3.0.0), the floor unchanged (3.9 still runs), and one identical warning line fromdoctor (Python) and the npx installer (Node)."""entry = [e for e in self.contract["deprecated"] if "Python 3.9" in e["what"]]self.assertEqual(len(entry), 1)- self.assertEqual((entry[0]["since"], entry[0]["removed_in"], entry[0]["where"]), ("2.11.0", "3.0.0", "behaviour"))+ self.assertEqual((entry[0]["since"], entry[0]["removed_in"], entry[0]["where"]), ("2.10.9", "3.0.0", "behaviour"))self.assertIn("3.10", entry[0]["replacement"])self.assertTrue(self.contract["requirements"]["python"].startswith(">=3.9 "), "the hard floor stays 3.9 until 3.0")self.assertIn("deprecated", self.contract["requirements"]["python"])