Agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, maps and cards, timed to the voice. Claude Code, Codex, Cursor, Gemini CLI.
Fetch open-licensed fonts where Linux and Windows lack the Mac faces
Moh4696d4062be855d1
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex fda0dad..c9ee1b1 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -9,7 +9,7 @@{"name": "cinematic-skill","description": "An agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, documents, cards and maps, every stamp, highlight and number landing on the narrator's word. Documentaries, product launches, brand stories, explainers.",- "version": "1.0.0",+ "version": "1.0.1","source": "./","author": {"name": "exploraX",diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.jsonindex 606182d..a0c2e26 100644--- a/.codex-plugin/plugin.json+++ b/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "cinematic-skill",- "version": "1.0.0",+ "version": "1.0.1","description": "An agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, documents, cards and maps, every stamp, highlight and number landing on the narrator's word. Documentaries, product launches, brand stories, explainers.","author": {"name": "exploraX",diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.jsonindex 664cc4f..9cc1af4 100644--- a/.cursor-plugin/plugin.json+++ b/.cursor-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "cinematic-skill",- "version": "1.0.0",+ "version": "1.0.1","description": "An agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, documents, cards and maps, every stamp, highlight and number landing on the narrator's word. Documentaries, product launches, brand stories, explainers.","author": {"name": "exploraX"diff --git a/.github/workflows/check.yml b/.github/workflows/check.ymlindex 7540291..c2a6632 100644--- a/.github/workflows/check.yml+++ b/.github/workflows/check.yml@@ -47,6 +47,8 @@ jobs:run: |S=skills/cinematic-film/scripts; P="$RUNNER_TEMP/film"python $S/new_project.py "$P"+ python $S/get_fonts.py --project "$P"+ test -s "$P/fonts/cond.ttf"python $S/make_beats.py --project "$P"python $S/prep_assets.py --project "$P"python $S/tts_say.py --project "$P"diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 940c17b..13ba987 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,5 +1,9 @@# Changelog+## 1.0.1 (2026-11-09)++- `get_fonts.py` fetches open-licensed fonts (Bebas Neue, Homemade Apple) for text roles that Linux and Windows cannot match, so labels, stamps and handwriting keep their look. `check_setup.py` points to it.+## 1.0.0 (2026-11-09)First release: `cinematic-film`, narrated cinematic films drawn entirely in code, on any subject.diff --git a/gemini-extension.json b/gemini-extension.jsonindex 659d0ef..1216741 100644--- a/gemini-extension.json+++ b/gemini-extension.json@@ -1,5 +1,5 @@{"name": "cinematic-skill",- "version": "1.0.0",+ "version": "1.0.1","description": "An agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, documents, cards and maps, every stamp, highlight and number landing on the narrator's word. Documentaries, product launches, brand stories, explainers."}diff --git a/skills/cinematic-film/SKILL.md b/skills/cinematic-film/SKILL.mdindex 52a418c..9e85e70 100644--- a/skills/cinematic-film/SKILL.md+++ b/skills/cinematic-film/SKILL.md@@ -14,6 +14,7 @@ Built from a 5:22 documentary about Al Capone, then opened up to any subject. Th| File | What it does || --- | --- || `scripts/check_setup.py` | Checks Python, skia-python, ffmpeg, fonts and memory; says what to install |+| `scripts/get_fonts.py` | Fetches open-licensed fonts (Bebas Neue, Homemade Apple) for any text role this machine lacks || `scripts/new_project.py` | Starts a project from `assets/template/` (a runnable explainer), or the documentary example with `--example` || `scripts/make_beats.py` | Writes `beats.md`, the table you approve; lints chronology, line length, digits in spoken text || `scripts/tts_say.py` | Free scratch voice (macOS `say`, espeak-ng, or any TTS command) to time the film before the final voice |@@ -28,7 +29,7 @@ Built from a 5:22 documentary about Al Capone, then opened up to any subject. Th| `scripts/mix_soundtrack.py` | Voice, effects and optional music, ducked and loudness-normalised || `scripts/burn_captions.py` | Burns one of four caption styles into the finished film and writes an SRT |-Needs Python 3.9+, `pip install skia-python numpy pillow` (scipy optional) and ffmpeg. Run `scripts/check_setup.py` first. All commands take `--project <folder>`.+Needs Python 3.9+, `pip install skia-python numpy pillow` (scipy optional) and ffmpeg. Run `scripts/check_setup.py` first; on Linux or Windows, also run `scripts/get_fonts.py` per project. All commands take `--project <folder>`.## Pick the filmdiff --git a/skills/cinematic-film/references/film.md b/skills/cinematic-film/references/film.mdindex ef99fe4..2664bef 100644--- a/skills/cinematic-film/references/film.md+++ b/skills/cinematic-film/references/film.md@@ -86,7 +86,7 @@ Change the finish with `film.look["grain"]`, `["glow"]`, `["vignette"]`, `["gradOn light looks, use dark type and `BigText(grunge=False, shadow=False)` for a clean finish. Use `Print(pin=False)` for photos that should sit like prints on a table, not pinned evidence.-Font roles are `cond` (labels, numbers, stamps), `label` and `labelm` (map labels, captions), `serif` (documents), `mono` (typewriter), `hand` (handwriting). Each falls back through common fonts. Put a file at `fonts/<role>.ttf` in the project to force one, for example Oswald Bold (OFL) as `cond` on Linux. `check_setup.py` prints what each role resolves to.+Font roles are `cond` (labels, numbers, stamps), `label` and `labelm` (map labels, captions), `serif` (documents), `mono` (typewriter), `hand` (handwriting). Each falls back through common fonts. Put a file at `fonts/<role>.ttf` in the project to force one, for example Oswald Bold (OFL) as `cond` on Linux. `check_setup.py` prints what each role resolves to, and `get_fonts.py` fetches Bebas Neue (condensed) and Homemade Apple (handwriting) for any role that would fall back to the system default.Colour on dark looks: white or cream type. Dark ink goes only on paper, cards or a full yellow block (`bar_h=0.92`).diff --git a/skills/cinematic-film/scripts/check_setup.py b/skills/cinematic-film/scripts/check_setup.pyindex 93bed8b..baa1581 100644--- a/skills/cinematic-film/scripts/check_setup.py+++ b/skills/cinematic-film/scripts/check_setup.py@@ -57,6 +57,8 @@ if "skia" in mods:for role in FONT_ROLES:tf, desc = resolve_typeface(role)print(f" {role:<7} {desc}")+ if any(resolve_typeface(r)[1].startswith("system default") for r in FONT_ROLES):+ print(" -> run get_fonts.py --project <folder> to fetch open-licensed replacements")voice = "say" if shutil.which("say") else "espeak-ng" if shutil.which("espeak-ng") else Noneline("ok" if voice else "--", f"scratch voice: {voice}" if voice else "no local voice for scratch tracks",diff --git a/skills/cinematic-film/scripts/get_fonts.py b/skills/cinematic-film/scripts/get_fonts.pynew file mode 100644index 0000000..0542cb0--- /dev/null+++ b/skills/cinematic-film/scripts/get_fonts.py@@ -0,0 +1,51 @@+#!/usr/bin/env python3+"""Fetch open-licensed fonts for any text role this machine cannot match (Linux and Windows lack the+Mac faces the looks were designed with), into <project>/fonts/<role>.ttf where the engine finds them.++ python3 get_fonts.py --project my-film # only roles that would fall back to the system default+ python3 get_fonts.py --project my-film --force # replace them all++ cond -> Bebas Neue (SIL Open Font License): condensed caps for labels, numbers, stamps, captions+ hand -> Homemade Apple (Apache 2.0): handwriting for ledger entries++Both come from the Google Fonts repository on GitHub. Keep the licence notes with the project if+you share it.+"""+import argparse+import pathlib+import sys+import urllib.request++HERE = pathlib.Path(__file__).resolve().parent+sys.path.insert(0, str(HERE))+UA = "cinematic-film/1.0 (+https://github.com/Moh4696/cinematic-skill)"+FONTS = {+ "cond": ("https://raw.githubusercontent.com/google/fonts/main/ofl/bebasneue/BebasNeue-Regular.ttf", "Bebas Neue", "SIL Open Font License 1.1"),+ "hand": ("https://raw.githubusercontent.com/google/fonts/main/apache/homemadeapple/HomemadeApple-Regular.ttf", "Homemade Apple", "Apache License 2.0"),+}+++def main():+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)+ ap.add_argument("--project", required=True)+ ap.add_argument("--force", action="store_true")+ a = ap.parse_args()+ from engine import resolve_typeface+ fdir = pathlib.Path(a.project) / "fonts"; fdir.mkdir(parents=True, exist_ok=True)+ notes = []+ for role, (url, name, lic) in FONTS.items():+ _, desc = resolve_typeface(role, fdir)+ if not a.force and not desc.startswith("system default"):+ print(f"{role:<5} already {desc}"); continue+ req = urllib.request.Request(url, headers={"User-Agent": UA})+ with urllib.request.urlopen(req, timeout=60) as r:+ (fdir / f"{role}.ttf").write_bytes(r.read())+ print(f"{role:<5} -> fonts/{role}.ttf ({name}, {lic})")+ notes.append(f"{role}.ttf: {name}, {lic}, from {url}")+ if notes:+ with open(fdir / "LICENSES.txt", "a") as f:+ f.write("\n".join(notes) + "\n")+++if __name__ == "__main__":+ main()