@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/tutorials/Project-Page.md

@@ -1,227 +1,225 @@
 # Project Page
 
-Every run you start gets a project page. It shows each stage as it is made, tells you the one thing the project needs next, and holds the finished files, the settings, the history and the cost.
+Every run you start gets a project page. It shows each part as it is made, puts the one thing the project needs next in its title row, and holds the finished files, the settings, the versions and the cost.
 
-**Where to find it:** Home or Projects → click a project. Pressing **Start run** on Play also opens it.
+**Where to find it:** Home or Projects → a project. Pressing **Make the video** on Create also opens it.
 
 ## How the page is laid out
 
-The page has four parts:
-
 | Part | What it holds |
 | --- | --- |
-| Title row | **Projects** (the way back), the project title, one line with the article prompt's name, the format and when it started, the status, **Make the next chapter** on a finished audiobook that is a chapter of a book, **Edit settings** and the **More project actions** menu (the three dots). |
-| Run cost line | Once the run has ended, one line under the title sums it up (see [The run cost line](#the-run-cost-line)). |
-| Section rail (left) | One entry per part of the project, with a coloured lamp for its state. Below a line: **Settings**, **Checkpoints** and **History**. On a phone the rail becomes a row of tabs. |
-| Main column | The section you picked. |
-| Right rail | The next action panel, **Free space** on a finished project (see [Free space](#free-space)), then **Run steps** with each step's time and time left, the cost so far and the batch queue count (**Queue · N**). On narrow windows (under about 1180 px wide) only the next action panel and Free space are shown. |
+| Title row | **Projects** (the way back), the project title, its state in words beside its lamp (for example **● Done**), a short line of facts (finished when and how long it took, or when it started; its channel; when it was uploaded; "Audiobook" or "Podcast episode" for spoken work), then the one thing to do next (the page's only lime button) and **Edit settings**. Facts that do not fit beside the title go on a line under it, each one whole. While a step works, the line says where the run stands, as Home does (`Step 2 of 4 · Narration · about 4 min left on this step`), beside a clock: `Working · 9 min 30 s`, holding still as `9 min 30 s of work so far` while the run is paused or waits on you. |
+| Note under the title | One line, only when the situation needs saying: the read-only sample, a paused, stopped or queued run, a run an agent is reviewing, a finished short. |
+| Main column | The part you picked. |
+| Status list (right) | One row per thing the project makes: **Article**, **Narration**, **Images**, **Video**, **Shorts**, **YouTube**, **PDF**, each with its state in words and one detail, for example **Done · 4 images + 1 thumbnail**. **All files** closes the list as a button with a folder and how many files there are. While the run goes, **Progress** leads the list, and a row that works, waits or failed gets a second line saying what it is doing and the time left. A part with outdated files says how many, for example **Done · 2 outdated**, or **Outdated** when an edit sent it back to wait (a renamed project's PDF, which prints the title). Under the list, the cost line, then the project's other actions in words (see [Project actions](#project-actions)). |
+| Under the list | The cost line (see below), **Make the next chapter** on a finished audiobook that is a chapter of a book, and, while videos wait in the queue, how many with the list to reorder them. |
 
-The page opens where the next action points: the failed step, the held review or the outdated images. When nothing needs you, it opens on the stage the run is at. A finished video whose YouTube description is written opens on the **YouTube** section, so **Copy** (the description) is one press away.
+Press a row of the status list to open that part. The page opens where the next action points: the failed step, the held review or the outdated images. When nothing needs you, it opens on the part the run is at, and a finished video opens on **Video**: the player, **Open folder**, the chapters, **Copy description** and **Copy tags**, with **Download video (.mp4)** in the title row above it.
 
-### The run cost line
+### The cost line
 
-When a run has ended (done, done with problems, failed or canceled), a line under the title sums it up, for example `This run cost $0.42 · ~$3.10 via API · 12 min of work`: only the time Slopify was working, never the time waiting on you, a review or a limit. A run that ended early says **Spent so far** instead, and calls without a known price add "plus unpriced calls". **See cost by stage** opens the **Cost** section. The line is hidden while the run is going and when it spent nothing. While the run is going, a clock sits there instead: `Working for 9 min 30 s`, ticking while a step runs; while it is paused or waits on you it holds still and reads `9 min 30 s of work so far`. See [Costs and Run Cost](Costs-and-Run-Cost).
+Under the status list, one line sums up what the run cost: `Cost $0.07 · 4 s of working time · See the breakdown`. The working time counts only the time Slopify was working, never the time it waited on you, a review or a limit. While the run goes it reads **Cost so far**; steps run on a tool you are signed in to add the approximate API price (`~$3.10 via API`); calls without a known price make it a known cost. **See the breakdown** opens the **Cost** part: what each step and each model cost, its usage and its working time. See [Costs and Run Cost](Costs-and-Run-Cost).
 
 ### Time left
 
-While a step runs, its line in **Run steps** (and on Home's Running now) ends with its time left, for example `12 of 40 chunks · about 4 min left`. Slopify works it out from the step's own pace once it has counted something, otherwise from how long the same kind of step took in your finished runs (on the same provider and model when there are enough of those). Past that time it says **taking longer than usual**; with nothing to go by, **time left unknown**. Near the end it reads **finishing up** or **under a minute left**.
+While a step runs, its row in the status list (and its line on Home's Running) ends with its time left, for example `12 of 40 chunks · about 4 min left`. Slopify works it out from the step's own pace once it has counted something, otherwise from how long the same kind of step took in your finished runs (on the same service and model when there are enough of those). Past that time it says **taking longer than usual**; with nothing to go by, **time left unknown**. Near the end it reads **finishing up** or **under a minute left**.
 
-### Project status
+### Project state
 
-The status beside the title reads one of:
+The state beside the title reads one of:
 
-| Status | Meaning |
+| State | Meaning |
 | --- | --- |
-| **Queued** | Waiting for its turn behind other videos in the batch queue. |
-| **Running** | A stage is being made. |
+| **Queued** | Waiting for its turn behind other videos in the queue. |
+| **Running** | A part is being made. |
 | **Paused** | You paused it. Everything made so far is kept. |
-| **Done** | Every stage finished. |
-| **Done with problems** | The main output was made (the video, or the narration when there is no video, or the article when there is neither), but another step failed. Each failed step shows its error and its fix. |
-| **Failed** | A step failed and the main output was not made. |
-| **Canceled** | You canceled the run. Finished outputs are kept. |
-| **Waiting for your review** | A review checkpoint is holding the run for you to approve. |
-| **Waiting for the agent** | An [External agent](Agents-MCP#the-external-agent-reviewer) is reviewing what was made. It goes on by itself once the agent answers, or after 2 hours. |
-| **Prepared** | Made ahead by its schedule; only the video is left, for its day. See [Schedules](Schedules#prepare-a-video-ahead). |
+| **Done** | Everything finished. |
+| **Done with problems** | The main result was made (the video, or the narration when there is no video, or the article when there is neither), but another step failed. Each failed step shows its error and its fix. |
+| **Failed** | A step failed and the main result was not made. |
+| **Canceled** | You canceled the run. Finished files are kept. |
+| **Waiting for your review** | A pause is holding the run for you to approve what it made. |
+| **Waiting for the agent** | [Your own AI agent](Agents-MCP#your-own-ai-agent-as-the-checker) is checking what was made. It goes on by itself once the agent answers, or after 2 hours. |
+| **Waiting for its day** | Made ahead by its schedule; only the video is left, for its day. See [Schedules](Schedules#make-a-video-ahead). |
 | **Stopped** | The run stopped before it finished (for example after a restart). Press **Continue the run**. |
 | **Kept as is** | What is left was set aside with **Keep as is** and won't run. Editing the project brings it back. |
 
-## The next action button
-
-The right rail always shows at most one button, named for what it will do. It is the same action the command palette (`Ctrl+K`) offers as the first entry under **This project**, and it is repeated inside the section it concerns.
-
-| Situation | Status line | Button |
-| --- | --- | --- |
-| The bundled sample project | Sample project | **Make my own copy** (the sample is read-only; your copy can be edited and made again) |
-| Paused | Paused | **Continue the run** |
-| A step failed and will not retry by itself | Failed | The step's fix-it button (for example **Copy sign-in command** with **Check again**, **Soften and retry**, **Edit the prompt**, **Switch model**), or **Try the article again**, **Try images again** and so on. See [Recovery and Retries](Recovery-and-Retries#fix-it-buttons). |
-| A checkpoint is holding the run | Waiting for your review | **Approve and record the narration**, **Approve and make the images**, **Approve and render the video**, or **Approve the ...** when nothing waits on it |
-| An External agent is reviewing what was made | Waiting for the agent | No button. "An agent is reviewing what was made." The run carries on once the agent answers, and a review nobody answers passes by itself after 2 hours. |
-| A CLI plan limit is used up | Waiting for limits | No button. The line says, for example, "Waiting for Codex limits (resets at 14:00)." and that the run carries on by itself. |
-| A step is waiting to retry | Waiting to try again | No button. The line says the time it tries again. |
-| Running | Running | **Pause** |
-| Stopped before it finished (for example after a restart) or canceled | Stopped / Canceled | **Continue the run** (makes only what is missing) |
-| Queued | Queued | No button. Videos queued together run one at a time, in the order they were added; this one starts by itself when those ahead of it are done, and Home shows which one is running now. |
-| An edit made outputs outdated | Outdated | **Remake the outdated narration**, **Remake 4 outdated images** and so on |
-| A 60-second short is finished | Done | **Make the full video on this topic** (opens Play set up for a long video on the same topic; see [Your First Short](Your-First-Short#make-the-full-video-next)) |
-| The video is finished | Done | **Prepare upload** |
+## The next action
+
+The title row shows at most one lime button, named for what it will do. It is the same action the command palette (`Ctrl+K`) offers first under **This project**, and it is repeated at the top of the part it concerns.
+
+| Situation | Button |
+| --- | --- |
+| The bundled sample project | **Make my own copy** (the sample is read-only; your copy can be edited and made again) |
+| Paused | **Continue the run** |
+| A step failed and will not try again by itself | The step's fix (for example **Copy sign-in command**, **Edit the prompt**, **Switch model**), or **Try the article again**, **Try images again** and so on. See [Recovery and Retries](Recovery-and-Retries#fix-it-buttons). |
+| A pause is holding the run | **Approve and make the narration**, **Approve and make the images**, **Approve and make the video** |
+| Your own AI agent is checking what was made | None. The note says the run carries on once the agent answers, and that a check nobody answers passes by itself after 2 hours. |
+| A plan limit is used up | None. The note says, for example, "Waiting for Codex limits (resets at 14:00)." |
+| A step is waiting to try again | None. The note says when it tries again. |
+| Running | **Pause** |
+| Stopped before it finished, or canceled | **Continue the run** (makes only what is missing) |
+| Queued | None. Videos queued together run one at a time, in the order they were added; Home shows which one is running now. |
+| An edit made files outdated | Makes the outdated ones again, for example the outdated narration or 4 outdated images. Before anything paid starts, it shows what it makes again and the estimated cost. |
+| A 60-second short is finished | **Make the full video on this topic** (opens Create set up for a long video on the same topic; see [Your First Short](Your-First-Short#make-the-full-video-next)) |
+| The video is finished (uploaded or not) | **Download video (.mp4)**; an audiobook or a podcast downloads its own file instead, **Download audiobook (.m4b)** or **Download episode (.mp3)**. The part that holds that file does not offer it a second time. **Copy for YouTube Studio** sits in the Video part's heading, beside the player, and in the YouTube part's heading (see [Publishing to YouTube](Publishing-to-YouTube)). |
 
 `Shift+N` runs the next action from anywhere on the page.
 
-When a step fails, **Error details** under the message shows the step's own words.
+When a step fails, its part says why at the top, and **Error details** shows the service's own words.
 
 ## Pause, continue and cancel a run
 
 ### Pause a run
 
 1. Open the project while it is running.
-2. Press **Pause** in the right rail (or pick **Pause the run** in the command palette).
+2. Press **Pause** in the title row (or pick **Pause the run** in the command palette).
 3. The call in progress finishes, then nothing new starts. Everything made so far is kept.
 
-A step that is waiting to retry or waiting for a CLI limit also stays held while the project is paused.
+A step that is waiting to try again or waiting for a plan limit also stays held while the project is paused.
 
 ### Continue a paused or stopped run
 
-1. Press **Continue the run** in the right rail (or **Continue the run** in the command palette).
+1. Press **Continue the run** in the title row (or in the command palette).
 2. Slopify makes only what is missing; finished work is reused.
 
 ### Cancel a run
 
-1. Open **More project actions** (the three dots beside the title).
-2. Choose **Cancel the run…**.
-3. Confirm with **Cancel run**, or press **Keep running** to leave it alone.
+1. Press **Cancel the run…** under the project's status, on the right.
+2. Confirm, or keep it running.
 
-Canceling stops every running stage; finished outputs are kept. You can continue a canceled run later with **Continue the run**. If you took a step up again after canceling (**Try ... again**), Continue carries on only that work; see [Recovery and Retries](Recovery-and-Retries#cancel-then-continue). A project has to be canceled (not running) before you can delete it from Projects.
+Canceling stops every running step; finished files are kept. You can continue a canceled run later with **Continue the run**. If you tried a step again after canceling (**Try … again**), Continue carries on only that work; see [Recovery and Retries](Recovery-and-Retries#cancel-then-continue). A running project has to be canceled before you can delete it.
 
-## The sections
+## The parts
 
-Sections appear only when the run uses them. A section with outdated outputs shows how many beside its name, for example "3 outdated".
+A part appears only when the run makes it. The research notes are a tab of Article, and the thumbnail sits at the top of Images.
 
-| Section | What it shows |
+| Part | What it shows |
 | --- | --- |
-| **Outputs** | Every output the project makes (article, narration or audiobook/podcast, images, thumbnails, video, shorts, PDF), each with a preview, its state in words (Current, Uses older material, In progress, Failed), which version of its source it was made from, its main download and **Other formats**. **Add another output** turns the project into narration, an audiobook, images, a video, a PDF or a podcast: it shows what is reused, what is made and the extra cost before saving, and only the new work runs. A podcast made from an article (**Adapt my article into a conversation**) keeps the article as written. |
-| **Article** | The article in a reading view, with tabs for **Research** notes, **Sources**, **Speakers** (multi-voice scripts) and **Pronunciation** when those exist. **Copy** copies the open tab as Markdown. |
-| **Narration** | A player for the intro, body and outro, the downloads, and the voice and chunking used. The text plays along: press a line to play from there, and the pencil beside it opens Edit project → Narration at that passage. Podcasts and interviews show the conversation turn by turn with speaker names. |
-| **Images** | The establishing image (a reference that is not in the video), every slideshow image in order, on-screen cards for tables and figures, and the thumbnails. Press an image to see it full size (see [Images at full size](#images-at-full-size)). |
-| **Video** (or **Audio export** when Video is off) | The player, downloads, the file length and format, and what the loudness master measured. |
+| **Article** | The article in a reading view, with tabs for **Research** notes, **Sources**, **Speakers** (scripts for several voices) and **Pronunciation** when those exist, its length and how long it reads aloud, its download, **Open folder** and **Copy article**. |
+| **Narration** | A player for the intro, the article and the outro, the downloads, and the text that plays along: press a line to play from there. **Fix this line** under it opens the words of the passage the line is in, right there: correct them, or leave them as they are, and **Make this passage again · 1 voice call** has the voice read that passage again at once (the old narration stays under **Versions**). With a narration prompt, corrected words are first prepared for the voice by the AI, and the button says **1 AI call and voice calls**. Podcasts and interviews show the conversation turn by turn with speaker names. |
+| **Images** | The thumbnail (with **See it as YouTube shows it**), every image in order, on-screen cards for tables and figures, and the establishing image (a reference that is not in the video). Each picture has its actions under it in words: **Make this image again**, **Download**, **More** (**Compare with previous**, **Replace with my file**, **Delete**) and **Full size**. **Download all 4 images (.zip)** saves them all. |
+| **Video** (or **Audio export** when the video is off) | The player, **Open folder**, **Download captions (.srt)** (the .vtt is in **All files**), the size and loudness (the length and shape are in the status list), **Copy description** and **Copy tags**, then the chapters (press one to play from there). **Measured loudness** folds out the loudness measured in LUFS. The video's own download is the title row's **Download video (.mp4)**; on a page whose title row offers something else (a sample's **Make my own copy**, an outdated file to make again) it is here. Under the player, **Shorts made from it** shows each short's picture, title, length and **Download (.mp4)**, with **Open Shorts** for the rest. On a wide screen the player grows to 960 pixels. |
 | **Shorts** | The vertical clips picked from the video, each with its title and hashtags. See [Shorts](Shorts). |
-| **YouTube** | The description, chapters, hashtags and tags as they go into YouTube Studio, **Copy** (the description, `Shift+D`), **Copy tags** and **Prepare upload**. See [YouTube Description](YouTube-Description) and [Publishing to YouTube](Publishing-to-YouTube). |
-| **PDF** | The rendered document and **Download PDF**. See [PDF Documents](PDF-Documents). |
-| **Cost** | The run cost by stage and by model. See [Costs and Run Cost](Costs-and-Run-Cost). |
-| **Live** | The run as it is made. See below. |
-| **Settings** | The project's settings, opened straight into the **Edit project** form. See [Editing a Project](Editing-a-Project). |
-| **Checkpoints** | The review checkpoints for this revision. See below. |
-| **History** | Every saved revision and its files. See [Editing a Project](Editing-a-Project#history-and-saved-revisions). |
+| **YouTube** | The title, description, chapters, hashtags and tags as they go into YouTube Studio, each with its copy button, and each upload's release date and link. See [YouTube Description](YouTube-Description) and [Publishing to YouTube](Publishing-to-YouTube). |
+| **PDF** | The laid-out document and its download. See [PDF Documents](PDF-Documents). |
+| **All files** | Every file the project makes, part by part, each with its state, when it was made and its downloads. See [Downloads](#downloads). |
+| **Cost** | The run's cost by step and by model. Opened from the cost line's **See the breakdown**. |
+| **Progress** | Only while the run goes: the run as it is made. See below. |
 
-A section for a stage that is switched off says "*Article* is off for this run." A section still waiting says it starts when the steps before it are done.
+A part still waiting says it starts when the steps before it are done.
 
-### Re-run a whole stage
+### Make a whole part again
 
-Each stage section's head has a button for making that whole stage again, named for what it makes:
+Each part's heading has a button that makes all of it again, named for what it makes and what it costs:
 
 | Button | What it does |
 | --- | --- |
-| **Research again** | Fresh research, then the affected article, narration, thumbnail and exports. |
-| **Write the article again** | A fresh article, then the affected narration, thumbnail and exports. |
-| **Record the narration again** | New narration and the affected exports. |
-| **Make all images again** | New generated images and the affected video; supplied images and narration are kept. |
-| **Make the thumbnails again** | New thumbnails; the video is not changed. |
-| **Render the video again** / **Export the audio again** | Rebuilds the exports from saved media, with no new narration or images. |
-| **Render the PDF again** | Renders the PDF from the saved article and title. |
+| **Research the topic again · AI calls** | Fresh research, then the affected article, narration, thumbnail and video. |
+| **Write the article again · AI calls** | A fresh article, then the affected narration, thumbnail and video. |
+| **Make the narration again · voice calls** | New narration and the affected video. |
+| **Make all 4 images again · 4 image calls** | New images and the affected video; images you supplied and the narration are kept. |
+| **Make the thumbnail again · 1 image call** | A new thumbnail; the video is not changed. |
+| **Make the video again (free)** / **Make the audio file again (free)** | Puts the video or audio file together again from saved media, with no new narration or images. |
+| **Make the PDF again (free)** | Lays out the PDF again from the saved article and title. |
 
-Each asks first; confirm with the same label or press **Keep what is there**. Previous outputs stay in History. These actions are off while the project is running.
+Each asks first. Earlier files stay under **Versions**. These buttons are off while the project is running.
 
 ### The reading view
 
 The article, research notes and narration script are shown in a reading view:
 
-- **Contents**: a list of the headings; click one to jump to it.
-- **Search the article** (or research, or narration script): every match is marked. Press `Enter` for the next match, `Shift+Enter` for the previous, or use the **Previous match** and **Next match** arrows.
+- **Search the article** (or the research, or the script): every match is marked. Press `Enter` for the next match, `Shift+Enter` for the previous, or use the **Previous match** and **Next match** arrows.
 - **Copy section** beside each heading copies that section as Markdown.
-- **Copy all** copies the whole text as Markdown.
+- **Copy article** (or **Copy all**) copies the whole text as Markdown.
 
-If the browser blocks clipboard access, select the text and press `Ctrl+C`.
+If the browser blocks the clipboard, select the text and press `Ctrl+C`.
 
 ### Downloads
 
-Every stage puts its files the same way, in one row of buttons apart from its text: one lime **Download** (a menu when the stage has several files, a plain button when it has one), the stage's one **Open folder**, then anything else the stage does (such as **Copy**). Lengths, formats and what a file measured sit on their own line under the buttons.
+Every part puts its files the same way, in one row of buttons beside its text: a download named for what it holds (**Download video (.mp4)**, **Download article (.txt)**, **Download all 4 images (.zip)**; a menu when the part has several files), the part's one **Open folder**, then anything else the part does (such as **Copy description**). Lengths, formats and what a file measured sit on their own line.
 
-| Where | What the Download holds |
+**All files** lists them all in one place:
+
+| Part | Its files |
 | --- | --- |
-| Article | **Article (.md)**, **Sources**, **Pronunciation glossary** and **Research notes**, as far as the run made them. Beside it: **Copy** for the open tab and **Show instructions**. |
-| Narration | For intro, body and outro: the recording (**Body narration**), the **clean narration** (the spoken text used for captions) and the **TTS script** (with delivery cues; blank lines separate requests). Uploaded audio has no TTS script. |
-| Images | **Download all** (a zip of the images). Each image and thumbnail also has its own Download at full size. |
-| Video | **Video (.mp4)** or **Audio (.wav)**, **Subtitles (.srt)**, **Subtitles (.vtt)**, **YouTube description (.txt)**, **YouTube tags (.txt)**, **Audio with chapters (.mp3)**, **Audiobook with chapters (.m4b)** and each **Short N (.mp4)**, as far as the run made them. |
-| Shorts | Every short's MP4 (**Download the short** when there is one). See [Shorts](Shorts#see-copy-and-download-your-shorts). |
-| PDF | **Download PDF**. |
-| History | Any saved revision's files, one **Open folder** per version, and **Download all images** for that revision. |
+| Article | The article as text, its sources, the Pronunciation Glossary and the research notes, as far as the run made them. |
+| Narration | The recording and the spoken text; for spoken work with chapters, an MP3 and an M4B. Uploaded audio has no spoken text. |
+| Images | All the images as one .zip, and each image at full size from its tile. |
+| Thumbnail | The thumbnail (or the three). |
+| Video | The video (or the WAV), the caption files (.srt and .vtt), and the YouTube description and tags as text. |
+| Shorts | Each short's MP4, and all of them as one .zip. |
+| PDF | The PDF. |
 
 The YouTube description and tags downloads are the text exactly as the page shows it: your hand edits, the fitted chapters and the filled channel links.
 
-**Open folder** opens the stage's folder on the computer running Slopify. In Docker without the host helper, it shows the path to copy into your file manager instead. See [Where Your Files Live](Where-Your-Files-Live).
+**Open folder** opens the part's folder on the computer running Slopify. In Docker without the host helper, it shows the path to copy into your file manager instead. See [Where Your Files Live](Where-Your-Files-Live).
 
 ### The players
 
 Videos and audio play in Slopify's own player, not the browser's.
 
-- **Video:** the poster (the first thumbnail for the finished video, the first still for a short) with a big play key, then a bar with play, the time, a lime track you can click or drag (it shows what has loaded, a time tip and the YouTube chapter marks), volume, speed from 0.75× to 2×, captions, picture in picture and full screen. The bar hides while the video plays. In a narrow space it drops picture in picture, then volume, speed and the total time, keeping play, seek, captions and full screen on one row.
-- **Audio** (narration, intros and outros, the audio export, podcasts and audiobooks, live previews, parts in History): the same bar on its own, with the chapter or segment marks on the track.
+- **Video:** the poster (the first thumbnail for the finished video, the first still for a short) with a big play button, then a bar with play, the time, a track you can click or drag (it shows what has loaded, a time tip and the chapter marks), volume, speed from 0.75× to 2×, captions, picture in picture and full screen. The bar hides while the video plays. In a narrow space it drops picture in picture, then volume, speed and the total time, keeping play, seek, captions and full screen on one row.
+- **Audio** (narration, intros and outros, the audio file, podcasts and audiobooks, live previews, older versions): the same bar on its own, with the chapter or segment marks on the track.
 
 Click the player first, then use YouTube's keys: `Space` or `K` plays and pauses, `J` and `L` jump 10 seconds back or forward, `Left` and `Right` 5 seconds, `M` mutes, `F` goes full screen and `C` turns captions on or off (video only), and `0` to `9` jump to that tenth of the way through.
 
 ### Images at full size
 
-Press any image, thumbnail or cast picture to open it full size. `Left` and `Right` (or **Previous** and **Next**) move between them; `Esc` or **Close** closes it. At full size, images and thumbnails keep **Regenerate** (it asks first: **Regenerate it** or **Keep it**) and **Download**.
-
-### Live
+Press **Full size** under any image, thumbnail or cast picture (or the picture itself) to open it full size. `Left` and `Right` (or **Previous** and **Next**) move between them; `Esc` or **Close** closes it. At full size, images and thumbnails keep **Make this image again** (it asks first) and **Download**.
 
-**Live** shows the run while it is made:
+### Progress
 
-- **Steps**: each stage and its state.
-- **Article**: the text as the model writes it.
-- **Narration**: a waveform that grows as each part is spoken, with "Narration so far: N seconds". A live player, **Listen while it generates**, plays the audio as it arrives.
-- **Images so far**: each image as it is drawn.
+While the run goes, **Progress** leads the status list and shows the run as it is made:
 
-**Live writing** also appears in a running stage's own section. When a stage makes several calls, a list picks which one to watch. **Follow output** keeps the newest text in view; untick it to read back. Watching costs nothing extra, and the full text is saved when the stage finishes.
+- **Article**: the text as the AI writes it (**Live writing**).
+- **Narration**: a waveform that grows as each part is spoken. **Listen while it generates** plays the audio as it arrives.
+- **Images**: each image as it is drawn.
+- **Video**: how far it is put together.
 
-### Checkpoints
+**Live writing** also appears in a running part's own section. When a step makes several calls, a list picks which one to watch. Watching costs nothing extra, and the full text is saved when the step finishes.
 
-**Checkpoints** lists the review checkpoints of the current revision and what depends on each. When one is holding the run, approve it here or with the next action button (**Approve ... checkpoint**).
+## Edit settings
 
-**Checkpoint choices** lets you change which steps hold:
+**Edit settings** in the title row opens the project's settings in the main column, in the same order and words as Create's rows, with two tabs:
 
-1. Open **Checkpoints** in the section rail.
-2. Under **Checkpoint choices**, tick a step that has not started to add a checkpoint before it, or untick one to remove it. Work already admitted for an unticked step carries on when ready.
-3. Press **Save checkpoints**.
+- **Settings**: every setting of the project, section by section, with **Save changes** and **Discard changes**. Saving keeps a new version without making anything; what the change made outdated is then the next action. Pauses and checks is one of the sections: the pauses for this run (**Pause after the article (before the narration)** and the others) with **Save pauses**, and whether an AI checks the results. See [Editing a Project](Editing-a-Project) and [Pauses and Checks](Reviews-and-Checkpoints).
+- **Versions**: every saved version and its files (**Show its files**), **Free space** on a finished project, and the **Project ID** with **Copy project ID**. See [Editing a Project](Editing-a-Project#versions).
 
-Only generated steps can have a checkpoint. Pausing the project still applies on top. If the project was edited elsewhere, press **Reload checkpoint choices** and make your change again. More in [Reviews and Checkpoints](Reviews-and-Checkpoints).
+While the settings are open the same button reads **Close settings**.
 
 ## Free space
 
-A finished project can drop the working files it was made from (narration parts, subtitle timing, render settings) and keep what gets published: the video, shorts, the images they show, thumbnail, article, description, document and anything you uploaded. In the right rail, **Free space** shows the size of both, for example "Outputs 1.4 GB · working files 1.2 GB", with the button **Free 1.2 GB: keep the outputs, drop the working files**.
+A finished project can drop the working files it was made from (narration pieces, caption timing, video settings) and keep what gets published: the video, shorts, the images they show, thumbnail, article, description, document and anything you uploaded. Under **Edit settings** → **Versions**, **Free space** shows the size of both, for example "Outputs 1.4 GB · working files 1.2 GB", with the button **Free 1.2 GB**.
 
 1. Press the button.
-2. Read what goes, then confirm with **Free 1.2 GB**, or press **Keep the working files**.
+2. Read what goes, then confirm, or keep the working files.
 
-Changing the project later makes those files again first, which takes time and provider credits. The offer is hidden on the bundled samples, while the project runs or waits, and when nothing is left to drop. Settings → **Backup & storage** offers the same for every project (**Keep outputs only**). See [Where Your Files Live](Where-Your-Files-Live).
+When there are old versions, **Delete old versions** frees their files too. Changing the project later makes the working files again first, which takes time and service credits. The offer is hidden on the bundled samples, while the project runs or waits, and when nothing is left to drop. Settings → **Backup & storage** offers the same for every project. See [Where Your Files Live](Where-Your-Files-Live).
 
-## More project actions
+## Project actions
 
-The three dots beside the title hold:
+Under the status list and the cost line, everything else you can do to the project is listed in words, so nothing hides behind a menu:
 
 | Action | What it does |
 | --- | --- |
-| **Choose what to remake…** | Opens the rebuild review for every outdated or failed output. See [Editing a Project](Editing-a-Project#choose-what-to-remake). |
+| **Mark uploaded** / **Mark not uploaded** | Records whether the video is on YouTube, as Copy for YouTube Studio's **I've uploaded it** does. |
+| **Choose what to make again…** | Only when files are outdated: opens the review of every outdated or failed file, to make them again one by one. See [Editing a Project](Editing-a-Project#choose-what-to-make-again). |
+| **Rename…** | Opens the settings on the project title. |
 | **Save as template…** | Saves this project's settings as a template (not for the sample). See [Templates](Templates). |
-| **Cancel the run…** | Stops the run (only while it is running). |
+| **Move to channel…** | Only with two or more channels. |
+| **Posters and edited images…** | The posters and edited images kept with this project, and **Design a poster** or **Edit an image** for it. |
+| **Cancel the run…** / **Delete project…** | Stops the run while it runs; otherwise deletes the project (it goes to Settings → Trash for 30 days). It sits apart, below the others. |
+
+On a sample only **Delete project…** is listed: press **Make my own copy** to rename, save or move your copy. **Mark not uploaded** forgets the video's YouTube link, and its **Undo** saves the link again.
 
 ## Command palette
 
-Press `Ctrl+K` on a project page. Under **This project** you get: the next action (`Shift+N`), **Pause the run** or **Continue the run**, **Prepare upload**, **Edit project settings**, **Choose what to remake**, **Save as template**, **Cancel the run**, the first outdated group (for example **Remake 4 outdated images**), **Remake everything outdated**, **Make my own copy** (sample only), **Copy description** (`Shift+D`) and **Regenerate image N** for every image, including the ones behind **Show all**. Type the number with it, for example `regenerate image 12`; it asks first, as the Regenerate button does. See [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette).
+Press `Ctrl+K` on a project page. Under **This project** you get the next action (`Shift+N`), **Pause the run** or **Continue the run**, **Copy for YouTube Studio**, **Edit settings**, **Save as template**, **Cancel the run**, **Copy project ID**, the outdated files to make again, **Make my own copy** (sample only), **Open the project folder**, **Copy description** (`Shift+D`), **Copy tags**, **Make the thumbnail again** and **Make an image again** (type its number with it, for example `image 12`; it asks first, as the button does). See [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette).
 
 ## Tips
 
 - The sample projects are read-only. Press **Make my own copy** to change one.
-- A failed thumbnail does not stop the video or the PDF: a failed step only stops the steps that need its output. The PDF is then laid out without a cover; make the thumbnail again later and the PDF is marked outdated, ready to remake with it.
+- A failed thumbnail does not stop the video or the PDF: a failed step only stops the steps that need what it makes. The PDF is then laid out without a cover; make the thumbnail again later and the PDF is marked outdated, ready to make again with it.
 - You can close the browser tab while a run is going. The run continues on the computer running Slopify.
 
 ## Related pages
@@ -229,7 +227,7 @@ Press `Ctrl+K` on a project page. Under **This project** you get: the next actio
 - [Editing a Project](Editing-a-Project)
 - [Video Editing](Video-Editing)
 - [Recovery and Retries](Recovery-and-Retries)
-- [Reviews and Checkpoints](Reviews-and-Checkpoints)
+- [Pauses and Checks](Reviews-and-Checkpoints)
 - [Costs and Run Cost](Costs-and-Run-Cost)
 - [Publishing to YouTube](Publishing-to-YouTube)
 - [Home and Projects](Home-and-Projects)

package/dist/tutorials/Prompts-and-Templates.md

@@ -0,0 +1,84 @@
+# Prompts and Templates
+
+Your videos are made from reusable pieces you write once: prompts, intros and outros, and templates that hold a whole setup. They live on two pages in the rail, **Prompts** and **Templates**. The PDF looks, the Pronunciation list and What worked on YouTube that sat beside them before are now where you use them.
+
+**Where to find it:** **Prompts** and **Templates** in the rail (`G` then `L` opens Prompts, `G` then `T` Templates). An old link to the Library opens Prompts.
+
+## Where everything is
+
+| What | Where | Page |
+| --- | --- | --- |
+| **Prompts**: the instructions for articles, images, thumbnails, narration preparation, YouTube descriptions, shorts, reviews, speaker scripts and posts, each with `{{keywords}}` where the subject goes | **Prompts**, one kind at a time down the left | [Prompts](Prompts) |
+| **Intros** and **Outros**: short narrated openings and closings, said word for word or written by the AI for each video | **Prompts** → **Intros** / **Outros**, at the foot of the kinds | [Intros and outros](Intros-and-Outros) |
+| **Video templates**: saved setups a video starts from, and the starter templates | **Templates** → **Video templates** | [Templates](Templates) |
+| **Poster templates**: designed pieces such as posters | **Templates** → **Poster templates** | [Templates](Templates) |
+| **PDF looks**: how the PDF made from the article looks | Create → **Extras** → **PDF of the article** → **Edit PDF looks ↗**, or Settings → **Production defaults** → **PDF look** → **Edit PDF looks** | [PDF looks](Document-Themes) |
+| **Pronunciation**: words the narrator says differently from how they are written, such as Dr. as Doctor | Settings → **Voices** → **Pronunciation** | [Aliases and glossary](Narration-Aliases-and-Glossary) |
+| **What worked on YouTube**: which title or thumbnail won each test YouTube ran | A channel's page → **What worked on YouTube** (once a test of its videos was read) | [Channels](Channels) |
+
+## The Prompts page
+
+The kinds of prompt run down the left, each over a few words on what it writes and with how many of each you have: **Article**, **Image**, **Thumbnail**, **Narration preparation**, **YouTube description**, **Shorts**, **Review**, **Script** and **Post**, then **Intros** and **Outros**. Pick one to list it. On a phone they are one **Showing:** choice above the list.
+
+- The header holds **Import or export** and the button for a new one of the kind you are looking at (for example **New article prompt**).
+- Above the list: **Search all prompts** and **Sort: Name ▾**. Press `/` to jump to the search box. The search looks through every kind, intros and outros included; the number beside each kind then counts the matches there, and picking a kind ends the search.
+- Each row shows the name, what it **Asks for** (its keywords) and its first line, with **Edit**, **Make a video** and a **More** menu.
+- Press a row to show it beside the list: its name, when it was last changed and how many versions it has, the full text, **Asks you for** (the keywords you will be asked on Create) and **Used by** (or "not used yet" on the line under the name).
+- Tick rows to act on several at once. The bar above the list always shows **Select all** and the count; **Duplicate**, **Export** and **Delete** appear on the same line once something is ticked.
+
+### What every row offers
+
+| Action | What it does |
+| --- | --- |
+| **Edit** | Opens the prompt (or intro or outro) in its editor. |
+| **Make a video** | Opens Create with this prompt picked, on the row that shows it. An article prompt switches the article to **Write it for me**, an image prompt is ticked, a thumbnail prompt turns the thumbnail on, and a description or shorts prompt turns that extra on. The rest of your draft stays as it was. |
+| **More** → **Duplicate** | Opens the editor with a copy, for you to rename and save. |
+| **More** → **Versions** | Opens the prompt's versions and a side-by-side compare. See [Prompts](Prompts#history-and-versions). |
+| **More** → **Delete** | Asks first, then moves it to **Settings** → **Trash** for 30 days. See [Trash](Trash). |
+
+In the prompt and the intro and outro editors, `Ctrl+S` (`Cmd+S`) saves, even while you are typing in a field.
+
+## The Templates page
+
+Two tabs: **Video templates** (with how many you have) and **Poster templates**. The header holds **Add starter templates** and **More** → **Import a template file (.zip)**.
+
+Each video template is a card with a preview, its name, a line saying what it makes (shape, voice, length, captions, shorts), what it **Asks for**, and:
+
+| Action | What it does |
+| --- | --- |
+| **Make a video** | Opens Create with a fresh draft made from the template. |
+| **Edit template** | Opens the template's editor, in the same rows as Create. See [Edit template](Template-Studio). |
+| **More** → **Duplicate** | Copies the template. |
+| **More** → **Versions** | Lists the template's saved versions. |
+| **More** → **Export as a file (.zip)** | Saves the template as a file you can import on another computer. |
+| **More** → **Delete…** | Asks first, then moves it to the trash for 30 days. |
+
+## Starter templates
+
+**Templates** → **Add starter templates** adds a ready-made set for one kind of channel: prompts, a suggested voice and a video template. There are four: Sleep lore, True crime, History and Science explainers. Adding one twice changes nothing, and it never replaces a prompt or template of yours with the same name. See [Templates](Templates#starter-templates).
+
+## Command palette shortcuts
+
+Press `Ctrl+K` anywhere and type to find **Open Prompts**, **Open Templates**, **New prompt**, **New intro** or **New outro**, **New PDF look**, **Open PDF looks**, **Open Pronunciation**, **Open What worked on YouTube**, or a saved item by name: **Open template <name>**, **Edit prompt <name>**, **Edit intro <name>** / **Edit outro <name>** and **Edit PDF look <name>**. See [Keyboard and Ctrl+K](Keyboard-Shortcuts-and-Command-Palette).
+
+## Fonts
+
+There is no separate font manager. Fonts live where they are used:
+
+- **Caption fonts:** upload your own in the **Caption font** picker in Create's **Video and style** row. Uploaded fonts then appear in a channel's brand kit too. See [Video and style](Create-Video-and-Style) and [Channels](Channels).
+- **PDF fonts:** each PDF look picks its fonts from the bundled Cinzel and the fonts built into every PDF reader (Times, Helvetica, Courier). See [PDF looks](Document-Themes).
+
+Uploaded fonts travel in backups, but templates leave them out.
+
+## How changes reach your videos
+
+A project copies the prompts, intros, outros, aliases and theme settings it uses when it starts. Editing a prompt later changes only runs started afterwards. Templates also keep their own copies, so save a template again to pick up a changed prompt. In a project, **Edit settings** shows the project's own copy of each prompt: pick your saved prompt again to bring in your latest edit. See [Editing a Project](Editing-a-Project).
+
+## Related pages
+
+- [Prompts](Prompts)
+- [Intros and outros](Intros-and-Outros)
+- [Templates](Templates)
+- [Edit template](Template-Studio)
+- [PDF looks](Document-Themes)
+- [Aliases and glossary](Narration-Aliases-and-Glossary)