SESK media guide

Where every SESK image, logo, character, video and print file lives, which file to use for what, and the sizes each platform needs. The brand rules themselves (colors, type, voice, cast) are in the brand guide: docs/brand/SESK-Brand-Guide.pdf (source docs/brand/sesk-brand-guide.html). The step-by-step production playbook is media/PIPELINE.md.

On the web, with every file as a download: https://sesk.info/brand/ (built from this file by src/app/brand/page.tsx; edit here, then deploy).

Logo as of 2026-10-09: the brain-lightbulb mark (from Avery's logo idea). The Just Right gauge is retired as a logo; the blue/green/red Just Right colors stay for the Just Right card.

Brand quick reference

White text on Lava Orange only at 24 px bold and up; smaller text on orange is Charcoal.

Folder map

docs/brand/
  SESK-Brand-Guide.pdf          brand guide (8 pages)
  sesk-brand-guide.html         its source; render with render_pdf.py
media/
  MEDIA-GUIDE.md                this file
  PIPELINE.md                   card and video production playbook
  assets/brand/                 logos, banner, social kit (build.py, banner.py, social.py)
  assets/brand/social/          upload-ready YouTube, Facebook, Instagram, Google images
  assets/characters/allen/      Allen character sheets; sheet_final.png is THE production reference
  assets/characters/cast/       brand-guide drawings of Allen, Stacey, Xander, Avery (cast_art.py)
  assets/props/                 the Papcap (truck*.png, papcap.svg), gas station
  assets/fonts/                 Fredoka.ttf, Nunito.ttf (SIL Open Font License)
  budget/                       CREDIT-CONTROLS.md (read before any paid generation), ledger.csv
  cards/                        card_template.html, seed/ (cards.json, quiz.json), rendered/NN-slug/
  pipeline/                     sesk_build.py (video), sesk_cards.py (cards), sesk_print.py, sesk_tgc.py
  print/                        party game PDFs (print-and-play, proofs, tgc/)
  scripts/                      scripts and card batches waiting for review
  videos/NN-slug/               one folder per video (script, shotlist, audio, frames, clips, cards, build, final)

Which file do I use?

Logo

Social profiles (media/assets/brand/social/)

Instagram has no cover image. The profile picture is the only brand slot there.

Content sizes

Characters and props

• Allen is the only on-screen character for now: orange t-shirt, orange cap with no logo, light-brown hair, dark gray pants, brown boots, no sunglasses. Generate from assets/characters/allen/sheet_final.png (Higgsfield media id in PIPELINE.md, Stage 5).
• Stacey (dark blue), Xander (green), Avery (teal) are on hold until their voices are recorded. assets/characters/cast/ has brand-guide drawings only; their hair and exact blue/teal values are placeholders until real character sheets exist.
• The Papcap is Allen's red 2016 F-150 Lariat with a full Leer shell: assets/props/truck.png, truck2.png for generation, papcap.svg for graphics. Never with a badge or brand logo.

Rules for every piece of media

1. Allen approves anything before it is published, posted or scheduled.
2. No em dashes in any text. Never the words Mii, Nintendo or LEGO.
3. No real brand logos, known characters, costumes or real login pages in art.
4. Visuals must be physically correct and never misleading on safety.
5. No stock footage. Every video original and useful.
6. Every fact sourced; every number checked.
7. Paid generation only under budget/CREDIT-CONTROLS.md, logged in budget/ledger.csv. Local GPU first.
8. Every image, clip, narration and final video goes into this repo.

Naming

• Videos: media/videos/NN-slug/ (two-digit number, short kebab-case slug), e.g. 13-small-engine-gas.
• Final files: final/SESK_NN_Title_Words.mp4 and _social.mp4.
• Rendered cards: media/cards/rendered/NN-slug/.
• Logo exports: <name>_<width>.png; social files: <platform>_<slot>_<size>.png.

Git LFS

.gitattributes sends *.png, *.jpg, *.mp4, *.mp3, *.zip and *.ttf to Git LFS. After cloning, run git lfs install && git lfs pull. Upload media with git (LFS on) or the Gitea web uploader; the Gitea contents API and the lab gitea_write_file tool skip LFS, so use them for text files only.

Rebuilding the brand files

git lfs pull
cd media/assets/brand
python3 build.py        # mark, lockups, channel square
python3 banner.py       # YouTube banner
python3 social.py       # social/ kit
python3 cast_art.py     # ../characters/cast/*, ../props/papcap.*
cd ../../..
python3 docs/brand/render_pdf.py   # brand guide PDF (Playwright Chromium)

Needs Python 3 with fonttools and cairosvg, plus Playwright for the PDF. Rebuild sesk_logos.zip from the sesk_mark*, sesk_logo_horizontal*, sesk_channel_square* and sesk_youtube_banner* files after a logo change.