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.

tests: the HTML export test runs alone in CI shards; site: absolute link-preview URLs

Favio Vázquez17c42ef77c7f
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 656453b..95b50e0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -85,6 +85,9 @@ All notable changes to showtime. Each entry says what changed and why, so this f
real renders); the README's Requirements, status table and badges say so ("tested: Intel Mac · Apple
Silicon · Linux x64 · Windows x64"), and that Windows 10/11 desktop editions and Linux arm64 have not
been run yet. A run on a physical Apple Silicon Mac is still welcome.
+- **Site link previews use absolute URLs.** `og:image` was a relative path, which link previews (Slack,
+ X, iMessage) cannot load. Every page now has an absolute `og:image`, `twitter:image` and `og:url` built from
+ `site_url` in `site/config.json` (or the repository's GitHub Pages address).
- **CI runs the fast suite in three shards per OS.** `run_all.py --shard I/N` runs one of N parts of the
test files, split by fixed per-file weights (`SHARD_WEIGHTS`, fast-suite seconds from a CI run; longest
first into the lightest part), so every machine computes the same split and each file runs exactly
@@ -92,6 +95,10 @@ All notable changes to showtime. Each entry says what changed and why, so this f
separate jobs on Ubuntu, Windows, Apple Silicon and, on the public repository, the Intel Mac
(`macos-15-intel`: the `macos-13` image is retired); shard 1 also runs the render smoke and the
path-with-spaces shims. On one 2-core runner the suite took 23 to 31 minutes per OS.
+- **The HTML export test runs alone** (`SERIAL` in `run_all.py`). Its player checks watch playback in real
+ time; on the public 4-core runners, sharing the machine with another file's Chrome left the player
+ drawing 1 to 4 frames in the 1.5 s window on Windows and the Intel Mac. A file in `SERIAL` counts double
+ when the shards are balanced.
### Changed: the examples have their own repository
diff --git a/site/build.py b/site/build.py
index a390cf6..64560ba 100644
--- a/site/build.py
+++ b/site/build.py
@@ -375,6 +375,16 @@ THEME_BOOT = ("<script>try{var t=localStorage.getItem('st-theme');if(t==='light'
"document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>")
+def site_url(repo: str) -> str:
+ """The published site's address, ending in '/': config.json "site_url", else GitHub Pages for the repo
+ (https://owner.github.io/name/), else '' (a local build keeps relative URLs)."""
+ u = (CONFIG.get("site_url") or "").strip()
+ if not u and repo and "/" in repo:
+ owner, name = repo.split("/", 1)
+ u = "https://%s.github.io/%s/" % (owner.lower(), name)
+ return (u.rstrip("/") + "/") if u else ""
+
+
def shell(site: Site, page: str, title: str, body: str, active: str = "", desc: str = "") -> str:
r = lambda p: rel(page, p) # noqa: E731
fav = site.copy_asset(REPO / "assets/brand/icon/favicon.svg")
@@ -386,6 +396,10 @@ def shell(site: Site, page: str, title: str, body: str, active: str = "", desc:
links += '<a href="https://github.com/%s">GitHub</a>' % esc(site.repo)
full = title if title.startswith("showtime") else "%s \u00b7 showtime" % title
d = desc or CONFIG.get("description", "")
+ # link previews (Slack, X, iMessage ...) need absolute URLs: the published site's address + the page's path
+ base = site_url(site.repo)
+ og_abs = (base + og) if base else r(og)
+ page_abs = (base + (page[:-len("index.html")] if page.endswith("index.html") else page)) if base else ""
return """<!doctype html>
<html lang="en">
<head>
@@ -395,10 +409,11 @@ def shell(site: Site, page: str, title: str, body: str, active: str = "", desc:
<meta name="description" content="{desc}">
<meta property="og:title" content="{title}">
<meta property="og:description" content="{desc}">
-<meta property="og:image" content="{og}">
+<meta property="og:image" content="{og_abs}">{og_url}
<meta property="og:image:width" content="1280">
<meta property="og:image:height" content="640">
<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:image" content="{og_abs}">
<meta name="theme-color" content="#15100E" media="(prefers-color-scheme: dark)">
<meta name="theme-color" content="#FBF6EE" media="(prefers-color-scheme: light)">
<link rel="icon" href="{fav}" type="image/svg+xml">
@@ -426,7 +441,8 @@ def shell(site: Site, page: str, title: str, body: str, active: str = "", desc:
<script src="{js}"></script>
</body>
</html>
-""".format(title=esc(full), desc=esc(d), og=r(og), fav=r(fav), touch=r(touch), css=r("static/style.css"), boot=THEME_BOOT,
+""".format(title=esc(full), desc=esc(d), og_abs=esc(og_abs),
+ og_url=('\n<meta property="og:url" content="%s">' % esc(page_abs)) if page_abs else "", fav=r(fav), touch=r(touch), css=r("static/style.css"), boot=THEME_BOOT,
root="../" * page.count("/"), home=r("index.html"), menu=ICON_MENU, links=links, sun=ICON_SUN, body=body,
version=esc(CONFIG.get("version", "")), docs=r("docs/index.html"), gallery=r("gallery.html"), crew=r("crew.html"),
js=r("static/app.js"), font=r("static/fonts/inter.woff2"),
diff --git a/site/config.json b/site/config.json
index 6abf4b9..b07db69 100644
--- a/site/config.json
+++ b/site/config.json
@@ -1,5 +1,7 @@
{
"repo": "FavioVazquez/showtime",
+ "site_url": "https://faviovazquez.github.io/showtime/",
+ "_site_url": "The published address: link previews (og:image, og:url, twitter:image) need absolute URLs. Empty: derived from the repo (GitHub Pages).",
"_repo": "owner/name on GitHub. CI passes $GITHUB_REPOSITORY, which wins; the site is served at https://faviovazquez.github.io/showtime/.",
"examples_repo": "FavioVazquez/showtime-examples",
"examples_dir": "../showtime-examples/examples",
diff --git a/skills/showtime/tests/run_all.py b/skills/showtime/tests/run_all.py
index 1fc2484..c7464ac 100755
--- a/skills/showtime/tests/run_all.py
+++ b/skills/showtime/tests/run_all.py
@@ -47,16 +47,20 @@ from st import platform as plat # noqa: E402
from st.launcher import build_env, showtime_home # noqa: E402
# Test files that must not run while another test file runs, with the reason. They run one after
-# another once the parallel batch is done. Empty today: every file isolates its temp/scratch folders,
-# binds free ports and writes the shared caches atomically. Add a file here (with its reason) rather
-# than letting it flake under -j.
-SERIAL: dict = {}
+# another once the parallel batch is done. Every file isolates its temp/scratch folders, binds free
+# ports and writes the shared caches atomically, so only timing-sensitive files belong here. Add a file
+# here (with its reason) rather than letting it flake under -j.
+SERIAL: dict = {
+ "test_export.py": "its HTML player checks watch playback in real time (frames drawn, picture against the "
+ "sound clock); on a 4-core CI runner another file's Chrome starves them",
+}
MAX_AUTO_JOBS = 8
# Seconds per file in the fast suite (the slowest of Ubuntu, Windows and macOS arm64 on 2-core GitHub
# runners, September 2026). Used only to balance --shard parts, so they need to be roughly right, not
-# current; a file missing here weighs SHARD_DEFAULT_WEIGHT.
+# current; a file missing here weighs SHARD_DEFAULT_WEIGHT, and a file in SERIAL counts double (it runs
+# alone, while the others share the machine).
SHARD_WEIGHTS = {
"test_render.py": 363, "test_motion.py": 308, "test_export.py": 294, "test_capture.py": 198,
"test_audio.py": 185, "test_footage.py": 133, "test_qa.py": 131, "test_voice.py": 102,
@@ -164,7 +168,9 @@ def parse_shard(v: str) -> tuple:
def shard_parts(names: list, n: int, weights: dict = None) -> list:
"""Split file names into n parts: heaviest first, each into the currently lightest part (ties: the
lower-numbered part). Deterministic: depends only on the names and the weights."""
- weights = SHARD_WEIGHTS if weights is None else weights
+ if weights is None:
+ weights = {k: v * (2 if k in SERIAL else 1) for k, v in SHARD_WEIGHTS.items()}
+ weights.update({k: 2 * SHARD_DEFAULT_WEIGHT for k in SERIAL if k not in SHARD_WEIGHTS})
w = lambda name: float(weights.get(name, SHARD_DEFAULT_WEIGHT)) # noqa: E731
parts, loads = [[] for _ in range(n)], [0.0] * n
for name in sorted(set(names), key=lambda x: (-w(x), x)):
diff --git a/skills/showtime/tests/test_skill_structure.py b/skills/showtime/tests/test_skill_structure.py
index 5194d2c..2ef34c6 100644
--- a/skills/showtime/tests/test_skill_structure.py
+++ b/skills/showtime/tests/test_skill_structure.py
@@ -400,6 +400,14 @@ class TestRunAllShards(unittest.TestCase):
self.assertEqual(sorted(len(set(p) & set(heavy)) for p in ra.shard_parts(list(ra.SHARD_WEIGHTS), 3)),
[1, 1, 1], "the three heaviest files share a part")
+ def test_serial_files_count_double(self):
+ ra = self.ra
+ ra.SERIAL = {"test_b.py": "runs alone"}
+ ra.SHARD_WEIGHTS = {"test_a.py": 100, "test_b.py": 60, "test_c.py": 50, "test_d.py": 50}
+ # b runs alone, so it weighs 120 and goes first: b (120) + d (50) against a (100) + c (50)
+ self.assertEqual(ra.shard_parts(["test_a.py", "test_b.py", "test_c.py", "test_d.py"], 2),
+ [["test_b.py", "test_d.py"], ["test_a.py", "test_c.py"]])
+
def test_parse_shard(self):
ra = self.ra
self.assertEqual(ra.parse_shard("2/3"), (2, 3))