diff --git a/marker-context.md b/marker-context.md new file mode 100644 index 0000000..38a6f6a --- /dev/null +++ b/marker-context.md @@ -0,0 +1,113 @@ +# Premiere / OBS marker types + +Reference for tagging streams in Premiere and writing `editDesc` chapters. +Companion to [`prompts.txt`](prompts.txt) (editDesc cleanup rules). + +## Deliverable vs internal + +| Category | In YouTube chapters / `editDesc`? | +|----------|-----------------------------------| +| Descriptive location & activity markers | Yes | +| Deliverable tangent pairs (tag in / tag out) | Yes | +| Pipeline stamps (`gamign`, `env`, raw `SEG`) | No | +| `FUNI`, `FUNI(INT)`, `funi`, `INT:`, `LORE:` | No | +| `AFK` / `UNAFK` | Usually yes (viewer-facing breaks) | +| `starting soon` / `preramble` / `postramble` / `goodbye` (renamed from Start, BEGIN, last env, END) | Yes (stream bookends) | +| Raw `BEGIN` / `END` / `AFK` / `UNAFK` | Yes (or folded into longer chapter titles) | + +--- + +## OBS pipeline stamps (purple) + +Hotkey stamps from the streaming layout. **Not chapter titles** — they mark OBS scene/layout switches and get stripped from `editDesc` (see `prompts.txt`). + +| Marker | Purpose | +|--------|---------| +| **gamign** | Gaming layout / game capture active (intentional typo). | +| **env** | Environment / desktop / non-game layout. The **last** `env` of the stream (desktop at wrap-up) is usually relabeled **`postramble`** in `editDesc` — same timestamp, different chapter title. | +| **SEG** | Orange OBS chapter stamp for “new topic segment.” Often replaced in post with a descriptive deliverable label, or converted to `INT:` if the tangent is editor-only. | + +These align to OBS marker times, not transcript guesses. When adding deliverable chapters, use the **marker timestamp**, not speech alone. + +--- + +## Internal editor notes + +Never front-facing. Strip from `editDesc`. + +| Prefix | Purpose | +|--------|---------| +| **INT:** | Internal note to editor — excluded from delivery. **White** in Premiere. Example: `INT: desktop` (alt-tab too fast to matter on VOD). Not the same as “interruption”; non-deliverable tangents get `INT:`, deliverable ones get descriptive tag in/out. | +| **FUNI** | **“Clip that”** — flag a moment to save for **TikTok, Reels, and YouTube Shorts**. **Blue** — OBS hotkey stamp during stream. May include a short label (e.g. `FUNI cozy awoo`). | +| **FUNI(INT)** | Was **FUNI** originally; relabeled **`FUNI(INT)`** manually when the clip note is internal/editor-only rather than a straight short. Stays **blue** (FUNI lineage). Strip from `editDesc` like other internal markers. | +| **funi** | Same purpose as **FUNI**, but **lowercase** and **aquamarine** — added manually in post (not an OBS marker). Example: `funi ubear gift`. | +| **LORE:** | Lore / callback note for editor or future reference, not a public chapter. | + +--- + +## Stream structure — hard tags (yellow/tan) + +Predefined stamps from the OBS/py pipeline. **Yellow/tan** in Premiere (`4281049552` in [`0csv_to_xml.py`](2026/0csv_to_xml.py); muted tan-yellow in the UI). `setColorByIndex(4)` — not index 5 (that is **white**, used for `INT:`). + +| Raw marker | Purpose | +|------------|---------| +| **Start** | Pre-stream hold. **Green** (default color when no `pproColor` is set — from `0csv_to_xml.py`). | +| **BEGIN** | Stream proper begins (hard tag). | +| **AFK** | Stepping away — break starts. | +| **UNAFK** | Back from break. | +| **END** | Stream over (hard tag). | + +### `editDesc` rename conventions + +Premiere keeps the raw stamp names; chapters use friendlier labels at the **same timestamps**: + +| Raw stamp | `editDesc` chapter title | +|-----------|--------------------------| +| **Start** | **starting soon** (always) | +| **BEGIN** | **preramble**, **setup + rambling**, or similar (often) | +| last **env** | **postramble** (often) | +| **END** | **goodbye** (always) | + +`prompts.txt` still strips raw `env` lines — you replace that slot with `postramble` when writing chapters. `BEGIN` / `END` / `AFK` / `UNAFK` stay as chapter lines (or get merged into longer titles like `chatting + goodbye`). + +--- + +## Deliverable content markers (red / descriptive) + +Added during tagging (MCP or manual). Short labels: locations, bosses, setup beats, tangents worth skipping or revisiting. + +### Gameplay & exploration +Examples: `Bellhart`, `far fields arena`, `goo beast defeated`, `first sinner fight`. + +### Deliverable tangents — tag in / tag out +For skippable or revisit-worthy segments (gift popups, detours, downloads): + +1. **Tag in** — descriptive name at segment start (e.g. `Subnautica 2 gift`). +2. **Tag out** — descriptive name where main content resumes (e.g. `far fields arena` after gift ends). + +Both bounds are deliverable chapter candidates. Do **not** use `gamign` or `env` as tag-out labels. + +--- + +## `editDesc` workflow + +- Chapters in `editDesc/*.txt` are **semi-manual** (JSyntax Workflows + cursor edit prompt). +- Agent tagging work targets **Premiere markers**; do not auto-fill `editDesc` with `INT:`, `FUNI`/`funi`, or pipeline stamps. +- `prompts.txt` rules still apply: remove `FUNI`, `INT`, `LORE`, `gamign`, and `env` lines (treat lowercase `funi` the same as `FUNI`); normalize YouTube timestamps. + +--- + +## Premiere marker colors (`0csv_to_xml.py`) + +| Marker family | Color | `setColorByIndex` | +|---------------|-------|-------------------| +| Start | Green (default) | 0 | +| Deliverable tags (locations, tag in/out, bosses) | Red | 1 | +| gamign, env | Purple | 2 | +| SEG | Orange | 3 | +| BEGIN, END, AFK, UNAFK | Yellow/tan | 4 | +| INT: | White | 5 | +| FUNI, FUNI(INT) | Blue | 6 | +| funi | Aquamarine / turquoise | 7 | + +When adding markers via MCP: red = 1, white (`INT:`) = 5. Hard tags share the same yellow/tan as each other, not white. diff --git a/prompts.txt b/prompts.txt index 4288d7d..bb34185 100644 --- a/prompts.txt +++ b/prompts.txt @@ -1,3 +1,3 @@ -rm all FUNI, INT, LORE, 'gamign', and 'env' timestamps +rm all FUNI, funi, INT, LORE, 'gamign', and 'env' timestamps fix timestamps for youtube (truncate extra zeros, e.g. 0:00, 7:21, etc) \ No newline at end of file