TV_TERMINAL

TEENAGE VIOLENCE Terminal Renderer — v0.1.0.

TV_TERMINAL turns declarative campaign YAML into deterministic 1080×1920 terminal-performance videos. The terminal behaves like credible software; the campaign concept supplies the strange part.

Current status

Renderer v0.1.0 is complete. Campaign validation, deterministic state reconstruction, approved frame rendering, synchronized procedural audio, atomic FFmpeg export, and installed-wheel reproduction are all verified. A clean offline installation produced a byte-identical Campaign 001 master.

The completed implementation path is in ROADMAP.md, and the exact v0.1.0 reproduction record is in docs/RELEASE_V0.1.0.md. Creative rules are in docs/TV_TERMINAL_SPEC.md, and the authoring contract is in docs/CAMPAIGN_SCHEMA_V1.md.

Setup

Requirements: Python 3.12+ and FFmpeg.

python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"
pytest

Review a single approved frame or a short sequence:

tv-terminal render campaigns/001_tune_in/campaign.yaml --frame 870
tv-terminal render campaigns/001_tune_in/campaign.yaml --start 14 --end 16

Render the current verified audio master:

tv-terminal render campaigns/001_tune_in/campaign.yaml

Add --no-audio for a verified silent master. The default output is output/001_tune_in/001_TUNE_IN_MASTER.mp4. See docs/EXPORT_V1.md and docs/AUDIO_SYSTEM_V1.md for the locked contracts.

The approved Campaign 001 video is included at examples/001_TUNE_IN_MASTER.mp4 as a public reference fixture. Its checksum and media contract are enforced by the test suite.

Project structure

campaigns/              Campaign source and creative briefs
assets/                 Bundled third-party production assets and licenses
examples/               Approved rendered reference fixtures
docs/                   Creative specification and archived design notes
tests/                  Unit and determinism tests
tv_terminal/
  campaign/             YAML loading and validation
  events/               Terminal behavior primitives
  timeline/             Absolute scheduling and state sampling
  terminal/             Buffer, spans, cursor, and state
  render/               Pillow frame rendering and layout
  audio/                Timeline-derived cues and procedural synthesis
  export/               FFmpeg integration
ROADMAP.md              Current architecture, milestones, and exit gates

Generated media belongs in output/ and is intentionally ignored.

Proprietary — TEENAGE VIOLENCE