Repository navigation
Weekly issue
clippa weekly turns the week's streams (Sun-Sat) into a weekly, a ten-page tabloid for a TikTok carousel or two YouTube Posts: a cover, contents,
the cover story and two features, news in brief, the quote of the week, the week in numbers,
a marketplace of parody ads, and next week's schedule with a readers' poll. It gathers the
week (segments, chat, transcripts, faces named by clippa faces and the thumbnail stage's) into weekly/<saturday>/week.json,
has the [weekly] model draft the copy into issue.json (about $0.35), writes the three articles
again one call each with a writer prompt and the owner's own piece as the voice to match (about
$0.10 each), and renders 1080x1440 pages plus a square 1080x1080 set in youtube/ for YouTube
Posts, which show images square ([weekly] formats). --headline "..." tells the draft what the cover story is; edit issue.json (copy, or
faces to pin a frame for someone) and clippa weekly --render. Colours, the cover's
geometry and the fixed copy can be changed in weekly/style.toml (Style, below). Posting is by hand
(post_text.md has the captions); clippa weekly --discord drops the pages and captions in a
#weekly Discord channel to save them on a phone.
clippa weekly builds the week's ten-page tabloid issue into weekly/<saturday>/ (the
folder is [paths] weekly). It needs Impact, Bahnschrift, Georgia (italic and bold italic)
and Arial (bold and black), all standard on Windows; clippa doctor warns when any is
missing, and [weekly] *_fonts take other paths. The paper's name is [weekly] masthead, two
words (the red one, then the chrome one; "WEEKLY" follows), and byline goes under each
article's deck; the weekly refuses to draft until the masthead is set, and clippa doctor
warns. The cover subject is cut out with
torchvision DeepLabV3 (the worker's torch install; the weights download once), otherwise the
cover shows a photo panel instead.
-
clippa weekly --headline "Ethan Klein: ..."on Saturday, after Friday's show is processed: gathers the week, draftsissue.jsonwith[weekly] modeland renders. - Look at
contact_sheet.jpg. Fix copy inissue.json; pin a better frame for a face with"faces": {"Name": "<stream>/segments/s16_x"}(that stream's thumbnail frame) or{"frame": "<stream>/thumbs/.../05_1.0.jpg", "face": {x, y, width, height}, "bottom": 0.73}, or a portrait you drop in the issue folder:{"photo": "hila_klein.png"}. The cover can take"background": "towers.png"(a picture shown as a dark shadow behind the subject,background_focus: [x, y]picks the crop) andsubject_height(pixels, default 940). Thenclippa weekly --render(--only 01,03for a few pages).--draftwrites a new draft and keeps the old file as a backup.--write 04,05has the writer prompt redo those articles (deck, columns, pull quote) from the week's summaries, matching the voice ofclippa/prompts/weekly_article_example.md; a draft that would run off the page is sent back once to be cut. To change the voice, put a piece of your own with that name in the folder[paths] promptsnames; it is read before the packaged one. - Post by hand: TikTok takes all ten 3:4 pages as one carousel. YouTube Posts show images
square and take five per post, so use
youtube/01-10(the same pages on a square canvas) as two posts, 01-05 and 06-10, with the captions inpost_text.md.--format youtuberenders only the square set.clippa weekly --discord(with--weekfor an older issue) posts both sets and the captions to the[discord] weekly_channeltext channel (weekly), to save on a phone; it makes the channel if the bot has Manage Channels, else make it by hand. A rerun posts only what is missing (<issue>/discord.json).
Issue numbers continue from [weekly] first_issue across the folders in weekly/.
The look is data: the canvas, the palette, the cover's geometry (teaser strip, kicker,
headline width, inset, starburst, barcode block, subject height) and the fixed copy
("LOLCOW OF THE WEEK", "READERS' POLL", the barcode digits, ...) have defaults in
clippa/weekly/style.py. To change any of them, put a style.toml next to the issues
(weekly/style.toml, i.e. in [paths] weekly) with the same tables and keys, only the ones
you change, and clippa weekly --render:
[palette]
red = [200, 20, 30]
[cover]
subject_height = 900 # an issue.json cover.subject_height still wins
[copy]
lolcow = "COW OF THE WEEK"A colour is [r, g, b] or the name of a [palette] colour; an unknown key is refused.
Home · Getting started · clippa doctor · These pages are built from docs/wiki/ in the repo, so edits made here are overwritten: how to edit them
Run it
- Overview
- Getting started
- Roles and services
- Configuration
- Pipeline
- Review
- Reviewing
- War room
- Clippa messenger
- Scheduling and uploads
- Costs
- Checkup
- Audit
- Backups
Install
- Install
- Install checklist
- Kitsu
- Discord app
- YouTube sign-in
- Windows
- macOS
- Transcribe on Modal
- NAS recorder
- NAS hub
- Claude on the NAS
- Phone access
- Model providers
- Adding a show
- YouTube channel
Features
- Pre-shows
- Fetching VODs
- Speakers
- Faces
- Covers
- Cast library
- B-roll
- Clip art
- Weekly issue
- X posts
- TikTok
- News watcher
- Character pieces
- Documentaries
Research
Working on Clippa