kinescript

One brand, every video.

A brand is a folder: brand.json with palettes, fonts, text styles, chart colours, logos and where they go, motion, an intro and outro, sound defaults and a grade, beside its logo, font and sound files. A scene names it in one line, and the built-ins draw in it.

One scene, the brand's light and dark palettes

A title card, a bar chart, a pie chart, a caption, a lower third, a logo bug and a closing logo. Both videos are in the made-up Tidewater brand, its logo included; the two scene files differ in their "variant" line. kine check knows the brand too: it reports text and chart colours below the contrast they need, a logo drawn too small, and a scene changing a part the brand locks.

The two videos side by side, in step.
0.0 s
  1. bug
  2. title
  3. sales
  4. mix
  5. note
  6. who
  7. end
0.0 s
  1. bug
  2. title
  3. sales
  4. mix
  5. note
  6. who
  7. end
brand-tidewater-dark.jsonagainst brand-tidewater.json
 {   "canvas": {"w": 1920, "h": 1080, "fps": 30, "poster": 1.2},   "brand": "brands/tidewater",-  "variant": "light",+  "variant": "dark",   "layers": [     {"use": "bug", "id": "bug", "until": "who.in"},     {"use": "titleCard", "id": "title", "kicker": "Quarterly review", "title": "Tides **rising**",
brands/tidewater/brand.jsonthe Tidewater brand
{  "kinescriptBrand": 1,  "id": "tidewater",  "name": "Tidewater (a made-up brand for the examples)",  "default": "light",  "palettes": {    "light": {"bg": "#f4f1ea", "surface": "#e3ddd0", "text": "#14303a", "muted": "#5e6f73",              "accent": "#e0573a", "accent2": "#1f7a78", "positive": "#1f7a78", "negative": "#b3261e"},    "dark": {"bg": "#0f2228", "surface": "#1c3640", "text": "#f4f1ea", "muted": "#9fb1b3",             "accent": "#ff7a5c", "accent2": "#5cc8c2", "positive": "#5cc8c2", "negative": "#ff6b61"}  },  "fonts": {    "display": {"family": "IBM Plex Mono"},    "body": {"family": "Space Grotesk"},    "mono": {"family": "IBM Plex Mono"}  },  "text": {    "title": {"size": 112, "weight": 700, "tracking": -2},    "caption": {"case": "upper", "tracking": 3, "weight": 600}  },  "charts": {    "series": ["accent", "accent2", "#a8741a", "muted"],    "color": "accent2",    "highlight": "accent",    "axis": {"color": "muted", "width": 2}  },  "logos": {    "full": {"file": "logos/full.svg", "onDark": "logos/full-dark.svg", "alt": "Tidewater"},    "mark": {"file": "logos/mark.svg", "onDark": "logos/mark-dark.svg", "alt": "Tidewater"},    "clearSpace": 0.25,    "minHeight": 40  },  "placements": {    "corner": {"anchor": "topright", "margin": "4%", "height": "7%"},    "closing": {"anchor": "center", "height": "14%"}  },  "bug": {"logo": "mark", "placement": "corner", "opacity": 0.9},  "intro": {"tagline": "Across the sound since 1952", "dur": 2},  "outro": {"title": "Thanks for riding", "subtitle": "Tidewater Ferries", "url": "tidewater.example", "dur": 3},  "motion": {"enter": "rise", "exit": "fade"},  "components": {    "lowerThird": {"plate": "surface", "subColor": "accent2"},    "titleCard": {"accent": "accent2"}  },  "lock": ["palettes"]}

The brand editor: kine brand wizard

A page on 127.0.0.1 to see and change a brand: palettes with their contrast, type, logos and placements, intro and outro, sound, a gallery of the built-ins drawn in the brand, and the raw file. Every change is saved at once and checked; the gallery is drawn by the real renderer. kine brand and the kine_brand MCP tool make every change it makes, the same way, so an agent can do all of it too.

0.0 s
Recorded with Overshoulder driving the editor. A pale yellow accent falls to 1.4:1 against the background and the editor flags it; a purple that passes clears the warnings, and the gallery redraws in it.
The Colours tab: the light palette's eight roles as swatches with hex fields, a contrast table of the pairs a video reads most with each ratio and whether it passes, and the chart series with their ratios.
Colours: each palette's roles, the contrast of the pairs a video reads most, and the chart series against the background.
The Gallery tab: a sample frame, the palette, the type styles, a title card, a lower third, a callout and the bar, line and pie charts, all drawn in the Tidewater light palette.
Gallery: every built-in drawn in the brand by the renderer, in the palette picked at the top.
The Type tab: the display, body and mono faces with their families and licence fields, a table of text styles (body, caption, heading, label, title) with font, size, weight, tracking and case, and a sample drawn by the renderer.
Type: the three faces, uploaded font files, and the text styles a layer names with "textStyle".
The Logos tab: the full logo and the mark, each with a file for light and for dark backgrounds and alt text, clear space and minimum height, and the placements table with a frame to click where a placement goes.
Logos: a file for light and dark backgrounds, clear space and minimum size, and placements set by clicking on a frame.

Brands live in a library, ~/.kinescript/brands. kine brand use acme (the editor's Use in project) copies one into the project's brand/ folder and records what it copied, so a video keeps the brand it was made with until you run it again. It refuses to replace a copy edited in the project unless --force.

Text styles
A text layer takes "textStyle": "heading" for the brand's font, size, weight, tracking and case; its own keys still win. Built-in titles take the display face and other text the body face.
Intro and outro
"intro": true on a scene plays the brand's sting first and "outro": true its end card last, each rendered as its own segment and joined to the video, with a sonic logo if the brand has one.
Sound and grade
Per role defaults: the voice backend and speaker, a music bed with its gain and fades, the mix's loudness and ducking. A brand grade gives every video the same colour grade.
From a logo
kine brand import acme logos/full.svg proposes light and dark palettes and chart series from a logo's colours, each text and accent moved until it passes the contrast check; --apply writes them.
Locks
"lock": ["palettes", "fonts"] stops a scene's own theme from changing those parts; kine check reports the scene that tries.
Checked writes
Each write checks the brand and refuses a change that breaks it, and --rev refuses it when the brand changed since it was read, so a person in the editor and an agent over MCP do not overwrite each other.

kine brand

The same operations from the command line and, as kine_brand, over MCP.

  • init acmea new brand, from the Kinescript brand or --from another
  • list / showthe library, and one brand's resolved values
  • use acmecopies it into the project's brand/
  • set acme PATH VALUEchanges one value, such as palettes.dark.accent
  • replace acme FILEreplaces brand.json, checked first
  • add-file / remove-filefonts, logos and sound files, their contents checked
  • check acmethe brand's own problems
  • preview acmea sample frame in the brand, as an image
  • import acme LOGOpalettes proposed from a logo
  • wizardthe brand editor above