Skip to content

A local video studio for your coding agent. Describe a video in one sentence: your agent directs, your machine renders. Claude Code, Codex, Cursor, Devin and more. No API keys, no uploads.

showtime 0.3.4

Favio Vázquez205c4f1aaca9
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index edcd8d1..48c4510 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -5,14 +5,14 @@
},
"metadata": {
"description": "showtime: a local video studio for your coding agent",
- "version": "0.3.3"
+ "version": "0.3.4"
},
"plugins": [
{
"name": "showtime",
"source": "./",
"description": "A local video studio for your coding agent. Describe a video. Your agent directs. Your machine renders. Motion graphics, voice-over, music, footage editing, captions and platform-ready exports, with no cloud AI services or API keys.",
- "version": "0.3.3",
+ "version": "0.3.4",
"author": {
"name": "Favio Vazquez"
},
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index aa3f81e..7ce870f 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "showtime",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "A local video studio for your coding agent. Describe a video. Your agent directs. Your machine renders. Motion graphics rendered frame-exactly, voice-over, music and sound design, footage editing from transcripts, captions and platform-ready exports. Everything runs on your machine.",
"author": {
"name": "Favio Vazquez"
diff --git a/CHANGELOG.md b/CHANGELOG.md
index dfb04eb..3f352bd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,25 @@ All notable changes to showtime. Each entry says what changed and why, so this f
`skills/showtime/lib/st/__init__.py` and `python3 scripts/check_release.py` keeps the plugin manifests, the registry files and
`setup/package.json` in sync with it.
+## 0.3.4 (2026-10-02)
+
+- **Frame 0 of a page with CSS animations could show where the animation had got to in real time.**
+ The stage paused CSS animations and Web Animations at the first seek, but by then they had been running
+ since page load, and transform/opacity animations run on the compositor: pausing them there left the
+ last real-time value on screen until the property changed again, so the first capture had an element a
+ few pixels along (the css-clock fixture's dot was 12 px out at t=0 on about half the runs, which the
+ nightly reported as `frames differ when reached in another order or after a pause (0s)`), and layers
+ that had been animated on the compositor rasterised differently depending on the frames seeked before
+ (the Windows `raster noise` verdict). In render mode `stage.js` now holds every animation from the
+ start (`animation-play-state: paused` in an adopted style sheet, and `Element.animate()` returns a
+ paused animation), so nothing runs before the first seek and a frame depends only on t;
+ `data-st-free` elements are left alone as before.
+- **A seeked `<video>` could be captured before its new frame was on screen.** `seekOne` waited for
+ `seeked` and one frame, but the frame reaches the compositor after `seeked`, so a slow machine captured
+ the previous frame: a black frame 0 in an adopted Python render (qa `first_frame_black` on macOS) and
+ "frames depend on seek order" in `check` for a captured video on Windows. The seek now also waits for
+ the frame to be presented (`requestVideoFrameCallback`), or 500 ms after `seeked` if it never comes.
+
## 0.3.3 (2026-10-02)
Behaviour changes to know about (all deliberate, all security or correctness):
diff --git a/gemini-extension.json b/gemini-extension.json
index f7921ad..271e637 100644
--- a/gemini-extension.json
+++ b/gemini-extension.json
@@ -1,6 +1,6 @@
{
"name": "showtime",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "A local video studio for your coding agent. Describe a video. Your agent directs. Your machine renders. Motion graphics, voice-over, music, footage editing, captions and platform-ready exports, with no cloud AI services or API keys.",
"mcpServers": {
"showtime": {
diff --git a/packages/npm/package.json b/packages/npm/package.json
index 3af1a91..dc2645c 100644
--- a/packages/npm/package.json
+++ b/packages/npm/package.json
@@ -1,6 +1,6 @@
{
"name": "@faviovazquez/showtime-mcp",
- "version": "0.3.3",
+ "version": "0.3.4",
"mcpName": "io.github.FavioVazquez/showtime",
"description": "A local video studio for your coding agent: showtime's MCP server and command line. Describe a video. Your agent directs. Your machine renders.",
"license": "MIT",
diff --git a/plugin.json b/plugin.json
index 62fdf06..c9b1740 100644
--- a/plugin.json
+++ b/plugin.json
@@ -1,7 +1,7 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "showtime",
- "version": "0.3.3",
+ "version": "0.3.4",
"description": "A local video studio for your coding agent. Describe a video. Your agent directs. Your machine renders. Motion graphics, voice-over, music, footage editing, captions and platform-ready exports, with no cloud AI services or API keys.",
"author": {
"name": "Favio Vazquez",
diff --git a/server.json b/server.json
index 70bb74c..33ac7c4 100644
--- a/server.json
+++ b/server.json
@@ -3,7 +3,7 @@
"name": "io.github.FavioVazquez/showtime",
"title": "showtime",
"description": "Local video studio for your coding agent: scenes, voice, music and captions, on your machine.",
- "version": "0.3.3",
+ "version": "0.3.4",
"websiteUrl": "https://faviovazquez.github.io/showtime/",
"repository": {
"url": "https://github.com/FavioVazquez/showtime",
@@ -26,7 +26,7 @@
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"identifier": "@faviovazquez/showtime-mcp",
- "version": "0.3.3",
+ "version": "0.3.4",
"runtimeHint": "npx",
"transport": {
"type": "stdio"
diff --git a/skills/showtime/lib/st/__init__.py b/skills/showtime/lib/st/__init__.py
index 1e19d11..f8403e5 100644
--- a/skills/showtime/lib/st/__init__.py
+++ b/skills/showtime/lib/st/__init__.py
@@ -5,4 +5,4 @@ launcher, installer and doctor import (st.platform, st.common, st.ff,
st.doctor) are stdlib-only and Python 3.8+ compatible; everything else runs
inside the showtime virtualenv (~/.showtime/venv, Python 3.12).
"""
-__version__ = "0.3.3"
+__version__ = "0.3.4"
diff --git a/skills/showtime/runtime/stage.js b/skills/showtime/runtime/stage.js
index 4e6906d..f87a822 100644
--- a/skills/showtime/runtime/stage.js
+++ b/skills/showtime/runtime/stage.js
@@ -443,6 +443,27 @@
} catch (e) { reportError('animation seek', e); }
}
};
+ // Render mode: animations start held, not running. One that runs from page load until the
+ // first seek goes to the compositor (transform, opacity), and pausing it there leaves the
+ // last real-time value on screen until the property changes again: frame 0 came out with
+ // the element a few pixels along, and composited layers were rasterised differently depending
+ // on the frames seeked before ("raster noise"). Held from the start, a frame depends only on t.
+ function holdAnimations() {
+ var FREE = ':not([data-st-free],[data-st-free] *)';
+ try {
+ var sheet = new CSSStyleSheet();
+ sheet.replaceSync(FREE + ',' + FREE + '::before,' + FREE + '::after' +
+ '{animation-play-state:paused!important}');
+ document.adoptedStyleSheets = document.adoptedStyleSheets.concat([sheet]);
+ } catch (e) { reportError('animation hold', e); }
+ var animate = W.Element && W.Element.prototype.animate;
+ if (typeof animate !== 'function') return;
+ W.Element.prototype.animate = function () {
+ var a = animate.apply(this, arguments);
+ try { if (!(this.closest && this.closest('[data-st-free]'))) a.pause(); } catch (e) { /* ignore */ }
+ return a;
+ };
+ }
// <video>: seek to the middle of the source frame and wait for 'seeked'.
function videoTarget(v, t) {
@@ -504,14 +525,24 @@
var target = videoTarget(v, t); // again: the duration is known now
if (Math.abs(v.currentTime - target) < 1e-4 && !v.seeking) return null;
return new Promise(function (res) {
+ // 'seeked' comes before the new frame reaches the compositor: a capture right after it can
+ // still show the previous frame (black for the first one) on a slow machine. The wait also
+ // takes the frame being presented (requestVideoFrameCallback, which fires after every seek of
+ // a file with a picture), or 500 ms after 'seeked' if it never comes.
+ var seeked = false, shown = typeof v.requestVideoFrameCallback !== 'function' || !v.videoWidth, timer = null;
+ function end() {
+ real.clearTimeout(timer);
+ v.removeEventListener('seeked', done); v.removeEventListener('error', end); res();
+ }
// a 'seeked' that belongs to an earlier seek can still be queued: only ours ends the wait
function done() {
if (v.seeking) return;
- v.removeEventListener('seeked', done); v.removeEventListener('error', fail); res();
+ seeked = true;
+ if (shown) end(); else if (!timer) timer = real.setTimeout(end, 500);
}
- function fail() { v.removeEventListener('seeked', done); v.removeEventListener('error', fail); res(); }
+ if (!shown) v.requestVideoFrameCallback(function () { shown = true; if (seeked) end(); });
v.addEventListener('seeked', done);
- v.addEventListener('error', fail);
+ v.addEventListener('error', end);
v.currentTime = target;
});
}).then(function () { return videoData(v); });
@@ -919,6 +950,7 @@
if (RENDER) {
installShim(RENDER.seed);
+ holdAnimations();
return;
}
diff --git a/skills/showtime/setup/package.json b/skills/showtime/setup/package.json
index d1890ee..3e63c7e 100644
--- a/skills/showtime/setup/package.json
+++ b/skills/showtime/setup/package.json
@@ -1,6 +1,6 @@
{
"name": "showtime-runtime",
- "version": "0.3.3",
+ "version": "0.3.4",
"private": true,
"description": "Node dependencies for showtime (installed by setup.py into ~/.showtime/node). Versions are pinned exactly. Icon sets are not installed here: they are fetched per icon on first use (manifest.json \"icon_packs\").",
"license": "MIT",