Skip to content
github-actions[bot] edited this page Nov 21, 2026 · 3 revisions

clippa people keeps one record per person: their name and other names (including Whisper's spellings), their channels on each platform, their archive subject and their cast library folder. Story dossiers find the people a brief names through it, and investigations use it to merge spellings and to know which names are the subject himself. It is part 1 of #138: later parts build on it (people found on the fly, who said what, the Obsidian vault).

Where records come from

people.json ([paths] people, gitignored) is the record. Until everyone is in it, clippa people also folds in the older lists, so nothing has to move at once:

  • studio/research_notes/streamers.json ([paths] streamers): its streamers and uploads_only
  • [story] people in clipper.toml
  • the cast library's folders ([thumbnail] photos): their aliases and channels, and the folder itself as the person's cast

Entries are one person when any of their names match: the name, the words in its brackets ("The Quartering (Jer)" answers to Jer), the id and the aliases, ignoring case, punctuation and a leading "the". A field people.json sets wins, and lists are joined. An archive subject named like one of a person's names (archive/jer) and a cast folder of theirs are linked, unless their record in people.json has subject / cast: an empty one there means unlinked, on purpose (people set jer --subject "").

Channels are confirmed ones only: typed by hand or from a hand-kept list, never guessed by a model. The platforms are youtube, kick, twitch, rumble, odysee and x.

Commands

clippa people list                         # everyone, and which lists each record comes from
clippa people show jer                     # one record, by any of their names
clippa people import --dry-run             # who would be written, and names two people share
clippa people import                       # write everyone into people.json
clippa people merge channel-404-news don                # two records of one person: one goes
clippa people set jer --alias Jeremy --channel x=TheQuartering --channel https://odysee.com/@TheQuartering
clippa people set "Ben Avery" --channel youtube=@BenAvery   # a new person
clippa people set jer --subject jer --cast Jer --notes "Rumble first"

set writes the person's whole merged record into people.json (adding them if nobody has that name); --name renames and keeps the old name as an alias. A lookup matches the whole name, then the words in its brackets: "Phil (Collins)" is never whoever answers to Phil. merge moves the second record's names, channels and links to the first and removes it; its name stays an alias, so the list it came from folds into the first from then on. --unalias drops an alias, but a name that comes from streamers.json or a cast folder comes back from there: fix it at the source. clippa doctor (all and serve roles) warns when two people share a name, since a lookup by it is then ambiguous; investigate keeps that name apart from both of them, and two people whose short names match (Phil (Burnell), Phil (Collins)) go by their full names there.

Clone this wiki locally