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.

17.5 KB
Raw Blame
{
  "_about": "The X-ray page (site/build.py build_xray, the page xray/index.html): its hero, the three steps and the gallery. Each entry is one verified X-ray film. Its video and poster are looked up as examples/_xray/<file> (in this checkout, the examples checkout, or a --media-from folder, by path or by release asset name, like every example video) and copied to media/xray/<file>; a missing video shows the poster, a missing poster a neutral card. The hero entry may name a \"loop\": a short silent cut it loops instead of the whole film. An entry with an empty receipt is shown as \"in the works\": no player and no commands, because nothing appears as finished without its `showtime xray verify` line. author is \"showtime\" for ours or a GitHub handle (\"@name\") for a community entry; mechanism names a folder of skills/showtime/library/xray/, linked when it exists. An entry may name \"live\", its live page (the file `showtime export html <project> --interactive` writes), looked up and copied like the video: a finished card then has a \"Play it live\" button that swaps its frame for the page, and an Embed snippet. \"prompt\" is one sentence, the request an agent would be given to make that film; it is shown, with a Copy button, above the commands.",
  "hero": "typewriter-through-dark-16x9",
  "_kinds": "The kind filter: an entry's kind is one of these ids.",
  "kinds": [
    {
      "id": "machines",
      "name": "Machines"
    },
    {
      "id": "instruments",
      "name": "Instruments"
    }
  ],
  "_layouts": "How an entry's layout is named on its card.",
  "layouts": {
    "through": "see-through",
    "split": "beside the clip",
    "diagram": "living diagram",
    "score": "score",
    "tab": "guitar tab",
    "drums": "drum sheet"
  },
  "entries": [
    {
      "id": "typewriter-through-dark-16x9",
      "title": "A typewriter, seen through",
      "object": "Underwood 315 portable typewriter",
      "kind": "machines",
      "mechanism": "typewriter",
      "layout": "through",
      "theme": "dark",
      "aspect": "16:9",
      "video": "typewriter-through-dark-16x9.mp4",
      "loop": "typewriter-through-dark-16x9-loop.mp4",
      "poster": "typewriter-through-dark-16x9.jpg",
      "what": "Every keystroke swings its typebar up to the platen on the frame the clip's own sound says, drawn on the machine as the camera moves.",
      "receipt": "19 of 19 events on their frame · audio 0.0 ms from the original",
      "credit": "Clip: Erik Pålsson / Sounds of Changes",
      "license": "CC BY 3.0",
      "license_url": "https://creativecommons.org/licenses/by/3.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Underwood_315_portable_typewriter.webm",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-typewriter --track --region \"x,y x,y x,y x,y\" --ref-time 1.0",
        "showtime new xray xray-typewriter/project --mechanism typewriter --layout through --theme dark",
        "showtime render xray-typewriter/project --job xray-typewriter",
        "showtime xray verify xray-typewriter"
      ],
      "live": "typewriter-through-dark-16x9-live.html",
      "prompt": "/showtime x-ray this clip of my typewriter, drawn on the machine."
    },
    {
      "id": "typewriter-through-light-16x9",
      "title": "The same typewriter, as a blueprint",
      "object": "Underwood 315 portable typewriter",
      "kind": "machines",
      "mechanism": "typewriter",
      "layout": "through",
      "theme": "light",
      "aspect": "16:9",
      "video": "typewriter-through-light-16x9.mp4",
      "poster": "typewriter-through-light-16x9.jpg",
      "what": "The same clip and the same events in the light theme: the inside drawn as a blueprint on paper.",
      "receipt": "19 of 19 events on their frame · audio 0.0 ms from the original",
      "credit": "Clip: Erik Pålsson / Sounds of Changes",
      "license": "CC BY 3.0",
      "license_url": "https://creativecommons.org/licenses/by/3.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Underwood_315_portable_typewriter.webm",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-typewriter --track --region \"x,y x,y x,y x,y\" --ref-time 1.0",
        "showtime new xray xray-typewriter/project --mechanism typewriter --layout through --theme light",
        "showtime render xray-typewriter/project --job xray-typewriter",
        "showtime xray verify xray-typewriter"
      ],
      "live": "typewriter-through-light-16x9-live.html",
      "prompt": "/showtime x-ray this clip of my typewriter as a blueprint, drawn on the machine."
    },
    {
      "id": "typewriter-through-dark-9x16",
      "title": "A typewriter, for a phone",
      "object": "Underwood 315 portable typewriter",
      "kind": "machines",
      "mechanism": "typewriter",
      "layout": "through",
      "theme": "dark",
      "aspect": "9:16",
      "video": "typewriter-through-dark-9x16.mp4",
      "poster": "typewriter-through-dark-9x16.jpg",
      "what": "The vertical cut: the clip on top with its inside drawn in place, the mechanism below, every word inside the reels safe area.",
      "receipt": "19 of 19 events on their frame · audio 0.0 ms from the original",
      "credit": "Clip: Erik Pålsson / Sounds of Changes",
      "license": "CC BY 3.0",
      "license_url": "https://creativecommons.org/licenses/by/3.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Underwood_315_portable_typewriter.webm",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-typewriter --track --region \"x,y x,y x,y x,y\" --ref-time 1.0",
        "showtime new xray xray-typewriter/project --mechanism typewriter --layout through --theme dark",
        "showtime render xray-typewriter/project --job xray-typewriter",
        "showtime xray verify xray-typewriter"
      ],
      "live": "typewriter-through-dark-9x16-live.html",
      "prompt": "/showtime x-ray this clip of my typewriter, drawn on the machine, for a phone."
    },
    {
      "id": "typewriter-diagram-16x9",
      "title": "A typewriter, as a living diagram",
      "object": "Underwood 315 portable typewriter",
      "kind": "machines",
      "mechanism": "typewriter",
      "layout": "diagram",
      "theme": "dark",
      "aspect": "16:9",
      "video": "typewriter-diagram-16x9.mp4",
      "poster": "typewriter-diagram-16x9.jpg",
      "what": "The clip beside an isometric drawing of the mechanism, every part moving on the clip's own keystrokes.",
      "receipt": "18 of 18 events on their frame · audio 0.0 ms from the original",
      "credit": "Clip: Erik Pålsson / Sounds of Changes",
      "license": "CC BY 3.0",
      "license_url": "https://creativecommons.org/licenses/by/3.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Underwood_315_portable_typewriter.webm",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-typewriter",
        "showtime new xray xray-typewriter/project --mechanism typewriter --layout diagram --theme dark",
        "showtime render xray-typewriter/project --job xray-typewriter",
        "showtime xray verify xray-typewriter"
      ],
      "live": "typewriter-diagram-16x9-live.html",
      "prompt": "/showtime x-ray this clip of my typewriter as a living diagram beside it."
    },
    {
      "id": "musicbox-through-9x16",
      "title": "A music box disc, rebuilt from its sound",
      "object": "Disc music box",
      "kind": "instruments",
      "mechanism": "musicbox",
      "layout": "through",
      "theme": "dark",
      "aspect": "9:16",
      "video": "musicbox-through-9x16.mp4",
      "poster": "musicbox-through-9x16.jpg",
      "what": "Each pluck turns its star wheel and rings its comb tooth on the real disc, and the disc fills with what was played.",
      "receipt": "113 of 113 events on their frame · audio 0.0 ms from the original",
      "credit": "Clip: disc music box, Canada Science and Technology Museum",
      "license": "CC BY 3.0",
      "license_url": "https://creativecommons.org/licenses/by/3.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Music_Box_Plays_%22Angels_ever_bright_and_fair%22.webm",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-musicbox --track --region \"x,y x,y x,y x,y\" --ref-time 1.0",
        "showtime new xray xray-musicbox/project --mechanism musicbox --layout through --theme dark",
        "showtime render xray-musicbox/project --job xray-musicbox",
        "showtime xray verify xray-musicbox"
      ],
      "live": "musicbox-through-9x16-live.html",
      "prompt": "/showtime x-ray this music box clip, for a phone."
    },
    {
      "id": "musicbox-through-16x9",
      "title": "A music box disc, rebuilt from its sound (wide)",
      "object": "Disc music box",
      "kind": "instruments",
      "mechanism": "musicbox",
      "layout": "through",
      "theme": "dark",
      "aspect": "16:9",
      "video": "musicbox-through-16x9.mp4",
      "poster": "musicbox-through-16x9.jpg",
      "what": "Each pluck turns its star wheel and rings its comb tooth on the real disc, and the disc fills with what was played.",
      "receipt": "113 of 113 events on their frame · audio 0.0 ms from the original",
      "credit": "Clip: disc music box, Canada Science and Technology Museum",
      "license": "CC BY 3.0",
      "license_url": "https://creativecommons.org/licenses/by/3.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Music_Box_Plays_%22Angels_ever_bright_and_fair%22.webm",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-musicbox --track --region \"x,y x,y x,y x,y\" --ref-time 1.0",
        "showtime new xray xray-musicbox/project --mechanism musicbox --layout through --theme dark",
        "showtime render xray-musicbox/project --job xray-musicbox",
        "showtime xray verify xray-musicbox"
      ],
      "live": "musicbox-through-16x9-live.html",
      "prompt": "/showtime x-ray this music box clip."
    },
    {
      "id": "switch-through-16x9",
      "title": "A keyboard switch, seen through",
      "object": "1959 Cherry mechanical keyboard switch",
      "kind": "machines",
      "mechanism": "switch",
      "layout": "through",
      "theme": "dark",
      "aspect": "16:9",
      "video": "switch-through-16x9.mp4",
      "poster": "switch-through-16x9.jpg",
      "what": "Each click snaps the lever over its spring and closes the contact, drawn on the real switch on the frame the clip's own sound says.",
      "receipt": "6 of 6 events on their frame · audio 0.0 ms from the original",
      "credit": "Clip: “Clicking a 1959 Cherry mechanical keyboard switch”, LGR, Wikimedia Commons",
      "license": "CC BY 3.0",
      "license_url": "https://creativecommons.org/licenses/by/3.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Clicking_a_1959_Cherry_mechanical_keyboard_switch.webm",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-switch --track --region \"x,y x,y x,y x,y\" --ref-time 1.0",
        "showtime new xray xray-switch/project --mechanism switch --layout through --theme dark",
        "showtime render xray-switch/project --job xray-switch",
        "showtime xray verify xray-switch"
      ],
      "live": "switch-through-16x9-live.html",
      "prompt": "/showtime x-ray the click of this 1959 keyboard switch."
    },
    {
      "id": "piano-score-9x16",
      "title": "A piano, as a score",
      "object": "Piano",
      "kind": "instruments",
      "mechanism": "piano",
      "layout": "score",
      "theme": "dark",
      "aspect": "9:16",
      "video": "piano-score-9x16.mp4",
      "poster": "piano-score-9x16.jpg",
      "what": "The notes heard in the clip, written as a score that scrolls on a smoothed tempo map.",
      "receipt": "91 of 91 events on their frame · audio 0.0 ms from the original",
      "credit": "Minuet in G, BWV Anh. 114 (Notebook for Anna Magdalena Bach, attributed to Christian Petzold); recording KasraR, Wikimedia Commons",
      "license": "Public domain",
      "license_url": "",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Minuet-G-Major-BWV-Anh-114.ogv",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-piano",
        "showtime new xray xray-piano/project --mechanism piano --layout split --theme dark",
        "showtime render xray-piano/project --job xray-piano",
        "showtime xray verify xray-piano"
      ],
      "live": "piano-score-9x16-live.html",
      "prompt": "/showtime x-ray this piano recording as a score, for a phone."
    },
    {
      "id": "guitar-tab-9x16",
      "title": "A guitar, as a tab",
      "object": "Acoustic guitar",
      "kind": "instruments",
      "mechanism": "guitar",
      "layout": "tab",
      "theme": "dark",
      "aspect": "9:16",
      "video": "guitar-tab-9x16.mp4",
      "poster": "guitar-tab-9x16.jpg",
      "what": "Each note heard, placed on a string and a fret, as a tab that scrolls with the playing.",
      "receipt": "33 of 33 events on their frame · audio 0.1 ms from the original",
      "credit": "Clip: Elenaf, Wikimedia Commons",
      "license": "CC BY-SA 3.0",
      "license_url": "https://creativecommons.org/licenses/by-sa/3.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Fingerpicking_Pattern_4_p-ima_chitarra.webm",
      "film_license": "This film is under the same license, CC BY-SA 3.0 (share-alike).",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-guitar",
        "showtime new xray xray-guitar/project --mechanism guitar --layout split --theme dark",
        "showtime render xray-guitar/project --job xray-guitar",
        "showtime xray verify xray-guitar"
      ],
      "live": "guitar-tab-9x16-live.html",
      "prompt": "/showtime x-ray this guitar clip as a tab, for a phone."
    },
    {
      "id": "drums-sheet-9x16",
      "title": "A drum kit, as a drum sheet",
      "object": "Drum kit",
      "kind": "instruments",
      "mechanism": "drums",
      "layout": "drums",
      "theme": "dark",
      "aspect": "9:16",
      "video": "drums-sheet-9x16.mp4",
      "poster": "drums-sheet-9x16.jpg",
      "what": "Every hit sorted by its sound into kick, snare, hi-hat, toms and cymbals, written on a percussion staff.",
      "receipt": "30 of 30 events on their frame · audio 0.0 ms from the original",
      "credit": "Clip: Lukáš Perný, KC Dunaj Bratislava 2012, Wikimedia Commons",
      "license": "CC BY-SA 4.0",
      "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
      "credit_url": "https://commons.wikimedia.org/wiki/File:Luk%C3%A1%C5%A1_Pern%C3%BD%2C_drum_solo_%C5%A1ou_sample%2C_KC_Dunaj%2C_Bratislava%2C_2012.webm",
      "film_license": "This film is under the same license, CC BY-SA 4.0 (share-alike).",
      "author": "showtime",
      "commands": [
        "showtime xray analyze clip.mp4 --job xray-drums",
        "showtime new xray xray-drums/project --mechanism drums --layout split --theme dark",
        "showtime render xray-drums/project --job xray-drums",
        "showtime xray verify xray-drums"
      ],
      "live": "drums-sheet-9x16-live.html",
      "prompt": "/showtime x-ray this drum solo as a drum sheet, for a phone."
    }
  ],
  "_touch": "Living diagrams people touch (no clip): each a live figure from `showtime export html <project> --interactive`, found as examples/_xray/<figure> like the films; poster optional; verb is the button's words; prompt and commands as for the films.",
  "touch": [
    {
      "id": "typewriter",
      "title": "Type on a typewriter",
      "spec": "living diagram · type",
      "verb": "Type on it live",
      "what": "Type on your keyboard and the machine types it: the key goes down, its typebar swings up and strikes, the letter lands on the paper, the carriage steps, the bell rings near the margin, and Enter returns the carriage.",
      "figure": "typewriter-figure.html",
      "poster": "typewriter-figure.jpg",
      "prompt": "/showtime explain how a typewriter works inside, interactive: let me type on it.",
      "commands": [
        "showtime new diagram typewriter --example typewriter --theme dark",
        "showtime export html typewriter --interactive"
      ]
    },
    {
      "id": "computer",
      "title": "What happens when you press a key",
      "spec": "living diagram · type",
      "verb": "Type on it live",
      "what": "Type on your keyboard: the key goes down, its USB code waits for the next poll, the CPU takes the interrupt, and the screen draws it at its next refresh. Slowed down about 30 times; typical numbers, labelled.",
      "figure": "computer-figure.html",
      "poster": "computer-figure.jpg",
      "prompt": "/showtime explain what happens when you press a key, interactive.",
      "commands": [
        "showtime new diagram press-a-key --example computer",
        "showtime export html press-a-key --interactive"
      ]
    },
    {
      "id": "heat-pump",
      "title": "A heat pump: drag the weather",
      "spec": "living diagram · drag",
      "verb": "Touch it live",
      "what": "Drag the outdoor unit to make it colder or milder outside: the refrigerant and the heat moved per unit of power answer at once (illustrative numbers, from one formula).",
      "figure": "heat-pump-figure.html",
      "poster": "heat-pump-figure.jpg",
      "prompt": "/showtime explain how a heat pump works, interactive: let me drag the weather.",
      "commands": [
        "showtime new diagram heat-pump",
        "showtime export html heat-pump --interactive"
      ]
    }
  ]
}