@gentbajko/slopify 3.0.0 → 3.0.1

package/dist/tutorials/Keyboard-Shortcuts-and-Command-Palette.md

@@ -0,0 +1,215 @@
+# Keyboard Shortcuts and Command Palette
+
+The command palette lets you reach every screen, every project and the frequent actions by typing, without hunting for buttons. Keyboard shortcuts cover the most common moves. This page lists both.
+
+**Where to find it:** press `Ctrl+K` (`Cmd+K` on a Mac) anywhere, or choose **Search or run a command** at the top of the sidebar. Press `?` for the list of keyboard shortcuts.
+
+## Use the command palette
+
+1. Press `Ctrl+K`.
+2. Type a few letters of what you want, such as `set` for **Open settings** or `back` for **Back up now**. Letters only need to appear in order, so `nwv` finds **New video**. Commands also match other words, for example `keys` finds **Open settings**. Several words match in any order across the command's name, the project it acts on and its other words: `cleopatra regenerate image 3` finds **Regenerate image 3 in Cleopatra**.
+3. Use `Up` and `Down` to move through the list, `Home` and `End` to jump to the first or last, and `Enter` to run the highlighted command. You can also click a command.
+4. Press `Esc` (or `Ctrl+K` again) to close the palette without running anything.
+
+The palette lists what you can do from where you are. Commands about the screen in front of you (the project you have open, for example) are listed first, with the project or item name beside them. Some commands are only found once you type: every project by name, and New schedule and Add to calendar from other screens (see [From anywhere](#from-anywhere)). If nothing matches, it says so; try fewer letters or another word.
+
+A command that has a shortcut shows its keys beside it.
+
+## Keyboard shortcuts
+
+Press `?` anywhere (outside a text field) to see **Keyboard shortcuts**: every key that works on the screen you are on. `Ctrl` works as `Cmd` on a Mac. Keys without `Ctrl` wait while you type in a field, so typing a `c` into a title never opens Play. Two keys like `G` then `H` are pressed one after the other.
+
+| Keys | Where | What it does |
+|---|---|---|
+| `Ctrl+K` / `Cmd+K` | Anywhere | Opens or closes the command palette. |
+| `?` | Anywhere | Shows the keyboard shortcuts. |
+| `C` | Anywhere | **New video** (opens Play). |
+| `G` then `H` | Anywhere | Go to Home. |
+| `G` then `P` | Anywhere | Go to Projects. |
+| `G` then `C` | Anywhere | Go to the Calendar. |
+| `G` then `S` | Anywhere | Go to Schedules. |
+| `G` then `L` | Anywhere | Go to the Library. |
+| `G` then `K` | Anywhere | Go to Channels. |
+| `G` then `,` | Anywhere | Go to Settings. |
+| `/` | Projects, Library → Prompts, Library → Intros & Outros | Puts the cursor in the list's search box. |
+| `Shift+N` | A project page | Runs the project's next action (Approve, Try again, Prepare upload…). |
+| `Shift+D` | A project page | Copies the YouTube description. |
+| `Ctrl+S` / `Cmd+S` | The Library editors (prompts, intros and outros, document themes) | Saves, even while you are typing in a field. |
+| `Up` / `Down`, `Home` / `End`, `Enter`, `Esc` | Command palette | Move, jump, run, close. |
+| `Ctrl+Enter` / `Cmd+Enter` | Play | Opens **Review the whole setup** without starting a run. |
+| `Space` or `K`, `J` / `L`, `Left` / `Right`, `M`, `F`, `C`, `0`–`9` | Inside a video or audio player | Play and pause, jump 10 seconds, jump 5 seconds, mute, full screen, captions, jump to a tenth of the way. See [Project Page](Project-Page#the-players). |
+| `Enter` / `Shift+Enter` | Search box in a reading view (research, article, narration text, patch notes) | Next match / previous match. |
+| `Left` / `Right` | Image viewer (an enlarged image or thumbnail on a project) | Previous / next image. |
+| `Esc` | Dialogs, side drawers, the image viewer | Closes them. |
+| `Esc` | Adding another title on Play | Cancels adding it. |
+| `Esc` | Guided tour | Closes an open picker first; press again to leave the tour. |
+| `Left` / `Right`, `Home` / `End` | Tabs (for example on a project page) | Move between the tabs. |
+| `Left` / `Right` | Segmented choices (for example **Appearance** in Settings) | Move between the options. |
+
+Everything else is in the palette.
+
+## Palette commands
+
+Commands are grouped under headings in the palette. Group names below are the headings you see.
+
+### Go to (everywhere)
+
+| Command | What it does |
+|---|---|
+| **Open home** | Goes to Home. |
+| **Open projects** | Goes to Projects. |
+| **Open channels** | Goes to Channels. |
+| **Open schedules** | Goes to Schedules. |
+| **Open calendar** | Goes to the Calendar. |
+| **Open library** | Goes to the Library (Prompts). |
+| **Open settings** | Goes to Settings. |
+| **Open usage and costs** | Goes to Settings → Usage. |
+| **Show patch notes** | Goes to Settings → Patch notes. |
+
+### Create and Channel (everywhere)
+
+| Command | What it does |
+|---|---|
+| **New video** (`C`) | Opens Play. |
+| **Show all channels** | Shows every channel's projects, schedules and costs. |
+| **Switch to <channel>** | Shows one channel only. There is one command per channel. |
+
+### From anywhere
+
+These are found once you type, from any screen:
+
+| Command | What it does |
+|---|---|
+| **Open <project>** | Opens any project by name, for example `hypatia` finds **Open Hypatia of Alexandria**. |
+| **Regenerate image N in <project>** | Type the project, the words and the number, for example `cleopatra regenerate image 3`. It opens that project on its Images and asks before redrawing, as the Regenerate button does. |
+| **New schedule** | Opens Schedules with a new schedule started. |
+| **Add to calendar** | Opens the Calendar with the Add to calendar form. |
+| **Show keyboard shortcuts** (`?`) | Lists every shortcut that works here. |
+
+### Open a tutorial page
+
+These tutorial pages are also inside Slopify, under **Help → Tutorials**. Type `tutorial` and a few words of a page's name, then pick **Open tutorial: <page>**, for example **Open tutorial: Install** or **Open tutorial: Shorts**. It opens that page at `/help/tutorials/<Page>`, where a search box finds any page. **Open tutorials** (under Go to) opens the tutorials' home page, and on the tutorials page `/` puts the cursor in that search box.
+
+### Play
+
+On the Play screen.
+
+| Command | What it does |
+|---|---|
+| **Start run** / **Queue N videos** | Starts the run, or queues every video on the page. If something is missing, it takes you to the field that needs it. |
+| **Add a topic for another video** | Adds another title to make a batch. |
+| **Save as template** | Saves the current setup as a template. |
+| **Review the whole setup** (`Ctrl+Enter`) | Opens the full review. |
+| **Pick a template** | Moves to the template picker. |
+| **Change title and keywords**, **Change article**, **Change narration**, **Change images**, **Change video and style**, **Change outputs**, **Change reviews**, **Change channel** | Opens that part of the setup and scrolls to it. |
+
+See [Play-Overview](Play-Overview).
+
+### This project
+
+On a project's page. The project's title shows beside each command.
+
+| Command | What it does |
+|---|---|
+| The next action (for example **Continue the run**, **Try images again**, **Prepare upload**) (`Shift+N`) | Runs what the project page suggests next. Shows **Show the project's next action** when there is none. |
+| **Pause the run** / **Continue the run** | Pauses or resumes the run. |
+| **Cancel the run** | Asks to cancel the run. |
+| **Prepare upload** | Opens the upload pack once the video has been made. |
+| **Edit project settings** | Opens Edit project. |
+| **Choose what to remake** | Opens the review of everything a change affects. |
+| The first outdated group / **Remake outdated outputs** | Remakes the first group of outdated outputs. Says so when nothing is outdated. |
+| **Remake everything outdated** | Remakes all outdated outputs. |
+| **Save as template** | Saves this project's setup as a template. |
+| **Make my own copy** | On a sample project, makes an editable copy. |
+| **Open the project folder** | Opens the project's folder on this computer. |
+| **Regenerate image N** / **Regenerate on-screen card N** | Redraws that image, including images behind **Show all**. Type the number, for example `regenerate image 12`. It asks first, as the Regenerate button does. |
+| **Regenerate the thumbnail** / **Regenerate thumbnail N** | Redraws a thumbnail. |
+| **Copy description** (`Shift+D`) | Copies the YouTube description, placeholders filled. |
+| **Copy tags** | Copies the YouTube tags. |
+
+See [Project-Page](Project-Page) and [Video-Editing](Video-Editing).
+
+### Needs you and Ready to upload
+
+On Home.
+
+| Command | What it does |
+|---|---|
+| **Approve the article and record**, **Approve and draw the images**, **Approve and render** | Approves a run held at a review. One per held project; **Open the held run** when there is nothing to approve here. |
+| **Mark uploaded** | Takes a finished video off the Ready to upload list. One per video. |
+
+See [Home-and-Projects](Home-and-Projects) and [Reviews-and-Checkpoints](Reviews-and-Checkpoints).
+
+### Projects
+
+On the Projects list.
+
+| Command | What it does |
+|---|---|
+| **Show projects that need you** | Filters to projects waiting for you. |
+| **Show videos ready to upload** | Filters to finished videos. |
+| **Show failed projects** | Filters to failed projects. |
+| **Search projects** (`/`) | Puts the cursor in the search box. |
+
+### Library
+
+On any Library tab.
+
+| Command | What it does |
+|---|---|
+| **New prompt** | Starts a new prompt (of the kind the tab shows). |
+| **New intro or outro** | Starts a new intro or outro. |
+| **New document theme** | Starts a new document theme. |
+| **Open prompts**, **Open intros and outros**, **Open templates**, **Open document themes** | Switches tab. |
+| **Save a setup as a template** | On the Templates tab: saves a Play setup as a template. |
+
+See [Library-Overview](Library-Overview).
+
+### Channels
+
+| Command | Where | What it does |
+|---|---|---|
+| **New channel** | Channels | Starts a new channel. |
+| **Add to cast** | A channel's page | Adds a character, creature, place or object to its cast. |
+
+See [Channels](Channels) and [Cast-Library](Cast-Library).
+
+### Schedules and Calendar
+
+| Command | Where | What it does |
+|---|---|---|
+| **New schedule** | Schedules (from anywhere once you type it) | Starts a new schedule. |
+| **Pause schedule** / **Resume schedule** | Schedules, with one open | Pauses or resumes it. |
+| **Add to calendar** | Calendar (from anywhere once you type it) | Adds topics to the calendar. |
+| **Show the calendar as weeks** / **Show the calendar as a list** | Calendar | Switches the view. |
+| **Queue all suggested topics** | Calendar | Accepts every topic a schedule suggested. One per schedule with suggestions. |
+
+See [Schedules](Schedules) and [Calendar](Calendar).
+
+### Settings
+
+In Settings.
+
+| Command | What it does |
+|---|---|
+| **Check all providers** | Opens Providers and runs Check all. |
+| **Back up now** | Opens Backups and starts a backup. |
+| **Download diagnostics** | Saves `slopify-diagnostics.json`. |
+| **Export everything** | In Backup & storage: downloads the full export. |
+| **Check for new models** | In Models: checks the catalogue now. |
+
+See [Settings-Reference](Settings-Reference).
+
+## Tips
+
+- The fastest way around: `Ctrl+K`, a few letters, `Enter`. For example `Ctrl+K`, `usage`, `Enter` opens your usage. For the main screens, `G` and a letter is faster still.
+- On a project, `Ctrl+K` lists that project's commands first, so the next action is a few letters away (try `next` or `continue`).
+- On Play, `Ctrl+Enter` is a safe way to check everything: it opens the review and never starts a run.
+
+## Related pages
+
+- [Play-Overview](Play-Overview)
+- [Project-Page](Project-Page)
+- [Home-and-Projects](Home-and-Projects)
+- [Settings-Reference](Settings-Reference)
+- [FAQ](FAQ)

package/dist/tutorials/Library-Overview.md

@@ -0,0 +1,75 @@
+# Library Overview
+
+The Library holds the reusable pieces your videos are made from: prompts, intros and outros, templates, PDF document themes and narration aliases. Write a piece once and pick it on Play for every video that needs it.
+
+**Where to find it:** **Library** in the sidebar. It opens on **Prompts**; the tabs across the top switch sections.
+
+## The five tabs
+
+| Tab | What it holds | Page |
+|---|---|---|
+| **Prompts** | The instructions for articles, images, thumbnails, narration cues, YouTube descriptions, shorts, reviews and multi-voice scripts, each with `{{keywords}}` where the subject goes | [Prompts](Prompts) |
+| **Intros & Outros** | Short narrated openings and closings, written as text or generated by the text model | [Intros and outros](Intros-and-Outros) |
+| **Templates** | Saved Play setups, and **Add pack** for the starter packs | [Templates](Templates) |
+| **Documents** | Document themes: the look of the PDF made from the article | [Document themes](Document-Themes) |
+| **Aliases** | Words the narrator says differently from how they are written, such as Dr. as Doctor | [Aliases and glossary](Narration-Aliases-and-Glossary) |
+
+## What every Library list has
+
+Prompts, Intros & Outros and Templates share the same row actions, in the same order:
+
+| Action | What it does |
+|---|---|
+| **Edit** | Opens the item in its editor. (A template has no editor: Edit picks it and shows its keywords beside the list.) |
+| **Duplicate** | Opens the editor with a copy, for you to rename and save. (A template is copied as `<name> copy` at once.) |
+| **Use in Play** | Picks the item in your open Play draft and opens Play on the field that shows it. An article prompt switches the article to Generate, an image prompt is ticked with one image, a thumbnail prompt switches the thumbnail to From prompt, and a Description or Shorts prompt turns that step on. The rest of the draft stays as it was. The button is off while Play is starting a run. |
+| **History** | Opens the item's versions, a side-by-side compare, and what uses it. See [Prompts](Prompts#history-and-versions). |
+| **Delete** | Asks first, then moves the item to **Settings → Trash** for 30 days. See [Trash](Trash). |
+
+Your document themes have Edit, Duplicate and Delete, but no Use in Play or History. Built-in themes can only be copied.
+
+A press anywhere on a row picks it; the row's own buttons still do their own thing. Beside each list, the selected item shows its text, its **Keywords**, what it is **Used by**, and its latest change.
+
+### Rename in the row
+
+In Prompts, Intros & Outros and Templates, the pencil beside a name (**Rename <name>**) turns the name into a field. Type the new name and press **Save name** or Enter; `Esc` or **Cancel** keeps the old one. Only the name changes, and the notice ("Renamed “A” to “B”.") has **Undo**. A prompt's or entry's rename is one History version; a template's is a new template version.
+
+### Save with Ctrl+S
+
+In the prompt, intro and outro and document theme editors, `Ctrl+S` (`Cmd+S`) saves, even while you are typing in a field.
+
+## Search and filter
+
+- **Prompts** has a **Prompt kind** picker (Article, Image, Thumbnail, Narration Preparation, YouTube Description, Shorts, Review, Script (speakers)) and **Search prompts**.
+- **Intros & Outros** has **Search intros and outros**.
+- **Templates** has **Show templates of** to filter by channel.
+- Press `/` on Prompts or Intros & Outros to jump to the search box.
+
+## Command palette shortcuts
+
+Press `Ctrl+K` anywhere and type to find **New prompt**, **New intro or outro**, **New document theme**, **Open prompts**, **Open intros and outros**, **Open templates** or **Open document themes**. See [Keyboard and Ctrl+K](Keyboard-Shortcuts-and-Command-Palette).
+
+## Starter packs
+
+**Library → Templates → Add pack** adds a ready-made set for one kind of channel: prompts, a suggested voice and a Play template. There are four packs: Sleep lore, True crime, History and Science explainers. Adding one twice changes nothing, and a pack never replaces a prompt or template of yours with the same name. See [Templates](Templates#starter-packs).
+
+## Fonts
+
+The Library has no separate font manager. Fonts live where they are used:
+
+- **Caption (subtitle) fonts:** upload your own in the subtitle font picker on Play's video style settings. Uploaded fonts then appear in a channel's brand kit too. See [Video and style](Play-Video-and-Style) and [Channels](Channels).
+- **PDF fonts:** each document theme picks its fonts from the bundled Cinzel and the fonts built into every PDF reader (Times, Helvetica, Courier). See [Document themes](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 the Library 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 project** shows the project's own copy of each prompt: pick the Library prompt again (or press **Use the Library version**) to bring in your latest edit, and press **Update from Library** under narration aliases to copy the current alias list. See [Editing a project](Editing-a-Project).
+
+## Related pages
+
+- [Prompts](Prompts)
+- [Intros and outros](Intros-and-Outros)
+- [Templates](Templates)
+- [Document themes](Document-Themes)
+- [Aliases and glossary](Narration-Aliases-and-Glossary)

package/dist/tutorials/Models.md

@@ -0,0 +1,133 @@
+# Models
+
+Slopify keeps a model catalogue: the list of models, prices and retirements that the model pickers and cost estimates use. It checks for new models and price changes by itself, and tells you when something you use has been retired so you can switch it in one click.
+
+**Where to find it:** Settings → Models.
+
+## What the catalogue covers
+
+The catalogue lists the models of the providers that take an API key:
+
+| Kind | Providers |
+|---|---|
+| Text | OpenRouter |
+| Speech | ElevenLabs, OpenAI, Cartesia, Inworld |
+| Images | OpenAI, Google, fal.ai, Replicate |
+| Animated clips (image to video) | fal.ai, Replicate |
+
+For each model it holds a name, a price (per token, per character, per image or per second) and whether the model is retired. A model with no price is counted as unknown, never as free.
+
+The command-line tools (Claude Code, Codex, Gemini) are not in the catalogue. Their pickers show the models the tool installed on your computer offers, and **Check all** in Settings → Providers checks them. See [AI CLIs](AI-CLIs).
+
+The catalogue also sets how many calls each keyed provider runs at once (3 for most, 5 for Inworld).
+
+## How it stays current
+
+When Slopify starts, and then once a day, it checks two sources:
+
+- the published catalogue file in the Slopify repository, and
+- OpenRouter's public model list (live model IDs and per-token prices; no key needed).
+
+It folds what it finds into your local catalogue file:
+
+- New models appear in the pickers.
+- Prices follow the published list, and OpenRouter models follow OpenRouter's live prices.
+- A model the published list drops or marks retired, or that OpenRouter no longer serves, stays in the file marked retired and is hidden from the pickers.
+- Models you added to the file yourself, and models you switched off, are left alone.
+- A speech model keeps its local character limit, so existing projects are not split differently.
+
+Nothing you have made changes. A finished run's costs keep the prices they were recorded at.
+
+To turn the automatic check off, start Slopify with the environment variable `SLOPIFY_NO_MODEL_REFRESH=1`.
+
+## Check for new models now
+
+1. Open **Settings → Models**.
+2. Under **Model catalogue**, choose **Check now** (or press `Ctrl+K` and run **Check for new models**).
+3. A message says what changed, such as "Model list checked: 2 new, 1 repriced", or "No changes".
+
+The section shows:
+
+| Row | What it shows |
+|---|---|
+| **Catalogue file** | The path of your local catalogue file (`models.yaml` in Slopify's data folder). |
+| **Verified** | The date the catalogue's prices were last verified. |
+| **Last checked** | When the last automatic or manual check ran, and what it changed. |
+
+Below them, **New:** and **Retired:** list the models the last check added or retired.
+
+If the check cannot finish, a red line says why. For example: "Slopify could not download the latest model list, so it is still using the one it has." Check your internet connection and choose **Check now** again.
+
+## Replace the local file with the published one
+
+Use this when the local file is broken, or you want the published list exactly.
+
+1. Open **Settings → Models**.
+2. Choose **Replace with published file**.
+
+This overwrites the local catalogue with the published one and drops any edits you made. The previous file is saved beside it first as `models.yaml.previous`, so you can copy your edits back.
+
+## Edit the catalogue yourself
+
+The catalogue is a plain YAML file at the path shown under **Catalogue file**. You can add a model or switch one off in it; Slopify reloads it when it changes, and the daily check keeps your additions.
+
+If the file is missing or has a mistake, Slopify keeps using the last working list and shows: "Your models.yaml file is missing or has a mistake, so Slopify is still using the last working model list." Fix the file, or use **Replace with published file**. The automatic check never overwrites a file that has a mistake in it.
+
+## Switch away from a retired model
+
+**Retired models in use** lists every template, schedule, Play draft and project (with steps still to run) whose model is retired or no longer listed. Nothing changes by itself: a run that reaches a retired model stops and says so.
+
+Each row shows:
+
+- the kind (**Template**, **Schedule**, **Draft** or **Project**) and its name,
+- which choice it is (**Text model**, **Voice model**, **Image model** or **Animation model**), the model, and whether it is "retired" or "no longer listed",
+- a button **Switch to <model>** with the suggested replacement: the active model from the same provider whose ID shares the longest start with the old one.
+
+To switch:
+
+1. Open **Settings → Models**.
+2. Under **Retired models in use**, choose **Switch to <model>** on a row to change only that one choice.
+3. Or choose **Switch all** to switch every row that has a suggestion. A message says how many were switched and why any could not be.
+
+What a switch does:
+
+- A template gets a new saved version, and the schedules that ran its latest version move along with it.
+- A project gets a new saved version, as **Edit project** would make.
+- A draft is updated in place.
+
+Rows that cannot be switched here say why and what to do:
+
+| Row says | What to do |
+|---|---|
+| **No replacement** ("This provider has no other model to switch to.") | Choose another provider for this step and save. |
+| "This schedule runs an older version of the template …" | In the schedule, choose **Edit**, pick the template again so it runs the latest version, then save. |
+| "This project is running." | Wait for it to finish or pause it, then switch. |
+
+When nothing is affected, the section says **Nothing uses a retired model.**
+
+You don't have to come here to see it: a template or schedule that picks a retired model is flagged on its own row in **Library → Templates** and **Calendar → Schedules**, with the same **Switch to <model>** button. See [Templates](Templates#retired-models) and [Schedules](Schedules#manage-a-schedule).
+
+**Check all** in Settings → Providers also reports retired models under **Chosen models**, and **Model reachable** asks each keyed provider whether it still answers for the models you chose. See [Providers-and-Keys](Providers-and-Keys#check-all-providers).
+
+## When a run reaches a model that is gone
+
+If a run starts a step whose model is no longer in the list, it stops with a message such as "The chosen … model is no longer in Slopify's model list." Open the project, choose **Edit project**, change the model under Providers, then use **Continue the run**. See [Recovery-and-Retries](Recovery-and-Retries).
+
+## Pick models on Play
+
+On Play, each provider row has a model picker fed by the catalogue (or by the CLI for command-line tools):
+
+- The refresh button (**Refresh models**) asks the provider for its current list.
+- **Custom ID** lets you type a model ID the list does not show; **Use list** goes back.
+- **Thinking** (text) or **Effort** (images) appears only when the model offers levels. **Model default** leaves it to the provider.
+
+See [Play-Overview](Play-Overview) and the Play pages for each step.
+
+## Related pages
+
+- [Providers-and-Keys](Providers-and-Keys)
+- [AI-CLIs](AI-CLIs)
+- [Costs-and-Run-Cost](Costs-and-Run-Cost)
+- [Templates](Templates)
+- [Schedules](Schedules)
+- [Settings-Reference](Settings-Reference)

package/dist/tutorials/Multiple-Voices.md

@@ -0,0 +1,161 @@
+# Multiple Voices
+
+A run can be narrated by several speakers instead of one voice reading the article. You pick a format (Audiobook, Podcast, Radio drama or Interview), give each speaker a voice, and Slopify has the text model write or split the script into speaker turns. You get a video whose captions know who is talking and, if you want them, an MP3 and an M4B audiobook file with chapters.
+
+**Where to find it:** Play → **Narration** row → **Speakers** (the disclosure under the voice picker). On a finished project: Edit project → **Providers** → Speakers.
+
+## Formats
+
+The **Format** list under Speakers decides how many voices the run uses and how the video looks.
+
+| Format | Speakers it starts with | Rules | Video |
+|---|---|---|---|
+| **Narration (one voice)** | none: the Narration row's voice reads everything | the default | Image flow |
+| **Audiobook** | Narrator | needs one speaker with the Narrator role | Image flow; captions tagged with the speaker |
+| **Podcast** | Alex and Sam, both hosts | needs at least two speakers | Image flow with a speaker panel |
+| **Radio drama** | Narrator and Mara (a character) | needs one speaker with the Narrator role | Image flow; captions tagged with the speaker |
+| **Interview** | Host and Guest | needs at least two speakers | Image flow with a speaker panel |
+
+You can rename, recast or remove the starter speakers. A run can have up to 10 speakers.
+
+When the channel has hosts (cast members marked **One of the channel's hosts** that have a voice), a new **Podcast** or **Interview** starts with them as its speakers instead of Alex and Sam, or Host and Guest. See [Cast library](Cast-Library#make-a-member-one-of-the-channels-hosts).
+
+The **speaker panel** (Podcast and Interview) is a row of tiles, one per speaker, with the one talking lit in their colour and their name as a lower third. It is drawn together with burned-in captions, so set **Captions** to **Burn in** under Play → **Video and style** to see it. A speaker added from a channel's cast whose member has a reference picture shows that picture in their tile (the member's first picture, cropped square, taken when the run starts); everyone else shows their initials. Adding a picture to the cast later does not change projects already made.
+
+## Set up a multi-voice run
+
+1. On Play, open the **Narration** row and pick the **TTS** provider, model and **Voice** as usual. This voice reads the intro and outro; the speakers read the article.
+2. Open **Speakers** and choose a **Format**.
+3. Choose where the **Script** comes from (see [The script](#the-script)).
+4. For each speaker, set a **Speaker name**, **Role**, **Voice provider**, **Voice model** and **Voice**. Add more with **Add speaker**, or pick someone from **Add from the cast**.
+5. Optionally set **Pace** and **Pronunciations** per speaker, and press **Audition** to hear a speaker before the run.
+6. Set **Gap between turns** and the switches below it.
+7. For a podcast or interview, set Captions to **Burn in** so the speaker panel shows.
+8. Review the estimate in the right rail and start the run.
+
+If something is missing, Play names it before you can start, for example "A podcast needs at least two speakers" or "An audiobook needs a narrator. Set one speaker's role to Narrator under Speakers".
+
+## The script
+
+| Script option | What it does | Cost |
+|---|---|---|
+| **Write a script (Script prompt)** | The text model writes speaker turns from a **Script** prompt in your Library, one `Name: words` paragraph per turn. The article prompt picker on the Article row becomes a **Script prompt** picker. | One text-model call, in place of the article call |
+| **Split the article into speakers** | Keeps the article as written or pasted, then the text model hands its narration and dialogue to the speakers. Audiobook only. | One extra text-model call |
+
+Other formats must use **Write a script**. When the article is split, the split must keep the article's words; if the model changes them, the call is asked again.
+
+### Script format
+
+Write Script prompts in **Library → Prompts** with the kind **Script**. The text model answers in this shape:
+
+```
+# Section title
+
+Alex: What one speaker says, as one paragraph.
+
+Sam: The next turn.
+```
+
+- A `#` heading starts a section. Sections become the chapters of the MP3 and M4B files.
+- A turn starts with a speaker's name and a colon. A line directly under a turn continues it.
+- Text in `[square brackets]`, such as `[laughs]`, is a stage direction and is never read aloud.
+- A script that names someone who is not one of your speakers, or has a paragraph that is not a turn, stops the Article stage with the line to fix.
+
+On the project page the Article section shows the script as the speakers read it: each turn under its speaker's name in their colour, with the sections as headings. If the script can't be narrated, it says why and points you to Edit project → Article.
+
+## Speaker options
+
+| Option | What it does | Default / range |
+|---|---|---|
+| **Speaker name** | The name the script uses for this speaker's turns (`Name: words`), shown on captions and in the speaker panel. Letters, numbers, spaces, dots, apostrophes and hyphens; each speaker needs a different name. | Up to 40 characters |
+| **Role** | Narrator, Host, Guest or Character. The text model is told each speaker's role when it writes or splits the script. | Set by the format |
+| **Voice provider** | The text-to-speech service for this speaker, charged per character of their lines. Speakers may use different providers. Changing it clears the model and voice. | None |
+| **Voice model** | The provider's speech model. Pronunciations need an Inworld TTS-2 model. | None |
+| **Voice** | One of the voices you added under **Settings → Voices** for that provider, filtered to the project's language. Tick **Show all voices** to see the rest. | None |
+| **Pace** | How fast this speaker talks relative to the voice's own speed. It is applied after the speech is made, so changing it costs nothing. | Normal; 0.8×, 0.9×, Normal, 1.1×, 1.2× |
+| **Pronunciations** | One `Term: /IPA/` per line (for example `Arda: /ˈɑɹdə/`), for this speaker only. Used on Inworld TTS-2 voices, ahead of the article's Pronunciation Glossary. | Empty |
+| **Audition** | Speaks this speaker's first line of the script (or a sample line) in their voice. | One real text-to-speech request; the button shows the price, such as "Audition · about $0.0004" |
+
+A pronunciation line the voice can't use (no slashes, ARPAbet, or sounds the project's language does not have) is skipped and that word is read as ordinary text; the other lines still apply. The Speakers panel says which lines are skipped and why as you type.
+
+## Run-wide options
+
+| Option | What it does | Default / range |
+|---|---|---|
+| **Gap between turns** | The pause between one speaker's turn and the next. Longer feels calmer; shorter feels like a lively talk. | 0.35 s; choose 0, 0.2, 0.35, 0.5, 0.8 or 1.2 s |
+| **Speaker names on captions** | Puts the speaker's name before their captions, like `Ada:` and their words. In the VTT file it is written as `<v Name>`. | On for Podcast and Interview, off otherwise |
+| **One request for consecutive turns where the voice provider can (ElevenLabs v3, Gemini)** | Sends back-to-back turns as one multi-speaker request where the provider has one, so the voices react to each other: ElevenLabs v3 with up to 10 voices, Google Gemini with 2 (a third voice starts a new request). Fewer requests, same characters charged. Other providers read each turn on its own. | On |
+| **Also make MP3 and M4B files with chapter markers** | Saves the whole narration as `narration.mp3` (ID3 chapters) and `audiobook.m4b` (AAC with chapter markers), one chapter per script section. Made on your computer at no provider cost. | On |
+
+The MP3 and M4B appear with the Video section's downloads on the project page, and play in Slopify's own audio player with the chapter marks on its track. Slopify does not publish them anywhere.
+
+## Audiobooks in chapters
+
+An audiobook can be one chapter of a book, so a long book is made one chapter per project and a player keeps the chapters together.
+
+1. On Play, pick the **Audiobook** format under Speakers.
+2. Turn on **A chapter of a book**.
+3. Type the **Book title** (the same for every chapter) and the **Chapter** number (from 1).
+4. Start the run.
+
+The MP3 and M4B carry the book as their album and the chapter as their track. Projects shows the project as **Book · Chapter N**, for example "The Wind in the Willows · Chapter 3".
+
+### Make the next chapter
+
+On a finished audiobook's project page, **Make the next chapter** (beside **Edit settings**) opens a new Play draft for the next chapter: the same speakers and voices, channel and cast, prompts and settings, with the chapter number one higher. Write or paste the new chapter's text there, then start it. An audiobook that was not a book yet becomes one, named after itself, starting at chapter 2.
+
+## Speakers from a channel's cast
+
+A channel's cast member can have a voice, so a host or recurring character sounds the same in every episode.
+
+1. Open **Channels**, pick the channel, open its **Cast** tab and edit a member.
+2. Under **Cast voice**, pick a **Voice provider**, **Voice model** and **Voice**. The list shows voices that speak the channel's language. Leave the provider empty for no voice.
+3. On Play, under Speakers, pick the member from **Add from the cast**. Only members with a voice are listed.
+
+The speaker takes the member's name and voice. Every run started later, whether from Play, a batch, a schedule or a template, takes that member's voice, pace and pronunciations as they are when the run starts. Projects already made keep the voice they were made with. See [Cast-Library](Cast-Library) for editing the cast.
+
+## Delivery tags
+
+With a **Narration Preparation** prompt picked (Narration row → **Audio Advanced**), each turn of a speaker on Inworld's TTS-2 model is prepared on its own before it is spoken. The text model sees the turn and who says it (for example `Rat (character)`) and adds cues:
+
+- A spoken direction at the start of a sentence, such as `[say shyly and a little uncertainly]`, held until the next one or `[reset]`.
+- Non-verbal sounds where they happen: `[laugh]`, `[breathe]`, `[sigh]`, `[cough]`, `[clear throat]` and `[yawn]`.
+
+Each turn is its own request, so a direction never leaks into the next speaker, and every speaker on TTS-2 gets cues of their own. Turns of speakers on other voices, or on TTS-2 Flash (which ignores directions), are spoken as written. At least one speaker must be on TTS-2, or Play asks you to choose that model for a speaker or clear Narration Preparation under Narration → **Audio Advanced**. The Narration row's own model (which reads the intro and outro) must be Inworld TTS-2 too. The tags are only in what the voice is sent: captions, word timing, the MP3/M4B chapters and the script download never show them. See [Play-Narration](Play-Narration) for Narration Preparation itself.
+
+## How the audio is made
+
+- Every turn is its own request in its speaker's voice, then the turns are joined with the gap between turns.
+- Narration aliases (Library → Aliases) apply to every turn.
+- Changing one speaker's voice remakes only that speaker's turns.
+- With **Level the volume** on (the default for new runs), each turn is brought to one common loudness before joining, so a quiet host and a loud guest sit at the same level. The MP3 and M4B are mastered to the audio files volume (−18 LUFS by default).
+- **Pause between sentences** lengthens the quiet between sentences inside a turn; the gap between turns stays the Gap between turns.
+
+## Captions with several speakers
+
+- Captions never mix two speakers in one line, and each speaker's captions carry their colour.
+- Captions you edit by hand in Edit project → **Captions** keep their speaker. A caption you add takes the speaker of the narration under it.
+- [Shorts](Shorts) cut from a multi-voice video start and end on a speaker's turn.
+
+## Change speakers on a finished project
+
+1. Open the project and press **Edit project**.
+2. Open **Providers** and change the Speakers panel.
+3. Save. The rebuild review lists what will be remade: only the turns of speakers whose voice changed are spoken again, paid per character.
+
+## Tips
+
+- Audition each speaker before a long run; a wrong voice is cheaper to catch at one line.
+- If a podcast shows no speaker panel, check that Captions is set to Burn in.
+- Give speakers clearly different voices and names; the script and captions match speakers by name.
+
+## Related pages
+
+- [Play-Narration](Play-Narration)
+- [Cast-Library](Cast-Library)
+- [Channels](Channels)
+- [Prompts](Prompts)
+- [Narration-Aliases-and-Glossary](Narration-Aliases-and-Glossary)
+- [Other-Languages](Other-Languages)
+- [Editing-a-Project](Editing-a-Project)
+- [Costs-and-Run-Cost](Costs-and-Run-Cost)