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
docs(readme): fresnel-style header with a Liquid Glass app icon (#337)
Shogo Kajiyama862d91273c10
diff --git a/README.md b/README.mdindex cb8c549..4c5eb86 100644--- a/README.md+++ b/README.md@@ -1,27 +1,34 @@<p align="center">- <img src="assets/logo.png" alt="FFmpeg Skill: media processing for AI agents" width="760">+ <picture>+ <source media="(prefers-color-scheme: dark)" srcset="brand/app-icon-dark.png">+ <img src="brand/app-icon.png" width="128" alt="ffmpeg-skill app icon">+ </picture></p>-<h1 align="center">ffmpeg-skill</h1>+<p align="center">+ <picture>+ <source media="(prefers-color-scheme: dark)" srcset="brand/logo/ffmpeg-skill-wordmark-white.svg">+ <img src="brand/logo/ffmpeg-skill-wordmark-black.svg" height="48" alt="ffmpeg-skill">+ </picture>+</p>-<p align="center"><strong>Give your coding agent a video editor.</strong></p>+<p align="center"><b>Give your coding agent a video editor.</b><br>+Claude Code, Cursor, Codex or any MCP client edits your footage with local FFmpeg, then checks its own output.<br>+No cloud · No API keys · Python standard library</p><p align="center">- Local FFmpeg · No cloud · No API keys · Python standard library<br>- Claude Code · Cursor · Codex · MCP+ <a href="#quick-start"><b>Quick start</b></a> ·+ <a href="docs/demos.md">Demos</a> ·+ <a href="#tools">Tools</a> ·+ <a href="#mcp">MCP</a> ·+ <a href="https://www.npmjs.com/package/ffmpeg-skill">npm</a></p><p align="center"><a href="https://github.com/kajisho5/ffmpeg-skill/actions/workflows/ci.yml"><img src="https://github.com/kajisho5/ffmpeg-skill/actions/workflows/ci.yml/badge.svg" alt="tests"></a>- <a href="https://github.com/kajisho5/ffmpeg-skill/actions/workflows/codeql.yml"><img src="https://github.com/kajisho5/ffmpeg-skill/actions/workflows/codeql.yml/badge.svg" alt="CodeQL"></a><a href="https://www.npmjs.com/package/ffmpeg-skill"><img src="https://img.shields.io/npm/v/ffmpeg-skill" alt="npm"></a>- <a href="https://www.npmjs.com/package/ffmpeg-skill"><img src="https://img.shields.io/npm/dm/ffmpeg-skill" alt="npm downloads"></a>- <a href="https://github.com/kajisho5/ffmpeg-skill/stargazers"><img src="https://img.shields.io/github/stars/kajisho5/ffmpeg-skill" alt="GitHub stars"></a>- <a href="https://github.com/kajisho5/ffmpeg-skill/commits/main"><img src="https://img.shields.io/github/last-commit/kajisho5/ffmpeg-skill" alt="last commit"></a>- <img src="https://img.shields.io/badge/python-3.9%20%7C%203.13-blue" alt="Python 3.9 and 3.13 tested"><a href="#ffmpeg-compatibility"><img src="https://img.shields.io/badge/ffmpeg-5.1%20%7C%206.1%20%7C%207.1%20%7C%208%20%7C%209%20tested-orange" alt="FFmpeg 5.1, 6.1, 7.1, 8 and 9 tested in CI"></a><a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT"></a>- <a href="https://github.com/sponsors/kajisho5"><img src="https://img.shields.io/badge/sponsor-%E2%9D%A4-ea4aaa?logo=githubsponsors" alt="Sponsor"></a></p>```bashdiff --git a/brand/app-icon-dark.png b/brand/app-icon-dark.pngnew file mode 100644index 0000000..8b013e3Binary files /dev/null and b/brand/app-icon-dark.png differdiff --git a/brand/app-icon.png b/brand/app-icon.pngnew file mode 100644index 0000000..0361a62Binary files /dev/null and b/brand/app-icon.png differdiff --git a/brand/ffmpeg-skill.icon/Assets/in-out.svg b/brand/ffmpeg-skill.icon/Assets/in-out.svgnew file mode 100644index 0000000..03ca579--- /dev/null+++ b/brand/ffmpeg-skill.icon/Assets/in-out.svg@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#FFFFFF"/><stop offset="1" stop-color="#FFFFFF" stop-opacity=".78"/></linearGradient></defs><g fill="none" stroke="url(#g)" stroke-width="76"><path d="M412 316 H300 V740 H412"/><path d="M612 316 H724 V740 H612"/></g></svg>\ No newline at end of filediff --git a/brand/ffmpeg-skill.icon/Assets/playhead.svg b/brand/ffmpeg-skill.icon/Assets/playhead.svgnew file mode 100644index 0000000..6caf8c9--- /dev/null+++ b/brand/ffmpeg-skill.icon/Assets/playhead.svg@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024"><defs><linearGradient id="g" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#FFFFFF"/><stop offset="1" stop-color="#FFFFFF" stop-opacity=".78"/></linearGradient></defs><g fill="url(#g)"><path d="M444.0 232 H580.0 L512 349.8 Z"/><rect x="492" y="348" width="40" height="446"/></g></svg>\ No newline at end of filediff --git a/brand/ffmpeg-skill.icon/icon.json b/brand/ffmpeg-skill.icon/icon.jsonnew file mode 100644index 0000000..b6b7ed5--- /dev/null+++ b/brand/ffmpeg-skill.icon/icon.json@@ -0,0 +1,84 @@+{+ "groups" : [+ {+ "layers" : [+ {+ "glass" : true,+ "image-name" : "playhead.svg",+ "name" : "Playhead",+ "fill-specializations" : [+ {+ "appearance" : "dark",+ "value" : {+ "solid" : "srgb:0.13333,0.82745,0.93333,1.00000"+ }+ }+ ]+ }+ ],+ "name" : "Front",+ "shadow" : {+ "kind" : "layer-color",+ "opacity" : 0.7+ },+ "specular" : true,+ "translucency" : {+ "enabled" : true,+ "value" : 0.15+ }+ },+ {+ "layers" : [+ {+ "glass" : true,+ "image-name" : "in-out.svg",+ "name" : "In-Out",+ "fill-specializations" : [+ {+ "appearance" : "dark",+ "value" : {+ "solid" : "srgb:0.13333,0.82745,0.93333,1.00000"+ }+ }+ ]+ }+ ],+ "name" : "Back",+ "shadow" : {+ "kind" : "layer-color",+ "opacity" : 0.6+ },+ "specular" : true,+ "translucency" : {+ "enabled" : true,+ "value" : 0.55+ },+ "blur-material" : 0.5+ }+ ],+ "supported-platforms" : {+ "circles" : [+ "watchOS"+ ],+ "squares" : "shared"+ },+ "fill-specializations" : [+ {+ "value" : {+ "linear-gradient" : [+ "srgb:0.13333,0.82745,0.93333,1.00000",+ "srgb:0.01176,0.41176,0.63137,1.00000"+ ]+ }+ },+ {+ "appearance" : "dark",+ "value" : {+ "linear-gradient" : [+ "srgb:0.17255,0.17255,0.18039,1.00000",+ "srgb:0.03922,0.03922,0.03922,1.00000"+ ]+ }+ }+ ]+}diff --git a/brand/logo/ffmpeg-skill-wordmark-black.svg b/brand/logo/ffmpeg-skill-wordmark-black.svgnew file mode 100644index 0000000..86652b8--- /dev/null+++ b/brand/logo/ffmpeg-skill-wordmark-black.svg@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-3 -1000 5814 1300" role="img" aria-label="ffmpeg-skill"><path fill="#111111" d="M111 0V-520Q111 -582 138.0 -631.5Q165 -681 215.5 -711.0Q266 -741 337 -741Q390 -741 430.0 -723.5Q470 -706 499 -677L390 -568Q382 -577 370.5 -581.5Q359 -586 344 -586Q317 -586 301.0 -570.0Q285 -554 285 -527V0ZM7 -344V-489H423V-344ZM563 0V-520Q563 -582 590.0 -631.5Q617 -681 667.5 -711.0Q718 -741 789 -741Q842 -741 882.0 -723.5Q922 -706 951 -677L842 -568Q834 -577 822.5 -581.5Q811 -586 796 -586Q769 -586 753.0 -570.0Q737 -554 737 -527V0ZM459 -344V-489H875V-344ZM955 0V-489H1129V0ZM1262 0V-283Q1262 -314 1243.0 -331.5Q1224 -349 1196 -349Q1176 -349 1161.0 -341.0Q1146 -333 1137.5 -318.5Q1129 -304 1129 -283L1061 -310Q1061 -369 1087.0 -411.0Q1113 -453 1157.0 -476.0Q1201 -499 1257 -499Q1307 -499 1347.5 -475.5Q1388 -452 1412.0 -410.0Q1436 -368 1436 -311V0ZM1569 0V-283Q1569 -314 1550.0 -331.5Q1531 -349 1503 -349Q1484 -349 1468.5 -341.0Q1453 -333 1444.5 -318.5Q1436 -304 1436 -283L1334 -288Q1336 -354 1363.0 -401.0Q1390 -448 1437.5 -473.5Q1485 -499 1545 -499Q1602 -499 1647.0 -475.0Q1692 -451 1717.5 -405.5Q1743 -360 1743 -297V0ZM2125 10Q2078 10 2038.0 -7.0Q1998 -24 1972.0 -53.5Q1946 -83 1940 -122V-360Q1946 -399 1972.5 -430.5Q1999 -462 2038.5 -480.5Q2078 -499 2125 -499Q2196 -499 2250.0 -466.5Q2304 -434 2334.5 -376.0Q2365 -318 2365 -244Q2365 -171 2334.5 -113.5Q2304 -56 2250.0 -23.0Q2196 10 2125 10ZM1834 207V-489H2008V-366L1979 -248L2004 -129V207ZM2092 -145Q2121 -145 2143.0 -158.0Q2165 -171 2177.0 -193.5Q2189 -216 2189 -245Q2189 -274 2177.0 -296.0Q2165 -318 2143.0 -331.0Q2121 -344 2093 -344Q2066 -344 2044.0 -331.5Q2022 -319 2010.0 -296.5Q1998 -274 1998 -245Q1998 -216 2010.0 -193.5Q2022 -171 2043.5 -158.0Q2065 -145 2092 -145ZM2684 11Q2602 11 2539.0 -21.5Q2476 -54 2440.0 -112.0Q2404 -170 2404 -245Q2404 -319 2439.0 -376.5Q2474 -434 2534.5 -467.5Q2595 -501 2671 -501Q2745 -501 2802.5 -469.5Q2860 -438 2892.5 -382.5Q2925 -327 2925 -256Q2925 -241 2923.5 -225.5Q2922 -210 2917 -190L2486 -188V-300L2848 -303L2770 -254Q2769 -295 2758.0 -321.5Q2747 -348 2726.0 -362.0Q2705 -376 2673 -376Q2640 -376 2616.0 -360.0Q2592 -344 2579.0 -315.0Q2566 -286 2566 -245Q2566 -203 2580.0 -173.5Q2594 -144 2620.0 -129.0Q2646 -114 2684 -114Q2720 -114 2747.5 -126.0Q2775 -138 2797 -163L2888 -72Q2852 -31 2800.5 -10.0Q2749 11 2684 11ZM3199 222Q3118 222 3055.5 194.5Q2993 167 2958 117L3063 13Q3088 40 3118.0 55.5Q3148 71 3191 71Q3243 71 3273.5 45.5Q3304 20 3304 -28V-155L3332 -261L3307 -366V-489H3478V-34Q3478 44 3441.5 101.5Q3405 159 3342.0 190.5Q3279 222 3199 222ZM3191 -18Q3123 -18 3070.5 -49.5Q3018 -81 2988.0 -136.0Q2958 -191 2958 -259Q2958 -327 2988.0 -381.0Q3018 -435 3070.5 -467.0Q3123 -499 3191 -499Q3237 -499 3275.5 -482.5Q3314 -466 3338.0 -436.5Q3362 -407 3368 -368V-149Q3362 -110 3337.5 -80.5Q3313 -51 3275.0 -34.5Q3237 -18 3191 -18ZM3223 -169Q3251 -169 3271.5 -181.5Q3292 -194 3303.0 -214.5Q3314 -235 3314 -259Q3314 -284 3303.0 -304.0Q3292 -324 3272.0 -336.5Q3252 -349 3224 -349Q3197 -349 3176.5 -336.5Q3156 -324 3145.0 -303.5Q3134 -283 3134 -259Q3134 -236 3145.0 -215.5Q3156 -195 3176.0 -182.0Q3196 -169 3223 -169ZM3579 -181V-330H3940V-181Z"/><path fill="#0891B2" d="M4228 14Q4183 14 4139.5 2.0Q4096 -10 4058.5 -30.5Q4021 -51 3995 -78L4090 -175Q4114 -150 4147.5 -136.0Q4181 -122 4219 -122Q4241 -122 4252.5 -128.0Q4264 -134 4264 -145Q4264 -161 4247.5 -169.5Q4231 -178 4204.5 -184.5Q4178 -191 4149.0 -200.5Q4120 -210 4093.0 -226.0Q4066 -242 4049.5 -271.0Q4033 -300 4033 -345Q4033 -392 4058.5 -427.5Q4084 -463 4130.0 -483.5Q4176 -504 4238 -504Q4301 -504 4358.0 -482.5Q4415 -461 4450 -418L4354 -321Q4330 -348 4301.0 -358.5Q4272 -369 4248 -369Q4225 -369 4215.0 -362.5Q4205 -356 4205 -345Q4205 -332 4221.5 -324.0Q4238 -316 4264.5 -309.5Q4291 -303 4319.5 -293.0Q4348 -283 4374.5 -265.5Q4401 -248 4417.5 -219.0Q4434 -190 4434 -144Q4434 -71 4378.0 -28.5Q4322 14 4228 14ZM4827 0 4673 -256 4826 -489H5017L4827 -226L4832 -290L5027 0ZM4513 0V-729H4687V0ZM5075 0V-489H5250V0ZM5162 -546Q5123 -546 5097.0 -572.5Q5071 -599 5071 -639Q5071 -678 5097.0 -705.0Q5123 -732 5162 -732Q5203 -732 5228.5 -705.0Q5254 -678 5254 -639Q5254 -599 5228.5 -572.5Q5203 -546 5162 -546ZM5351 0V-729H5525V0ZM5627 0V-729H5801V0Z"/></svg>diff --git a/brand/logo/ffmpeg-skill-wordmark-white.svg b/brand/logo/ffmpeg-skill-wordmark-white.svgnew file mode 100644index 0000000..643c191--- /dev/null+++ b/brand/logo/ffmpeg-skill-wordmark-white.svg@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-3 -1000 5814 1300" role="img" aria-label="ffmpeg-skill"><path fill="#FFFFFF" d="M111 0V-520Q111 -582 138.0 -631.5Q165 -681 215.5 -711.0Q266 -741 337 -741Q390 -741 430.0 -723.5Q470 -706 499 -677L390 -568Q382 -577 370.5 -581.5Q359 -586 344 -586Q317 -586 301.0 -570.0Q285 -554 285 -527V0ZM7 -344V-489H423V-344ZM563 0V-520Q563 -582 590.0 -631.5Q617 -681 667.5 -711.0Q718 -741 789 -741Q842 -741 882.0 -723.5Q922 -706 951 -677L842 -568Q834 -577 822.5 -581.5Q811 -586 796 -586Q769 -586 753.0 -570.0Q737 -554 737 -527V0ZM459 -344V-489H875V-344ZM955 0V-489H1129V0ZM1262 0V-283Q1262 -314 1243.0 -331.5Q1224 -349 1196 -349Q1176 -349 1161.0 -341.0Q1146 -333 1137.5 -318.5Q1129 -304 1129 -283L1061 -310Q1061 -369 1087.0 -411.0Q1113 -453 1157.0 -476.0Q1201 -499 1257 -499Q1307 -499 1347.5 -475.5Q1388 -452 1412.0 -410.0Q1436 -368 1436 -311V0ZM1569 0V-283Q1569 -314 1550.0 -331.5Q1531 -349 1503 -349Q1484 -349 1468.5 -341.0Q1453 -333 1444.5 -318.5Q1436 -304 1436 -283L1334 -288Q1336 -354 1363.0 -401.0Q1390 -448 1437.5 -473.5Q1485 -499 1545 -499Q1602 -499 1647.0 -475.0Q1692 -451 1717.5 -405.5Q1743 -360 1743 -297V0ZM2125 10Q2078 10 2038.0 -7.0Q1998 -24 1972.0 -53.5Q1946 -83 1940 -122V-360Q1946 -399 1972.5 -430.5Q1999 -462 2038.5 -480.5Q2078 -499 2125 -499Q2196 -499 2250.0 -466.5Q2304 -434 2334.5 -376.0Q2365 -318 2365 -244Q2365 -171 2334.5 -113.5Q2304 -56 2250.0 -23.0Q2196 10 2125 10ZM1834 207V-489H2008V-366L1979 -248L2004 -129V207ZM2092 -145Q2121 -145 2143.0 -158.0Q2165 -171 2177.0 -193.5Q2189 -216 2189 -245Q2189 -274 2177.0 -296.0Q2165 -318 2143.0 -331.0Q2121 -344 2093 -344Q2066 -344 2044.0 -331.5Q2022 -319 2010.0 -296.5Q1998 -274 1998 -245Q1998 -216 2010.0 -193.5Q2022 -171 2043.5 -158.0Q2065 -145 2092 -145ZM2684 11Q2602 11 2539.0 -21.5Q2476 -54 2440.0 -112.0Q2404 -170 2404 -245Q2404 -319 2439.0 -376.5Q2474 -434 2534.5 -467.5Q2595 -501 2671 -501Q2745 -501 2802.5 -469.5Q2860 -438 2892.5 -382.5Q2925 -327 2925 -256Q2925 -241 2923.5 -225.5Q2922 -210 2917 -190L2486 -188V-300L2848 -303L2770 -254Q2769 -295 2758.0 -321.5Q2747 -348 2726.0 -362.0Q2705 -376 2673 -376Q2640 -376 2616.0 -360.0Q2592 -344 2579.0 -315.0Q2566 -286 2566 -245Q2566 -203 2580.0 -173.5Q2594 -144 2620.0 -129.0Q2646 -114 2684 -114Q2720 -114 2747.5 -126.0Q2775 -138 2797 -163L2888 -72Q2852 -31 2800.5 -10.0Q2749 11 2684 11ZM3199 222Q3118 222 3055.5 194.5Q2993 167 2958 117L3063 13Q3088 40 3118.0 55.5Q3148 71 3191 71Q3243 71 3273.5 45.5Q3304 20 3304 -28V-155L3332 -261L3307 -366V-489H3478V-34Q3478 44 3441.5 101.5Q3405 159 3342.0 190.5Q3279 222 3199 222ZM3191 -18Q3123 -18 3070.5 -49.5Q3018 -81 2988.0 -136.0Q2958 -191 2958 -259Q2958 -327 2988.0 -381.0Q3018 -435 3070.5 -467.0Q3123 -499 3191 -499Q3237 -499 3275.5 -482.5Q3314 -466 3338.0 -436.5Q3362 -407 3368 -368V-149Q3362 -110 3337.5 -80.5Q3313 -51 3275.0 -34.5Q3237 -18 3191 -18ZM3223 -169Q3251 -169 3271.5 -181.5Q3292 -194 3303.0 -214.5Q3314 -235 3314 -259Q3314 -284 3303.0 -304.0Q3292 -324 3272.0 -336.5Q3252 -349 3224 -349Q3197 -349 3176.5 -336.5Q3156 -324 3145.0 -303.5Q3134 -283 3134 -259Q3134 -236 3145.0 -215.5Q3156 -195 3176.0 -182.0Q3196 -169 3223 -169ZM3579 -181V-330H3940V-181Z"/><path fill="#22D3EE" d="M4228 14Q4183 14 4139.5 2.0Q4096 -10 4058.5 -30.5Q4021 -51 3995 -78L4090 -175Q4114 -150 4147.5 -136.0Q4181 -122 4219 -122Q4241 -122 4252.5 -128.0Q4264 -134 4264 -145Q4264 -161 4247.5 -169.5Q4231 -178 4204.5 -184.5Q4178 -191 4149.0 -200.5Q4120 -210 4093.0 -226.0Q4066 -242 4049.5 -271.0Q4033 -300 4033 -345Q4033 -392 4058.5 -427.5Q4084 -463 4130.0 -483.5Q4176 -504 4238 -504Q4301 -504 4358.0 -482.5Q4415 -461 4450 -418L4354 -321Q4330 -348 4301.0 -358.5Q4272 -369 4248 -369Q4225 -369 4215.0 -362.5Q4205 -356 4205 -345Q4205 -332 4221.5 -324.0Q4238 -316 4264.5 -309.5Q4291 -303 4319.5 -293.0Q4348 -283 4374.5 -265.5Q4401 -248 4417.5 -219.0Q4434 -190 4434 -144Q4434 -71 4378.0 -28.5Q4322 14 4228 14ZM4827 0 4673 -256 4826 -489H5017L4827 -226L4832 -290L5027 0ZM4513 0V-729H4687V0ZM5075 0V-489H5250V0ZM5162 -546Q5123 -546 5097.0 -572.5Q5071 -599 5071 -639Q5071 -678 5097.0 -705.0Q5123 -732 5162 -732Q5203 -732 5228.5 -705.0Q5254 -678 5254 -639Q5254 -599 5228.5 -572.5Q5203 -546 5162 -546ZM5351 0V-729H5525V0ZM5627 0V-729H5801V0Z"/></svg>