Skip to content

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.json
index 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.json
index 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.json
index 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.yml
index 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.md
index 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.json
index 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.md
index 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 film
diff --git a/skills/cinematic-film/references/film.md b/skills/cinematic-film/references/film.md
index 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"]`, `["grad
On 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.py
index 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 None
line("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.py
new file mode 100644
index 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()