@gentbajko/slopify 4.0.0 → 4.2.0

package/dist/tutorials/First-Launch-and-Welcome.md

@@ -1,69 +1,60 @@
 # First Launch and Welcome
 
-The first time you open Slopify it walks you through three steps: what your computer already has, a style, and your first 60-second short. The short is being made by the time you finish, and three finished sample projects are there to explore while you wait, without spending anything.
+The first time you open Slopify it walks you through three steps: what a short needs and what your computer already has for it, a style, and your first 60-second short. The short is being made by the time you finish, and three finished sample projects are there to explore, without spending anything.
 
-**Where to find it:** it opens by itself on a fresh install. Its address is `http://127.0.0.1:6969/welcome`.
+**Where to find it:** it opens by itself on a fresh install. Its address is `http://127.0.0.1:6969/welcome`; `?step=style` or `?step=make` opens a later step.
 
 ## What happens the first time
 
-1. **Anonymous usage stats.** A notice lists exactly what is counted and what never is. Press **Got it** to continue. It shows once per machine. See [Install](Install#anonymous-usage-stats).
-2. **Welcome to Slopify.** Home sends you to the first-run screen once. It has three steps, shown as tabs: **1 · What you have**, **2 · Pick a style** and **3 · Make your first short**. **Next** and **Back** at the bottom move between them, and you can click a tab directly.
-3. **Start at login.** The last step offers **Start when I log in** once, unless you already answered in the terminal.
+1. **Usage stats.** A line on the bottom edge of the window says that Slopify adds what it makes (videos, images, words) to the public totals on its website, slopify.stream, anonymously, and that nothing you type is counted. **What's counted** opens the full list in place; **Start counting** puts the line away. Nothing is counted before you press **Start counting**. The page above it works as usual. See [Install](Install#anonymous-usage-stats).
+2. **Welcome to Slopify.** Home sends you to the first-run screen once. Each step has a title and "Step 1 of 3"; **Next** and **Back** in the bar at the bottom of the window move between them.
+3. **Start at login.** Step 3 asks once, in one line: **Start when I log in** or **No thanks**.
 
-The first-run screen stops appearing for good when you press **Skip** (it reads **Done** once your short is on its way), or when your first real project exists (anything except the samples), even if you delete that project later.
+The first-run screen stops appearing for good when you press **Skip** (it reads **Done** once your short is on its way), or when your first real project exists (anything except the samples), even if you delete that project later. Leaving it this way also answers the start-at-login question as no; you can still turn it on in Settings → **General**.
 
-## Step 1: What you have
+If you leave for Settings to add a key, the welcome keeps its step, your topic and your style for when you come back.
 
-### Found on this computer
+## Step 1: What a short needs
 
-Slopify looks for Claude Code, Codex and Antigravity CLI and shows one row for each:
+A 60-second short needs three things, named by the stage each makes, as Settings → **Keys & services** names them. Each has its own line, with its state and, when it is missing, the one button that fixes it:
 
-| Row says | Meaning |
-| --- | --- |
-| **Ready · 1.2.3 · writes** | Installed, a supported version and signed in, as far as Slopify can tell. It can write the text. |
-| **Ready · … · writes and draws** | Codex: it writes the text and draws the images. |
-| **Installed, not usable yet** or a reason | Found, but something is missing, such as a sign-in. The reason is shown. |
-| **Not found** | Not installed, or not on the `PATH` Slopify sees. |
-
-When at least one is ready, the step says which parts need no API key, for example "You can make a video now: no API keys are needed for the text, the images or the narration." When none is ready, it says "Nothing on this computer can write the script yet." with **Open Settings → Providers**: install and sign in to a CLI, or add an OpenRouter key.
-
-### Narration voice
+| Line | Ready when | Fix when it says **No key** |
+| --- | --- | --- |
+| **Article** | Claude Code, Codex or Antigravity is installed and signed in, or an OpenRouter key is saved. It says who writes it, for example "Claude Code writes it with your sign-in." | **Add a key for writing** (opens Settings at OpenRouter), or sign in to one of the tools. |
+| **Narration** | A voice key is saved, or your computer has a speech program. | **Add a voice key** (opens Settings at OpenAI: its key works at once with the voices Slopify sets up). On Linux, **Use your computer's free voice instead** shows the commands that install `espeak-ng`; run one, then press **Check again**. |
+| **Images** | Codex is signed in, or an OpenAI, Google, fal.ai or Replicate key is saved. | **Add an image key** (opens Settings at OpenAI). |
 
-The second part says who will read the script aloud:
+When the computer's own voice reads the article, the Narration line says so and offers **Add a voice key** for a better one. With an ElevenLabs, Cartesia or Inworld key but no voice saved, it says **No voice saved** with **Save a voice** (Settings → **Voices**) and **Add an OpenAI key**.
 
-| It says | Meaning |
-| --- | --- |
-| "Narration uses your *provider* voice key." | A voice key (OpenAI, ElevenLabs, Cartesia or Inworld) is saved, so that provider narrates. |
-| "Narration uses your computer's built-in voice (*engine*); add an ElevenLabs or OpenAI key later for a better one." | No voice key, so the computer's own speech narrates, for free. See [the system voice](Providers-and-Keys#the-system-voice). |
-| "No voice can narrate the short yet." | Neither a key nor a speech program was found. Press **Add a voice key**, or install a speech program (on Linux, `espeak-ng`) and press **Check again**. |
+**Check again** looks again, including for a speech program installed a moment ago. **Other tools and services Slopify can use** opens Settings → **Keys & services**. Below the lines, the three finished samples are there to watch (see [Explore the samples](#explore-the-samples)).
 
-**Add a voice key** opens Settings → **Providers**. See [AI CLIs](AI-CLIs) and [Providers and Keys](Providers-and-Keys).
+See [AI CLIs](AI-CLIs) and [Keys and Services](Providers-and-Keys).
 
 ## Step 2: Pick a style
 
-Each row is a style for the short. **General** is a neutral explainer style; the others are the starter packs (Sleep lore, True crime, History, Science explainers). Press **Use this style** on a row; it then reads **Picked**.
+Each row is a style for the short. **General** is a neutral explainer style; the others are the starter templates' styles (Sleep lore, True crime, History, Science explainers). Press a row to pick it; the picked row reads **Picked**.
 
-Making the short with a pack adds that pack's script and scene prompts to your Library and its suggested voice to Settings → **Voices**. **Add to library** on a pack's row also adds its Play template, for later long videos; it then reads **In your library**. See [Starter packs](#starter-packs).
+Making the short with one of them adds its script and scene prompts to Prompts and its suggested voice to Settings → **Voices**. See [Starter templates](#starter-templates).
 
 ## Step 3: Make a 60-second short
 
 A topic in, a captioned vertical short out, usually in about five minutes with the command-line tools. It has its own page: [Your First Short](Your-First-Short).
 
-The step repeats the style and the voice line from step 1. If no voice can narrate yet, it shows the same **Add a voice key** and **Check again** buttons.
-
 | Field | What it does | Limits |
 | --- | --- | --- |
-| **Topic** | What the short is about, in a few words or a question. A specific topic gives a sharper short than a broad one. | Up to 200 characters |
+| **Topic** | What the short is about, in a few words or a question. A specific topic gives a sharper short than a broad one. The line under it says the style and who writes, reads and draws it. | Up to 200 characters |
 
-Press **Make a 60-second short**. The status line says **Starting your short…**, then the step says "Your short is being made." with **Watch it being made**, which opens the project's page and its live view. While it runs, the samples and the start-at-login offer are right below.
+If something is still missing, the step shows the same lines as step 1 under the topic, and **Make a 60-second short** is not lime until they are ready. Pressed anyway, the status line says "The short didn't start. Fix the lines above that are not Ready, then press Make a 60-second short again."
+
+Press **Make a 60-second short** in the bar at the bottom. With no topic it puts you in the field and says "Type a topic first." Otherwise the status line says **Starting your short…**, then the step says "Your short is being made." and the bar offers **Watch it being made**, which opens the project's page. The samples are listed below while it runs.
 
 ## Explore the samples
 
-Three finished projects come with Slopify, marked **Sample** in Projects. Step 3 of the first-run screen lists them under **While you wait: the samples**. They are read-only, so nothing you do on them reaches a paid provider.
+Three finished projects come with Slopify, marked **Sample** in Projects. Step 1 of the first-run screen lists them, and step 3 again while your short is being made. They are read-only, so nothing you do on them reaches a paid provider.
 
 | Sample | What it shows | Button |
 | --- | --- | --- |
-| **The Library of Alexandria** | A 3-minute narrated 16:9 video with burned-in captions, chapter cards and a warm Look, plus its two shorts, the article, the PDF, a YouTube description with chapters, four images and a thumbnail. | **Explore the sample** |
+| **The Library of Alexandria** | A 3-minute narrated 16:9 video with captions in the picture, chapter cards and a warm Look, plus its two shorts, the article, the PDF, a YouTube description with chapters, four images and a thumbnail. | **Explore the sample** |
 | **The Wind in the Willows** | An audiobook of an abridged excerpt: a narrator and two character voices, captions tagged with who speaks, and an MP3 and M4B with chapters. | **See an audiobook** |
 | **The Antikythera Mechanism** | A two-host podcast with the speaker panel, name tags and portraits, and its MP3 and M4B. | **Hear a podcast** |
 
@@ -76,77 +67,72 @@ A sample's project page says "This is the sample project, finished and free to e
 1. Open a sample.
 2. Press **Make my own copy** (also in the command palette, `Ctrl+K` → **Make my own copy**).
 3. Slopify copies every file and setting of that sample into a new, normal project. Nothing needs to be made again: the copy is finished too.
-4. Edit the copy like any project. Changes to it use your providers and cost what they cost. See [Editing a Project](Editing-a-Project).
+4. Edit the copy like any project. Changes to it use your services and cost what they cost. See [Editing a Project](Editing-a-Project).
 
 ### Restore the samples
 
-1. Open Settings → **Backup & storage** and scroll to **Sample projects**.
-2. Each sample shows whether it is **in your projects** or **not in your projects**, with **Open**.
-3. Press **Restore samples**. It puts all three back as they shipped: it adds back any that were deleted and replaces the others with the originals. Your own copies are not touched.
+1. Open Settings → **Backup & storage** and scroll to **Disk space**.
+2. Press **Restore samples**. The line beside it says which samples it brings back. It puts all three back as they shipped: it adds back any that were deleted and replaces the others with the originals. Your own copies are not touched.
 
-## Starter packs
+## Starter templates
 
-A starter pack sets you up for one kind of channel. Each one adds, in one go:
+A starter template sets you up for one kind of channel. Adding one (**Templates** → **Add starter templates**) adds, in one go:
 
-- prompts to your Library: an article prompt, a 60-second script, an image (scene) prompt, a thumbnail prompt, a description prompt and a shorts prompt, each asking only for `{{topic}}`;
+- prompts on Prompts: an article prompt, a 60-second script, an image (scene) prompt, a thumbnail prompt, a description prompt and a shorts prompt, each asking only for `{{topic}}`;
 - a suggested OpenAI voice, saved under Settings → **Voices**;
-- a Play template that uses them, named `<pack> starter`, with its captions, motion and Look.
+- a template that uses them, named `<style> starter`, with its captions, motion and Look.
 
-Then you pick the template on Play, type a topic and start. See [Templates](Templates) and [Play Overview](Play-Overview).
+Then you pick the template in Create, type a topic and start. See [Templates](Templates) and [Create Overview](Create-Overview).
 
-| Pack | What it is for | Suggested voice |
+| Starter template | What it is for | Suggested voice |
 | --- | --- | --- |
 | **Sleep lore** | Slow, gentle myths and legends told to fall asleep to. | OpenAI `sage` |
 | **True crime** | Measured, factual retellings of real cases and their investigations. | OpenAI `onyx` |
 | **History** | Narrative history of people, places and events, told like a documentary. | OpenAI `fable` |
 | **Science explainers** | Clear, friendly explanations of how the world works, one idea at a time. | OpenAI `nova` |
 
-On the first-run screen, **Add to library** on a pack's row adds all of this; it then reads **In your library**. Making a short with a pack adds its prompts and voice only, not the template.
+Making a short in one of these styles on the first-run screen adds its prompts and voice only, not the template.
 
-- Adding a pack twice changes nothing.
-- It never replaces a prompt or template of yours with the same name: the pack's copy comes in as `<name> (2)`.
-- An item the pack added before and you edited is kept as you left it. One you deleted comes back.
+- Adding a starter template twice changes nothing.
+- It never replaces a prompt or template of yours with the same name: the starter's copy comes in as `<name> (2)`.
+- An item a starter template added before and you edited is kept as you left it. One you deleted comes back.
 
-You can add packs later too, from Library → **Templates** → **Add pack**.
+You can add them later too, from **Templates** → **Add starter templates**.
 
 ## Start when I log in
 
-Step 3 of the first-run screen asks once: **Start when I log in** or **No thanks**. Either answer, here, in Settings → **General** or in the terminal, ends the question. See [Start at Login](Start-at-Login).
+Step 3 of the first-run screen asks once, in one line: **Start when I log in** or **No thanks**. Either answer, here, in Settings → **General** or in the terminal, ends the question; so does leaving the first-run screen, as a no. See [Start at Login](Start-at-Login).
 
-## Set up a long video instead
+## Make a long video instead
 
-At the bottom of every step, **Set up a long video instead** takes you to Play, where you choose prompts, keywords and outputs yourself. See [Play Overview](Play-Overview).
+On steps 1 and 2, **Make a long video instead** in the bottom bar takes you to Create, where you choose prompts, keywords and extras yourself. See [Create Overview](Create-Overview).
 
 ## The interactive tutorial
 
-The question-mark button at the foot of the sidebar (**Start interactive tutorial**) walks you through a first project in 25 steps ("3 of 25 · First project"):
+**Help → Start the tour** at the foot of the rail walks you through a first project in 25 steps ("3 of 25 · First project"):
 
-1. **Settings:** connect a text, a voice and an image provider, and add a narration voice.
-2. **Library:** write and save an article prompt with keywords, then an image prompt.
-3. **Play:** name the project, choose the article, keywords, narration, images, video and subtitles, then review and start the run.
-4. **The project:** follow and control the run, download the results, see what the run cost and prepare the YouTube upload.
+1. **Settings:** connect a writing, a voice and an image service, and add a narration voice.
+2. **Prompts:** write and save an article prompt with keywords, then an image prompt.
+3. **Create:** type the topic, choose the article, keywords, narration, images, video and captions, then check it and make the video.
+4. **The project:** follow and control the run, download the results, see what the run cost and copy everything for YouTube Studio.
 5. **The rest of the app:** check Home each day, set up a channel, and plan uploads on the calendar.
 
 Each step highlights the real control you will use and opens its screen for you. Your place is saved, so it survives a page reload. On the review-and-start step, **Skip generating** leaves the run unstarted and goes on to Home, Channels and the Calendar instead of ending the tutorial. Other steps have **Skip this step** (or **Skip without saving**).
 
-When Projects has no projects at all, it also shows **Make your first video** with **Start tutorial**.
-
-## The provider welcome in Settings
-
-Settings → **Providers** shows a short welcome on a fresh install that names the command-line tools it found and says a video can be made without an API key. Press **Got it** to hide it.
+When Projects has no projects at all, it also shows **Make your first video** with **Start the tour**.
 
 ## Tips
 
 - Try a sample before you add any keys: every screen works on it, and nothing costs anything.
 - You can come back to the first-run screen at `/welcome` until you skip it or make a real project.
 - After an update to a new major version, a **What's new** tour opens instead. See [Updating and Patch Notes](Updating-and-Patch-Notes).
-- Already use Claude Code or Codex? Settings → Connections → **Agents (MCP)** has one line that lets it run Slopify for you: start and fix runs, answer reviews, everything up to Ready to upload. See [Agents (MCP)](Agents-MCP).
+- Already use Claude Code or Codex? Settings → **AI agents** has one line that lets it run Slopify for you: start and fix runs, answer AI checks, everything up to Ready to upload. See [Agents (MCP)](Agents-MCP).
 
 ## Related pages
 
 - [Your First Short](Your-First-Short)
 - [Home and Projects](Home-and-Projects)
-- [Providers and Keys](Providers-and-Keys)
+- [Keys and Services](Providers-and-Keys)
 - [AI CLIs](AI-CLIs)
 - [Templates](Templates)
 - [Prompts](Prompts)

package/dist/tutorials/Home-and-Projects.md

@@ -1,211 +1,236 @@
 # Home and Projects
 
-Home is Slopify's front page: what needs you, what is running, what is coming up, what is ready to upload and what this week cost, on one screen. Projects is the full list of every run you ever started, with search and filters.
+Home is Slopify's front page: your finished videos with Watch and Download, what needs you, what is running and waiting to start, what is coming up and what this week cost, on one screen. Projects is the full list of every run you ever started, with search and filters.
 
-**Where to find it:** the sidebar → **Home** (the Slopify logo also goes there) and **Projects**. On a phone, the bottom bar.
+**Where to find it:** the rail → **Home** (the Slopify logo also goes there) and **Projects**. On a phone, the bottom bar.
 
 ## Finding your way around
 
-Every page shares the same frame: the sidebar on the left and the page beside it. On a computer there is no top bar; everything lives in the sidebar.
+Every page shares the same frame: a narrow rail on the left, an icon with a word under it for each place, and the page beside it. On a computer there is no top bar; everything lives in the rail.
 
-### The sidebar
+### The rail
 
 From top to bottom:
 
 | Part | What it has |
 | --- | --- |
-| Logo | The Slopify play logo and name, with the version you are running beside it (for example `v3.0.0`). Click it to go Home. |
-| **Search or run a command** | Opens the command palette (`Ctrl+K`). |
-| Destinations | **Home**, **Projects**, **Calendar** (also lit on Schedules), **Channels**, **Library** (Templates; Prompts, Intros & outros, PDF themes, Narration aliases; A/B results), **Settings** (also lit on Usage). |
-| **N running** | Shown while runs are going. It links to Running now on Home. |
-| **Channel** | The channel picker (see below). |
-| **Create** | Opens Play to make a new project (`C` from anywhere). |
-| Links | **GitHub**, **Patreon** and **Buy Me a Coffee**, each opening in a new tab. |
-| Foot | "Free. Your keys, your machine.", the updates button (circular arrows, see [Updating and Patch Notes](Updating-and-Patch-Notes)), the **Tutorials** button (book, the guides; its page also has **Welcome screen**) and the tutorial button (question mark, **Start interactive tutorial**). |
+| Logo | The Slopify play logo. Click it to go Home. |
+| **Create** | The lime key. Opens Create to make a new video (`C` from anywhere). |
+| Destinations | **Home**, **Projects**, **Prompts** (also lit on Intros and outros), **Templates** (also lit on Designs), **Calendar** (also lit on Schedules), **Channels** (only once you have two or more channels; also lit on What worked on YouTube) and **Settings** (also lit on Usage, PDF looks and Pronunciation). |
+| **N running** | Shown while runs are going: a lamp and the count over the word running. It links to **Running** on Home. |
+| **Update ready** | Shown only while a new version of Slopify is ready, waiting or installing. It opens a menu that says what installing does, with **Install update**. See [Updating and Patch Notes](Updating-and-Patch-Notes). |
+| **Search** | Opens the command palette (`Ctrl+K`). |
+| **Assistant** | Opens the assistant beside the page. See [Assistant](Assistant). |
+| **Help** | **Start the tour** (the interactive tutorial), **Tutorials** (the guides, whose page also has **Welcome screen**), **Keyboard shortcuts**, **What's new** (the patch notes) and **Check for updates**, with the version you are running. |
+| **Support Slopify** | **GitHub**, **Patreon** and **Buy Me a Coffee**, each opening in a new tab. |
 
 ### On a phone
 
-Below 768 pixels wide the sidebar is hidden. A slim bar at the top holds the logo, the search button, the running count, the GitHub, Patreon and Buy Me a Coffee icons, the updates button and the tutorial button. A bottom bar has all six destinations: Home, Projects, Calendar, Channels, Library and Settings. The Channel picker sits at the top of Home.
+Below 768 pixels wide the rail is hidden. A slim bar at the top holds the logo, the running count, **Search** and **Help**; on a phone Help also holds the **Assistant** and the support links, and turns lime-ink when an update is ready. A bottom bar has **Home**, **Projects**, the lime **Create** in the center, **Prompts** and **More** (Templates, Calendar, Channels and Settings).
 
 ### Rows open with one press
 
-In every list, a press anywhere on a row or tile opens or picks it, not only on its name: projects, Home items, calendar entries, channels, schedules, Library lists, samples, saved drafts and media tiles. The buttons on a row still do their own thing.
+In every list, a press anywhere on a row or tile opens or picks it, not only on its name: projects, Home items, calendar entries, channels, schedules, the lists of prompts and templates, samples, saved drafts and media tiles. The buttons on a row still do their own thing.
 
 ### The command palette
 
-Press `Ctrl+K`, or click **Search or run a command**, to jump anywhere or run an action by typing. The **Go to** group has **Open home**, **Open projects**, **Open calendar**, **Open schedules**, **Open channels**, **Open library**, **Open settings**, **Open usage and costs**, **Open tutorials** and **Show patch notes**. **Create** opens Play. The **Channel** group has **Show all channels** and **Switch to <channel>**. See [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette).
+Press `Ctrl+K`, or click **Search**, to jump anywhere or run an action by typing. With nothing typed it opens on **Create a video**, then the **Go to** group in the rail's order: **Open Home**, **Open Projects**, **Open Prompts**, **Open Templates**, **Open Calendar**, **Open Channels** (listed once you have two or more channels) and **Open Settings**. Typing also finds **Open schedules**, **Open usage and costs**, **Open tutorials** and **Start the tour**. With two or more channels the **Channel** group has **Show all channels** and **Switch to <channel>**. See [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette).
 
 ### The Channel picker
 
-The **Channel** picker near the foot of the sidebar (at the top of Home on a phone) shows Home and the other screens for one channel, or for **All channels**. It only filters what you see: projects, schedules and costs of other channels keep running. Slopify remembers your choice in this browser. See [Channels](Channels).
+With two or more channels, Home, Projects and the Calendar show **Showing: All channels ▾** in their page header. Pick a channel to see only its work, or **All channels** for everything. It only filters what you see: projects, schedules and costs of other channels keep running. Slopify remembers your choice in this browser. With one channel there is nothing to pick, so it is not shown. See [Channels](Channels).
 
 ## Home
 
-**Where to find it:** the sidebar → **Home**.
+**Where to find it:** the rail → **Home**.
 
-The page title is the channel you picked (or **Home**), under today's date. At the top right are **Open calendar** and **New project**.
+One line at the top: today's date and **Home**, then **Showing:** (the channel picker, only with two or more channels) and **Open calendar** (only once a schedule exists). **Create** is in the rail and the phone's bottom bar.
 
 On a fresh install, Home sends you to the first-run screen once. See [First Launch and Welcome](First-Launch-and-Welcome).
 
+### Before your first video
+
+Until you have a project of your own, Home shows:
+
+- **Your first video**: what a video needs on this computer (Article, Narration, Images), each with its state (**Ready**, **No key** or **No voice saved**) and the button that fixes it, the same list as the first-run screen. **Make your first video** opens Create; it is lime once nothing is missing.
+- **Finished samples**: the bundled samples, each with its picture, its length, what it made, **Watch** and **Download video**. They stay on Home until you have finished a video of your own.
+
+### Finished
+
+What your runs made, newest finished first, up to 6 (**See all N finished in Projects** opens Projects with the most recently finished first). The heading counts them and says how many are still to upload, for example **4 videos · 2 ready to upload**. Each row has the thumbnail, the title, the state in words (**Ready to upload**, **Uploaded**, **Done with problems**, or **Done** for a run that made no video) and one line such as `3:05 · 16:9 · video + 2 shorts + PDF · finished Sep 27`, then:
+
+- **Watch** opens the project on its Video section (**Open**, for an audiobook or anything else without a video).
+- **Download video** saves the video file.
+
+A video that was made but lost another step reads **Done with problems** and names the step, for example **PDF failed**, with **See what failed** opening that section of the project. Marking a video uploaded (on Projects, or in the project's upload pack) changes its word to **Uploaded**; it stays here. The bundled samples are never here: they have their own **Finished samples** until you have finished work of your own.
+
 ### Needs you
 
-One work list: the things that don't move on until you act, then the finished videos ready to upload.
+The things that don't move on until you act:
 
 | Item | Status | Button |
 | --- | --- | --- |
-| A run held at a review before a step | **Waiting for your review · before the narration** (or the images, or the video) | **Approve the article and record**, **Approve and draw the images** or **Approve and render**. Approving here lets the run continue. Open the project to look first. |
+| A run held at a pause before a step | **Waiting for your review · before the narration** (or the images, or the video) | **Approve and make the narration**, **Approve and make the images** or **Approve and make the video**. Approving here lets the run continue. Open the project to look first. |
 | A run whose next step is held another way | **Waiting for your review** | **Open to continue** |
 | A run a restart stopped before it finished | **Stopped** | **Continue the run**, or **Keep as is** to leave the rest unmade |
 | A run you (or an agent) paused | **Paused** | **Open to continue** |
 | Topics a schedule suggested | **N new topics** | **Review topics**, on the calendar: queue the ones you want and reject the rest. |
-| A failed run | **Failed · <step>**, with a short reason | The fix to try: a button to Settings → Providers or Backup & storage when that is the fix, otherwise **Open to retry**. |
+| A failed run | **Failed · <step>**, with a short reason | The fix to try: a button to Settings → Keys & services or Backup & storage when that is the fix, otherwise **Open to retry**. |
 | A run that failed because a CLI is signed out | **Failed · <step>** | **Copy sign-in command** copies the command (`claude auth login`, `codex login` or `agy`). Run it in a terminal on the computer running Slopify, then **Open to retry** and press **Check again** on the project. |
-| A finished video you have not marked uploaded | **Ready to upload** | **Prepare upload** lists everything YouTube Studio asks for, with Copy buttons (Slopify never uploads for you; see [Publishing to YouTube](Publishing-to-YouTube)). **Mark uploaded** takes it off the list, with **Undo** in the notice; Projects still has it. |
 
-A held run also offers **Keep as is**, which takes it off Needs you and leaves the rest unmade (with **Undo**); editing the project brings it back. A run waiting for an [agent's review](Agents-MCP#the-external-agent-reviewer) is not here: it goes on by itself, so it shows under Running now. A step that failed while the run waits on something else shows here as a failed item.
+A held run also offers **Keep as is**, which takes it off Needs you and leaves the rest unmade (with **Undo**); editing the project brings it back. A run waiting for an [agent's review](Agents-MCP#your-own-ai-agent-as-the-checker) is not here: it goes on by itself, so it shows under Running. A step that failed while the run waits on something else shows here as a failed item. Up to 4 failed runs show; **See all N failed** opens Projects filtered to them.
+
+Only one button in the column is lime: the first decision's when there is one, otherwise **Watch** on the newest video. With nothing finished, waiting or running, Home says so, with **Make a video**. See [Pauses and Checks](Reviews-and-Checkpoints), [Schedules](Schedules) and [Recovery and Retries](Recovery-and-Retries).
 
-Up to 4 failed runs and 4 videos ready to upload show here; **See all N ready to upload** opens Projects filtered to them. The bundled samples never show as ready to upload. Only the first item's button is lime; the rest are plain buttons. The heading says how many decisions are waiting and how many videos are ready to upload. With nothing waiting and nothing running, Home says **Nothing needs you and nothing is running**. See [Reviews and Checkpoints](Reviews-and-Checkpoints), [Schedules](Schedules) and [Recovery and Retries](Recovery-and-Retries).
+### Running
 
-### Running now
+Videos being made, and runs **Waiting for the agent** (your own AI agent checks what they made; they carry on once it answers or after 2 hours), up to 3. Paused runs are under Needs you. Each shows:
 
-Videos being made, and runs **Waiting for the agent** (an External agent reviews what they made; they carry on once it answers or after 2 hours), up to 3. Paused runs are under Needs you. Each shows the step it is on, how long each step has taken, the running step's time left (for example `2 of 8 · about 4 min left`), the last few images as they land (with a tile for the one being drawn) and **Images N of M** while drawing. A run waiting for a CLI plan says so instead of the step, for example **Waiting for Codex limits (resets at 14:00)**. Open one to follow it live, pause it or cancel it. With nothing running it says **Start the next video**.
+- **Running** beside the title, and where the whole run stands, for example `Step 2 of 4 · Narration · about 4 min left on this step`.
+- Each step with its state, how long it took, and the running step's time left (for example `2 of 8 · about 4 min left`).
+- The last few images as they land, with a tile for the one being drawn.
 
-- With more than three running, **See all N running** opens Projects filtered to running.
-- Queued runs show as one line under them, for example "Queued, waiting to start (2): Hypatia, Cleopatra", with **See queued** (Projects filtered to queued).
+A run waiting for a CLI plan says so instead, for example **Waiting for Codex limits (resets at 14:00)**. With more than three running, **See all N running** opens Projects filtered to running.
 
-Time left comes 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. Past that it says **taking longer than usual**, and with nothing to go by **time left unknown**.
+Under them, **Waiting to start** lists the videos queued behind them (for example after **Queue 3 videos** in Create), numbered in the order they will start. **Earlier** and **Later** change the order; **Remove** takes one out of the queue and puts it in the trash, with **Undo**. Pausing a project holds the queue; when one fails or is canceled, the next one starts.
+
+Time left comes 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. Past that it says **taking longer than usual**; with nothing to go by the time is left out.
+
+When a run ends, a notice in the corner says so on whatever page is open, for example **Video ready: The history of the lighthouse** with **Watch**, whether or not browser notifications are on. See [Notifications](Notifications).
 
 ### Coming up
 
-The schedule runs due in the next 7 days, with the template and topic each will use, up to 6. Paused schedules show too. **Calendar** opens the calendar to plan or move runs. With none it says **No scheduled runs this week. Plan some on the calendar.** See [Calendar](Calendar).
+Shown once you have a schedule: the schedule runs due in the next 7 days, with the template and topic each will use, up to 6. Paused schedules show too. With none it says **No scheduled runs in the next 7 days.** See [Calendar](Calendar).
 
 ### Autopilot
 
-At the top of **Coming up**, one line says how far ahead you are: "9 days of content ready · the queue runs dry on Oct 30". Each run a schedule will make in the next 60 days is a slot; a run made ahead (Prepare) fills its own slot, and each finished video not uploaded yet fills the next empty one. The days count to the first slot nothing fills ("60+" when all of them are filled). **Runs dry** is the first run that will have no topic: the run after a queue's last topic when the schedule doesn't find its own, the first run past the approved topics when new ones wait for approval, and never for a schedule that finds topics by itself unless finding them fails. Paused schedules count for neither, and neither do runs a schedule skips because its template has no version marked ready.
+At the top of **Coming up**, one line says how far ahead you are: "9 days of content ready · topics run out on Oct 30". Each run a schedule will make in the next 60 days needs a video; a run made ahead (**Make ahead**) is its own, and each finished video not uploaded yet fills the next run without one. The days count to the first run nothing fills ("60+" when all of them are filled; "Every run has a video ready" when they are and the topics run out first). **Topics run out** on the first run that will have no topic: the run after a queue's last topic when the schedule doesn't find its own, the first run past the approved topics when new ones wait for approval, and never for a schedule that finds topics by itself unless finding them fails. Paused schedules count for neither, and neither do runs a schedule skips because its template has no version approved for schedules.
 
 Below it, warnings name what may stop the schedules before it does, each with the button that opens the fix and **Hide** (hidden for 7 days, or until it changes):
 
 | Warning | Fix |
 | --- | --- |
-| A CLI a scheduled template uses is signed out | Settings → Providers |
+| A CLI a scheduled template uses is signed out | Settings → Keys & services |
 | A CLI plan is at 80% of its weekly or 5-hour limit | Settings → Usage |
-| The OpenRouter key has less than 20% of its spending limit left | Settings → Providers |
+| The OpenRouter key has less than 20% of its spending limit left | Settings → Keys & services |
 | Less than 5 GB, or less than 10%, of the disk is free | Settings → Backup & storage |
 | A schedule that doesn't find topics has 1 or 2 left | The schedule |
 | A schedule's topic generation keeps failing | The schedule |
 | A scheduled template or schedule uses a model that is retiring or gone | Templates, or the schedule |
-| A schedule skips its runs because its template has no version marked ready | Templates (Open studio, then Mark ready) |
+| A schedule skips its runs because its template has no version approved for schedules | Templates (**Edit template** → **More** → **Approve for schedules**) |
 
-Sign-ins, the OpenRouter key and the disk are checked hourly, the first time 30 seconds after Slopify starts; Home shows the last check and never waits for one. Only the CLIs a scheduled template uses are asked, and asking never starts a run. **Last 7 days**, folded, lists what was made, each failed step with a link to its project, and what it cost. Settings → Notifications → **Weekly report** sends the same to your phone each Monday (see [Notifications](Notifications#weekly-report)).
+Sign-ins, the OpenRouter key and the disk are checked hourly, the first time 30 seconds after Slopify starts; Home shows the last check and never waits for one. Only the CLIs a scheduled template uses are asked, and asking never starts a run. **Failed in the last 7 days**, folded, lists each failed step with a link to its project; it is hidden when no step failed. What was made and spent is under **This week**. Settings → Notifications → **Weekly report** sends the same to your phone each Monday (see [Notifications](Notifications#weekly-report)).
 
 ### This week
 
-Since Monday, for the picked channel:
+Since Monday, for the channel shown, in one line: the videos made and what their calls to the services cost, for example `3 videos · $9.40 spent · ~$31.00 via API`. Calls billed to a command-line plan cost nothing per call; **~$X via API** says what they would have cost with API keys. Calls with no known price are counted separately (**N calls without a price**). Under it, a bar per command-line plan shows how much of its weekly limit is used, from the tool's last reading; it turns amber at 80%. Nothing shows before anything was made or spent this week. See [Costs and Run Cost](Costs-and-Run-Cost).
 
-| Figure | Meaning |
-| --- | --- |
-| **videos made** | Videos finished since Monday. |
-| **spent** | What their provider calls cost. Calls billed to a command-line plan cost nothing per call; **~$X via API** says what they would have cost with API keys. Calls with no known price are counted separately (**N calls without a price**). |
-| **weekly <plan> limit** | How much of each command-line plan's weekly limit is used, from the tool's last reading. The bar turns amber at 80%. |
+### Start from a template
 
-See [Costs and Run Cost](Costs-and-Run-Cost).
+Your four most recently changed templates, each with **Make a video**, which opens Create with that template picked so only the topic is left to type. **See all N** opens Templates.
 
 ## Projects
 
-**Where to find it:** the sidebar → **Projects**.
+**Where to find it:** the rail → **Projects**.
 
-Every run ever started, newest first unless you pick another order, for the channel picked in the sidebar. The heading says how many projects there are and for which channel. **New project** opens Play.
+Every run ever started, newest first unless you pick another order, for the channel picked under **Showing:** (with two or more channels). The heading says how many projects there are. **Create** is in the rail.
 
 ### Search and filter
 
 1. Type in **Search projects** to match titles.
-2. Pick a filter under **Show**:
+2. Pick a filter under **Show**. Each says how many it holds, for example **Ready to upload 3**; a filter with nothing in it is not offered. On a phone the filters are one list, for example **Ready to upload (3)**.
 
 | Filter | Shows |
 | --- | --- |
 | **All** | Everything. |
 | **Running** | Projects running, and those **Waiting for the agent**: the same runs Home's **See all N running** counts. |
-| **Queued** | Projects waiting for their turn in the video queue. |
-| **Needs you** | Projects waiting for you: at a review or held step, paused, or **Stopped**. |
-| **Ready to upload** | Finished videos not marked uploaded. |
-| **Failed** | Failed projects, those **Done with problems**, and runs with a failed step that still wait on something else. |
-
-3. Pick an order beside the filter: **Newest first**, **Recently changed**, **Name (A–Z)** or **Status** (waiting for you first, then running, queued, failed and finished).
+| **Queued** | Projects waiting for their turn in the video queue, in the order they will start, each with **Earlier**, **Later** and **Remove**. |
+| **Needs you** | What Home's **Needs you** lists: projects waiting for you (at a review or held step, paused, or **Stopped**) and the failures to fix. |
+| **Ready to upload** | Finished videos not marked uploaded, including those **Done with problems**. Never a sample. |
+| **Failed** | Failed projects, and runs with a failed step that still wait on something else. |
 
-The search, the filter and the order are part of the address, so Back from a project, a reload or a link opens Projects the same way: `/projects?show=running` (`queued`, `waiting` for Needs you, `ready` or `failed`), `?q=` for the search words and `?sort=changed`, `name` or `status`. The list draws 50 projects at a time; **Show N more** under it adds the next ones. Press `/` to jump to the search box. The command palette has shortcuts: **Show projects that need you**, **Show videos ready to upload** and **Show failed projects**.
+3. Pick an order beside the filter: **Newest first**, **Finished first**, **Recently changed**, **Name (A–Z)** or **Status** (what needs you first, then running, queued and finished).
 
-On a wide screen, **At a glance** beside the list counts the projects under each filter.
+The search, the filter and the order are part of the address, so Back from a project, a reload or a link opens Projects the same way: `/projects?show=running` (`queued`, `waiting` for Needs you, `ready` or `failed`), `?q=` for the search words and `?sort=finished`, `changed`, `name` or `status`. The list draws 50 projects at a time; **Show N more** under it adds the next ones. Press `/` to jump to the search box. The command palette has shortcuts: **Show projects that need you**, **Show videos ready to upload** and **Show failed projects**.
 
-If nothing matches, the list says **No project matches. Clear the search or pick All.** If the picked channel has no projects, pick **All channels** in the sidebar.
+If nothing matches, the list says **No project matches. Clear the search or pick All.** If the channel picked under **Showing:** has no projects yet, the page says so with **Make a video** and **Show all channels**. With **All channels** shown, rows are grouped under each channel's name only when they come from two or more channels.
 
 ### What each row shows
 
 - A checkbox to select it (see [Work on several projects at once](#work-on-several-projects-at-once)).
-- The title, with a **Sample** badge on the bundled samples. A press anywhere on the row opens the project. A long title is cut short; hover it to read all of it.
-- For an audiobook that is a chapter of a book, **Book · Chapter N**.
-- What it was made of and when: the article prompt and format, for example `Documentary dossier · 16:9 · started …`.
+- Its thumbnail.
+- The title, with a **Sample** badge on the bundled samples and an **Outdated** badge when an edit left part of it outdated. A press anywhere on the row opens the project. A long title is cut short; hover it to read all of it.
+- Its state in words, then what it is: once finished, its length, shape, what it made and when it finished, for example `3:05 · 16:9 · video + 2 shorts + PDF · finished Sep 27`; before that, what it was made of and when it started, for example `Documentary dossier · 16:9 · started …`. A run that made its video but lost a step names the step (**PDF failed**) with **See what failed**.
 - A progress bar with **N% done** while it runs.
-- Its state:
 
 | State | Meaning |
 | --- | --- |
 | **Running** | A step is being made. A run waiting for a CLI plan says **Waiting for Codex limits (resets at 14:00)** instead. |
+| **Waiting to try again** | A step failed on something time fixes (a rate limit, a dropped connection) and runs again by itself at the time its step names. Nothing to do. |
 | **Paused** | Paused by you or an agent; nothing runs until it is continued. |
 | **Queued** | Waiting for its turn in the video queue. |
-| **Waiting for your review** | Held at a review or checkpoint. |
-| **Waiting for the agent** | An External agent is reviewing what it made; it goes on by itself. |
-| **Prepared** | Made ahead by its schedule; only the video is left, for its day. |
+| **Waiting for your review** | Held at a pause for your approval. |
+| **Waiting for the agent** | Your own AI agent is checking what it made; it goes on by itself. |
+| **Waiting for its day** | Made ahead by its schedule; only the video is left, for its day. |
 | **Stopped** | Stopped before it finished, for example by a restart. Open it and press **Continue the run**. |
 | **Kept as is** | What is left was set aside with **Keep as is**. |
-| **Done** | Finished. |
-| **Done with problems** | Finished, but part of it failed. |
+| **Ready to upload** | A finished video you have not marked uploaded. |
+| **Uploaded** | A finished video you marked uploaded. |
+| **Done** | Finished: a sample, or a run that made no video. |
+| **Done with problems** | The video was made, but another step failed. |
 | **Failed** | Stopped with an error. |
 | **Canceled** | You canceled it. |
 
-- **Mark uploaded** on a finished video; once marked, an **Uploaded** badge. For a day after marking, **Undo upload mark** puts it back on Ready to upload; after that, select it and press **Mark not uploaded**.
-- The delete button (bin icon).
+Then its actions, in words:
+
+- **Open** opens the project.
+- **Download video** saves the finished video.
+- **Mark uploaded** on a finished video of yours. For a day after marking, **Undo upload mark** puts it back on Ready to upload; after that, select it and press **Mark not uploaded**.
+- **Make my own copy** on a sample: an ordinary project you can edit and make again; the sample stays as it came.
+- **Delete** (not while it runs: cancel the run first). A queued video has **Earlier**, **Later** and **Remove** instead. On a phone the row keeps one line of actions: tick it and press **Delete** in the bar above the list.
 
 ### Work on several projects at once
 
-Tick the checkbox on each row you want, or **Select all** above the list (it covers the rows shown: a search, a filter or Show more changes which). Shift+click ticks every row between two; Esc clears the selection. The bar above the list says how many are selected and offers:
+Tick the checkbox on each row you want, or **Select all** above the list (it covers the rows shown: a search, a filter or Show more changes which). Shift+click ticks every row between two; Esc clears the selection. Once something is ticked, the bar above the list says how many are selected and offers what applies to them; it stays at the top of the window while the list scrolls:
 
 | Button | Does |
 | --- | --- |
-| **Mark uploaded** | Marks the selected finished videos uploaded. The others are left as they are. |
+| **Clear selection** | Unticks everything. |
+| **Mark uploaded** | Shown when a selected project is a finished video; marks the selected finished videos uploaded. |
 | **Mark not uploaded** | Shown when a selected video is marked uploaded; puts it back on Ready to upload. |
-| **Move to channel…** then **Move to <channel>** | Moves the selected projects to another channel (with more than one channel). |
+| **Move to channel…** | Picking a channel moves the selected projects there (with more than one channel). |
+| **Make outdated parts again** | Shown when a selected project is **Outdated**. It checks each one, then shows what each makes again and what it costs before anything starts. |
 | **Delete** | Asks first, then moves the selected projects to the trash. Running projects stay: cancel the run first. |
-| **Clear selection** | Unticks everything. |
 
-Each one says what it did in a notice with **Undo**: Undo after a delete restores the projects from the trash; after a move it sends each project back to its channel. There is no way to re-run several projects at once: each run costs money and is started from its own project page.
+Each one says what it did in a notice with **Undo**: Undo after a delete restores the projects from the trash; after a move it sends each project back to its channel.
 
 ### Delete a project
 
-1. Press the bin icon on its row. While the project is running it is disabled: cancel the run first.
+1. Press **Delete** on its row.
 2. Confirm with **Delete project** (or **Keep it** to back out).
 3. The project goes to the trash for 30 days. The notice that says so has **Undo**; later, restore it or delete it for good in Settings → **Backup & storage** → **Trash**. See [Trash](Trash).
 
 ### The video queue
 
-Videos started together (a batch from Play, for example) run one at a time. The queue itself is on the Calendar, under **Batch queue**, numbered in the order they run (see [Calendar](Calendar#the-batch-queue)); Projects only links to it (**Video queue** → **Open calendar**) and has the **Queued** filter. Pausing a project holds the queue; when one fails or is canceled, the next one starts. The project page has the same list behind a **Queue · N** button in its right rail. See [Templates](Templates) and [Schedules](Schedules) for batches.
+Videos started together (**Queue 3 videos** in Create, for example) run one at a time. Home lists the ones waiting under **Running**, and the **Queued** filter here lists them in the order they start, each with **Earlier**, **Later** and **Remove**; the calendar has the same list under **Waiting to start** (see [Calendar](Calendar#the-batch-queue)). The page of a project in the queue says how many videos wait to start. Pausing a project holds the queue; when one fails or is canceled, the next one starts.
 
 ### When there are no projects
 
-Projects shows **No projects yet** with **Make your first video** (opens Play), and an invitation to the interactive tutorial with **Start tutorial**.
+Projects shows **No projects yet**, "Every video you make is kept here with its files.", **Make your first video** (opens Create), and an invitation to the interactive tutorial with **Start the tour**.
 
 ## Tips
 
-- The sidebar's **N running** link jumps straight to Running now on Home.
+- The rail's **N running** link jumps straight to Running on Home.
 - Home and Projects follow the Channel picker. If a project seems missing, switch to **All channels**.
 - Updates wait for running work. See [Updating and Patch Notes](Updating-and-Patch-Notes).
 
 ## Related pages
 
 - [Project Page](Project-Page)
-- [Play Overview](Play-Overview)
+- [Create Overview](Create-Overview)
 - [Channels](Channels)
 - [Calendar](Calendar)
 - [Schedules](Schedules)
-- [Reviews and Checkpoints](Reviews-and-Checkpoints)
+- [Pauses and Checks](Reviews-and-Checkpoints)
 - [Publishing to YouTube](Publishing-to-YouTube)
 - [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette)