@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/tutorials/Cast-Library.md

@@ -1,15 +1,15 @@
-# Cast Library
+# Cast
 
 A channel's cast is its recurring characters, creatures, places and objects. Each member has a name, a description and up to four reference pictures. Whenever a video's title or an image's brief names a member, its pictures go with that image request, so the member looks the same in every image and every episode. A cast member can also have a voice for multi-voice videos.
 
-**Where to find it:** **Channels** → a channel → **Cast** tab. **Add to cast** opens the editor beside the list.
+**Where to find it:** **Channels** → a channel → **Cast** tab. **Add to cast** opens the editor beside the list. An empty cast opens on the form for its first member, across the page.
 
 ## Add a cast member
 
 1. Open **Channels**, pick the channel, and open the **Cast** tab.
 2. Press **Add to cast**.
-3. Fill in the fields (see the table below). At least give it a **Name**: "Name it first, then give it reference pictures."
-4. Press **Add to cast**. The member is saved and the picture section opens.
+3. Fill in the fields (see the table below). At least give it a **Name**: "Name it first, then give it a picture or two." **Add alias** appears once you type another name.
+4. Press **Add to cast**. The member is saved and the picture section opens. Pressed with no name, it says "Give it a name first."
 5. Add one to four reference pictures: upload them or generate them (below).
 
 To change a member later, press **Edit** on it, change what you need and press **Save**. To remove one, press its delete button and confirm with **Delete from cast**.
@@ -48,35 +48,35 @@ Which images get which members:
 1. Open the member in the editor.
 2. Under **Reference pictures**, press **Upload a picture** and choose a PNG or JPEG up to 10 MB.
 
-### Generate a picture
+### Make a picture
 
-1. Under **Make a picture**, pick an **Image provider** and **Image model**.
+1. Under **Make a picture**, pick the **Service** and **Model** under **Drawn by**.
 2. Check **Picture to make**. It starts from the name, the description and a request for a plain background. Edit it as you like (up to 4,000 characters).
-3. Press **Generate a picture**. Wait until "Making the picture…" finishes.
+3. Press **Make the picture · 1 image call**. Wait until "Making the picture…" finishes.
 
-Each press is one image call on that provider, billed at its price for one image. A plain background with the whole figure in view makes the best reference.
+Each press is one image call to that service, billed at its price for one image. A plain background with the whole figure in view makes the best reference.
 
 To remove a picture, press its delete button. A member with no picture is not sent with any image.
 
-## Which image providers use the pictures
+## Which image services use the pictures
 
-| Provider | What happens |
+| Service | What happens |
 |---|---|
 | Codex, OpenAI, Google, and fal.ai edit models (FLUX.2 and Nano Banana 2 edit) | The member's pictures are sent as input pictures. |
 | Models that take no input pictures (Replicate, other fal.ai models) | The member is described in words instead, from its description. |
 
-See [Images](Play-Images) and [Providers and keys](Providers-and-Keys).
+See [Create: Images](Create-Images) and [Keys and Services](Providers-and-Keys).
 
 ## Give a cast member a voice
 
 In multi-voice formats (audiobook, podcast, radio drama, interview) a cast member can speak with the same voice in every episode.
 
-1. In the member's editor, under **Cast voice**, pick a **Voice provider**, **Voice model** and **Voice**. The list shows voices that speak the channel's language. If it says "No voices. Add one in Settings.", add a voice in **Settings → Voices** first.
+1. In the member's editor, under **Voice**, pick the **Service**, **Model** and **Voice** under **Read by**. The list shows voices that speak the channel's language. If it says "No voices for *service* yet", press **Add a voice for *service* ↗** under it and add one in **Settings → Voices** first.
 2. Pick a **Pace**: 0.8, 0.9, 1 (normal), 1.1 or 1.2.
 3. Press **Save**.
-4. On Play, pick the member under **Speakers**. They read with this voice, model and pace.
+4. On Create, pick the member under **Speakers**. They read with this voice, model and pace.
 
-Leave the provider empty for no voice. A run keeps the voice it started with. See [Multiple voices](Multiple-Voices).
+Leave the service empty for no voice. A run keeps the voice it started with. See [Multiple voices](Multiple-Voices).
 
 ### Make a member one of the channel's hosts
 
@@ -86,13 +86,13 @@ A channel's regular presenters can join every new podcast or interview on their
 2. Turn on **One of the channel's hosts**. Without a voice it warns: "A host joins new podcasts and interviews only with a voice. Pick one under Voice above."
 3. Press **Save**. The cast list shows **Host** beside the member.
 
-When you pick **Podcast** or **Interview** on Play for a draft of this channel with no speakers yet, the speakers start with the channel's hosts that have a voice. You can still add or remove speakers on the draft. Projects already made are not changed.
+When you pick **Podcast** or **Interview** on Create for a draft of this channel with no speakers yet, the speakers start with the channel's hosts that have a voice. You can still add or remove speakers on the draft. Projects already made are not changed.
 
 A picture that fails to generate because a CLI is signed out shows the same **Copy sign-in command** and **Check again** buttons as a project. See [Recovery and Retries](Recovery-and-Retries#sign-a-cli-in-again).
 
 ## What happens to finished videos
 
-A run keeps the cast as it was when it started. Editing the cast later never makes a finished video outdated. Only images that actually mention a member change their fingerprint, so only they would be remade if you remake the project's images.
+A run keeps the cast as it was when it started. Editing the cast later never makes a finished video outdated. Only images that actually mention a member change their fingerprint, so only they would be made again if you make the project's images again.
 
 ## Backups
 
@@ -101,12 +101,12 @@ Cast members and their pictures travel in a backup made with **Export everything
 ## Tips
 
 - Upload or generate a picture with the whole figure on a plain background. Busy backgrounds leak into every image.
-- Keep the description short and visual: colours, shape, clothing, one distinctive feature.
+- Keep the description short and visual: colors, shape, clothing, one distinctive feature.
 - Add the plural and possessive-free forms as aliases ("pharaohs", "the Queen"). Matching is whole-word only.
 
 ## Related pages
 
 - [Channels](Channels)
-- [Images](Play-Images)
+- [Create: Images](Create-Images)
 - [Multiple voices](Multiple-Voices)
-- [Providers and keys](Providers-and-Keys)
+- [Keys and Services](Providers-and-Keys)

package/dist/tutorials/Channels.md

@@ -2,7 +2,7 @@
 
 A channel is one series: its brand kit, series brief, cast, templates and schedules. Every template belongs to one channel, and every run from it uses that channel's look, cast and language. Use channels when you make more than one kind of video, so each series keeps its own look and its own topic ideas.
 
-**Where to find it:** **Channels** in the sidebar. On Play, the **Channel** picker sits under the title. The channel picker in the sidebar filters what Home, Projects and the Calendar show.
+**Where to find it:** **Channels** in the rail, once you have two or more channels; with one, Ctrl+K → **Open Channels**. On Create, the **Channel** picker sits under the title. With two or more channels, **Showing:** in the page header of Home, Projects and the Calendar filters what they show.
 
 ## The default channel
 
@@ -17,27 +17,27 @@ The list shows each channel with **Open**, **Rename** and **Delete** (not on the
 1. Open **Channels** and press **New channel**.
 2. Type a **Channel name** (up to 200 characters). It stays inside Slopify and doesn't have to match your YouTube channel.
 3. Press **Create channel**.
-4. Open the new channel and fill in its **Brand** tab (below).
+4. Open the new channel and fill in its **Name and look** tab (below).
 
 To rename a channel, press **Rename** on it, change the name and press **Rename channel**. To delete one, press **Delete channel**: its cast goes with it, and its videos move to the default channel and keep what they were made with. A channel that still has templates can't be deleted; move them to another channel first (see [Templates](Templates#move-a-template-to-another-channel)).
 
 ## Which channel a video is in
 
-- On Play, pick the **Channel** under the title. A draft opened from a template starts in that template's channel; a new draft starts in the default one.
-- A template saved from Play lands in the draft's channel, or the one you pick in **Save a setup**.
+- On Create, pick the channel with **For** beside **Start from** (shown with two or more channels). A draft opened from a template starts in that template's channel; a new draft starts in the default one.
+- A template saved from Create lands in the draft's channel.
 - A schedule belongs to the channel of the template it runs, so moving the template moves its schedules.
 
 ## Show one channel's work
 
-The channel picker in the sidebar (**Current channel**) makes Home, Projects and the Calendar show only that channel's work. **All channels** shows everything. It only filters what you see; projects and schedules of other channels keep running. This browser remembers your choice.
+**Showing:** in the page header of Home, Projects and the Calendar makes them show only that channel's work. **All channels** shows everything. It only filters what you see; projects and schedules of other channels keep running. This browser remembers your choice.
 
 ## The channel's tabs
 
-A channel page has six tabs: **Brand**, **Cast**, **Templates**, **Schedules**, **Episodes** and **Existing videos**.
+A channel page has seven tabs: **Name and look**, **Cast**, **Projects**, **Templates**, **Schedules**, **Memory** and **Titles to avoid**.
 
-### Brand
+### Name and look
 
-**YouTube AI disclosure.** Studio's **AI use** answer for this channel's videos and Shorts, given by Prepare upload and the Studio extension. It saves as soon as you pick.
+**YouTube AI disclosure.** Studio's **AI use** answer for this channel's videos and Shorts, given by Copy for YouTube Studio and the Studio extension. It saves as soon as you pick.
 
 | Option | What it does |
 |---|---|
@@ -45,69 +45,76 @@ A channel page has six tabs: **Brand**, **Cast**, **Templates**, **Schedules**,
 | **Always Yes** | Always answers Yes. |
 | **Always No** | Always answers No. |
 
-Mark voices in **Settings → Voices** and Image prompts in **Library → Prompts**. See [Publishing to YouTube](Publishing-to-YouTube).
+Mark voices in **Settings → Voices** and Image prompts in **Prompts**. See [Publishing to YouTube](Publishing-to-YouTube).
+
+**Posting.** The channel's accounts on other sites, used only for [posting](Posting-to-Social-Sites). **X subscription** (Free, Premium or Premium+) only changes which warnings a post gets: Free warns about text over 280 characters and videos over 2 min 20 s. **Account names** (such as `@yourname` on X, `in/your-name` on LinkedIn, `yourname.bsky.social` on Bluesky, `u/yourname` on Reddit) let the extension find a published post's link on your profile. They are never a sign-in. Saved with **Save channel**.
 
 **Series brief.** What the channel covers, its style and what makes a topic worth a video. Topic generation reads it for every schedule of this channel that has no brief of its own. It doesn't change how videos are written. Up to 10,000 characters. See [Schedules](Schedules#topics-that-find-themselves).
 
-**Language of new projects.** The language this channel's new projects are written and narrated in when Play or the template picks none. It applies even with the brand kit off, since it is not styling. Pick voices that speak it. Not set means English. Projects already made keep their language. See [Other languages](Other-Languages).
+**Language of new projects.** The language this channel's new projects are written and narrated in when Create or the template picks none. It applies even with the brand kit off, since it is not styling. Pick voices that speak it. Not set means English. Projects already made keep their language. See [Other languages](Other-Languages).
 
 **Brand kit.** The look every template of this channel gets unless it sets its own. Every field is optional, each fills only what a template leaves at its default, and a blank field adds nothing.
 
 | Field | What it does |
 |---|---|
-| **Caption font** | The subtitle font for videos whose template leaves the font at Default. Fonts you upload in the subtitle font picker on Play appear here. |
-| **Caption colour** | Subtitle text colour as `#` and six hex digits, such as `#FFFFFF`. |
-| **Caption outline** | The colour of the line around each subtitle letter, such as `#000000`. A dark outline keeps light captions readable on bright pictures. |
+| **Caption font** | The caption font for videos whose template leaves the font at its default. Fonts you upload in the **Caption font** picker on Create appear here. |
+| **Caption color** | The captions' text color as `#` and six hex digits, such as `#FFFFFF`. |
+| **Caption outline** | The color of the line around each caption letter, such as `#000000`. A dark outline keeps light captions readable on bright pictures. |
 | **Title font** | The font of chapter cards and the end screen, for videos whose template sets no title style. |
-| **Title colour** | The text colour of chapter cards and the end screen, such as `#FFD700`. |
-| **End screen text** | A line shown centred over the last 5 seconds of every video, such as "Subscribe for more". Up to 200 characters. Blank shows none. |
-| **Intro** / **Outro** | An entry from **Library → Intros & outros**, narrated before or after the body of every video whose template has none. Each is narrated with the video's voice, so each costs one voice request per video (plus a text call for an LLM entry), and it shows in the estimate. See [Intros and outros](Intros-and-Outros). |
-| **Document theme** | The look of the PDF for videos whose template picks no theme. A saved theme that was deleted is skipped. |
+| **Title color** | The text color of chapter cards and the end screen, such as `#FFD700`. |
+| **End screen text** | A line shown centered over the last 5 seconds of every video, such as "Subscribe for more". Up to 200 characters. Blank shows none. |
+| **Intro** / **Outro** | An entry from **Prompts → Intros** and **Outros**, narrated before or after the body of every video whose template has none. Each is narrated with the video's voice, so each costs one voice request per video (plus an AI call for one the AI writes), and it shows in the estimate. See [Intros and outros](Intros-and-Outros). |
+| **PDF look** | The look of the PDF for videos whose template picks none. A saved theme that was deleted is skipped. |
 | **Ambient sound** | Rain, Fireplace or Wind under the long video's narration, with its level (−40 to −6 dB, default −18), fade-in (0 to 30 s, default 3) and tail (0 to 30 s, default 6). Used when the template leaves its own ambient sound on "The channel's". A channel can't hold your own audio file. |
 
 **Channel links.** This channel's named links, such as `Patreon` or `Discord`, that a YouTube description fills when it names them in braces (`{{Patreon}}`). See [Channel links](#channel-links).
 
-Press **Save channel** when you are done.
+Press **Save channel** when you are done. It waits for a change: until you change something, the bar says "Nothing to save yet: change a setting first."
 
-To keep one video exactly as its template was saved, untick **Use the channel's brand kit** on Play or in Edit project. The cast and language still apply. Nothing in the kit reaches a project that already started; a project keeps what it was started with.
+To keep one video exactly as its template was saved, untick **Use the channel's brand kit** on Create or in a project's **Edit settings** → **Channel**. The cast and language still apply. Nothing in the kit reaches a project that already started; a project keeps what it was started with.
 
 ### Cast
 
-Recurring characters, creatures, places and objects, each with reference pictures that go with every image that names them. A cast member with a voice can also be one of the channel's hosts: a new podcast or interview on Play then starts with them as its speakers. See [Cast library](Cast-Library).
+Recurring characters, creatures, places and objects, each with reference pictures that go with every image that names them. A cast member with a voice can also be one of the channel's hosts: a new podcast or interview on Create then starts with them as its speakers. See [Cast](Cast-Library).
+
+### Projects
+
+Everything made in this channel, newest first, as the Projects list shows it: its state in the same words (**Ready to upload**, **Uploaded**, **Done with problems**), its length, what it made and when it finished (or what it is made of and when it started), with **Watch** and **Download video** once it is done.
 
 ### Templates
 
-The channel's templates. Each has a channel picker: choosing another channel moves the template, and every schedule that runs it, to that channel. Their next runs use the new channel's brand kit, cast and series brief. Projects already made keep what they were made with.
+The channel's templates, each with **Make a video** (Create opens with it picked), **New schedule** and **Edit template**. While the channel has templates, the page header leaves out its own **Make a video**, which opens an empty Create. Each has a channel picker: choosing another channel moves the template, and every schedule that runs it, to that channel. Their next runs use the new channel's brand kit, cast and series brief. Projects already made keep what they were made with.
 
 ### Schedules
 
 The schedules that run this channel's templates, with their status and next run. Edit them on **Calendar → Schedules**; see [Schedules](Schedules).
 
-### Episodes (episode memory)
+### Memory
 
-With **Episode memory** on, every finished video of the channel leaves a short summary, and new episodes about the same things read it so they agree with what came before.
+With **Remember what each video covered** on, every finished video of the channel leaves a short summary, and new episodes about the same things read it so they agree with what came before.
 
 How it works:
 
-1. When a video of this channel finishes, one short call to its text model writes a summary of up to 150 words: what the episode covered, the facts it stated, who appeared and what happened to them. The call shows on the project's **Run cost**. Finishing the same article again asks nothing, and a failed call never touches the project.
+1. When a video of this channel finishes, one short call to its AI writes a summary of up to 150 words: what the episode covered, the facts it stated, who appeared and what happened to them. The call shows in the project's cost line (**See the breakdown**). Finishing the same article again asks nothing, and a failed call never touches the project.
 2. When a new episode's article (or multi-voice script) is written by Slopify, the summaries of up to 5 related earlier episodes are added to its writing prompt under "Earlier episodes".
-3. An episode is related when it features a cast member the new title or keywords mention (strongest), or shares words of its title. Words most of the channel's titles share, such as a template's fixed prefix, and one- or two-letter words don't count. An episode with the very same title is a remake, not an earlier episode, and is left out.
+3. An episode is related when it features a cast member the new title or keywords mention (strongest), or shares words of its title. Words most of the channel's titles share, such as a template's fixed prefix, and one- or two-letter words don't count. An episode with the very same title is a new take on that video, not an earlier episode, and is left out.
 4. The summaries are copied into the project when it starts, so later edits never make a finished video outdated.
 
 On the tab:
 
+- **Search episode summaries** finds one by its title, a cast member or its words.
 - **Open** a summary to read or edit it. Your edited text is kept, even if the video finishes again.
 - **Delete** removes a summary from later prompts. The video itself is not changed.
 
 Default: on for new channels. Channels that existed before 3.0 start with it off.
 
-### Existing videos
+### Titles to avoid
 
 Titles this channel published before or outside Slopify. Topic generation and its duplicate checks skip them, as they skip the videos made here.
 
 **Paste titles:**
 
-1. Type or paste titles into **Paste titles**, one per line.
+1. Press **Paste titles…**, then type or paste titles into **Titles, one per line**.
 2. Press **Add titles**. A title already listed (in any case) is skipped.
 
 **Import a YouTube Studio CSV:**
@@ -118,31 +125,31 @@ Titles this channel published before or outside Slopify. Topic generation and it
 4. If the export holds several series, type into **Keep only titles containing…** (for example a series name, any case). Only titles holding that text stay ticked. **Tick all** and **Untick all** reset the ticks, and you can tick each title by hand.
 5. Press **Add N ticked titles**. The import says how many were added and how many were skipped as already listed.
 
-The filter text is remembered for this channel's next import. **Remove** deletes one title, and **Remove all** clears the list.
+The filter text is remembered for this channel's next import. **Search titles to avoid** finds one, **Remove** deletes one title, and **Remove all** clears the list.
 
 ## Channel links
 
-Each channel keeps its own named links, under **Channel links** on its **Brand** tab. Write a link's name in braces in a description prompt or a description, such as `{{Patreon}}`, and it is filled with this channel's link when the description is shown, copied or downloaded.
+Each channel keeps its own named links, under **Channel links** on its **Name and look** tab. Write a link's name in braces in a description prompt or a description, such as `{{Patreon}}`, and it is filled with this channel's link when the description is shown, copied or downloaded.
 
-1. Open **Channels** → the channel → **Brand**.
+1. Open **Channels** → the channel → **Name and look**.
 2. Under **Channel links**, press **Add link**, type the **name** (for example `Patreon`) and the URL (`https://…`). **Remove** takes one off.
 3. Press **Save channel**.
 
-Names match whatever their case or spacing. `{{Previous video}}` works the same way, but a project can set its own on its **YouTube** section (**Previous video for this project**, then **Save links**), which wins over the channel's. A placeholder with no link stays as typed, and the YouTube section says "No link is saved for {{…}}, so it stays as typed." with where to add it.
+Names match whatever their case or spacing. `{{Previous video}}` works the same way, but a project can set its own in its **YouTube** part (**Previous episode**, then **Save**), which wins over the channel's. A placeholder with no link stays as typed, and the YouTube section says "No link is saved for {{…}}, so it stays as typed." with where to add it.
 
-Links saved in **Settings → Channel links** before channels had their own still fill the default channel's descriptions until you save its Brand tab; that Settings section now only points here (**Open the default channel's links**). Channel links travel in backups with their channel. See [YouTube description](YouTube-Description) and [Publishing to YouTube](Publishing-to-YouTube).
+Links saved in Settings before channels had their own still fill the default channel's descriptions until you save its Name and look tab; while they do, Settings → **YouTube Studio and posting** says so under **Links saved here before**, with **Open <channel>'s links**. Channel links travel in backups with their channel. See [YouTube description](YouTube-Description) and [Publishing to YouTube](Publishing-to-YouTube).
 
 ## Tips
 
 - Give each series its own channel, even if you upload them to one YouTube channel. The brand kit, cast and topic ideas stay separate.
-- Import your existing videos before turning on topic generation, so Slopify doesn't suggest what you already made.
+- Add the titles you made before (**Titles to avoid**) before turning on topic generation, so Slopify doesn't suggest what you already made.
 - Edit an episode summary when it gets a fact wrong. Later episodes will follow your version.
 
 ## Related pages
 
-- [Cast library](Cast-Library)
+- [Cast](Cast-Library)
 - [Templates](Templates)
 - [Schedules](Schedules)
-- [Play video and style](Play-Video-and-Style)
+- [Create: Video and Style](Create-Video-and-Style)
 - [Publishing to YouTube](Publishing-to-YouTube)
 - [Other languages](Other-Languages)

package/dist/tutorials/Costs-and-Run-Cost.md

@@ -1,17 +1,17 @@
 # Costs and Run Cost
 
-Slopify shows what a run is likely to cost before you start it, what it actually cost once it ran, and, for runs on a command-line plan, what the same work would have cost with API keys and how much of your plan it used. All figures are in US dollars, from the providers' published prices.
+Slopify shows what a run is likely to cost before you start it, what it actually cost once it ran, and, for runs on a command-line plan, what the same work would have cost with API keys and how much of your plan it used. All figures are in US dollars, from the services' published prices.
 
-**Where to find it:** Play → **Estimated cost** in the right rail; a project → **Run cost** tab; Home → **This week**; Settings → **Usage**.
+**Where to find it:** Create → **Estimated cost** in the rail; a project → the cost line under its status list, and **See the breakdown**; Home → **This week**; Settings → **Usage**.
 
 ## Where costs come from
 
-- Every successful provider call is recorded against its project with what it used: tokens in and out (and how many were cached) for text, characters for narration, images per model, seconds of animated video, and how long the call took.
+- Every successful call to a service is recorded against its project with what it used: tokens in and out (and how many were cached) for text, characters for narration, images per model, seconds of animated video, and how long the call took.
 - Each call is priced when it finishes, from the model catalogue (see [Models](Models)). The rates are stored with the call, so a later price change never rewrites a finished run.
-- A model the catalogue has no price for, or a call whose provider reported no usage, is counted as unknown, never as free. Per-minute voices are left unpriced rather than guessed.
-- Failed calls are not charged here. Taxes and credits included in your provider plan are not counted.
+- A model the catalogue has no price for, or a call whose service reported no usage, is counted as unknown, never as free. Per-minute voices are left unpriced rather than guessed.
+- Failed calls are not charged here. Taxes and credits included in your plan with a service are not counted.
 
-Your provider bills you directly; Slopify never handles payment. The figures are for planning and checking, not a bill.
+Each service bills you directly; Slopify never handles payment. The figures are for planning and checking, not a bill.
 
 ## Command-line runs: $0 on your plan
 
@@ -21,75 +21,73 @@ There is no API figure for a model the catalogue does not list, for a CLI's defa
 
 See [AI-CLIs](AI-CLIs#plan-limits-and-waiting-them-out) for the plan limits themselves.
 
-## Before you start: Estimated cost on Play
+## Before you start: Estimated cost on Create
 
-The right rail on Play shows **Estimated cost** once the setup is complete. Until then it says "The estimate appears once the setup is complete."
+The rail on Create shows **Estimated cost** once the setup is complete. Until then it says "Estimated cost: shown once nothing is missing."
 
 | Part | What it shows |
 |---|---|
 | **Estimated total** | The likely range for this run (or all the runs on the page), for example "$0.42 – $0.61". |
 | **Known subtotal** | Shown instead of the total when some stage has no price; a line below says how many stage charges have unavailable pricing. |
-| **Cost by stage** | Fold-out list: each stage's range and what it assumes. A CLI stage reads "$0 on your plan · ~$X via API". |
+| **Cost by stage** | Fold-out list (**Cost by stage · N stages**): each stage's range and what it assumes. A CLI stage reads "$0 on your plan · ~$X via API". |
 | CLI steps line | "CLI steps: $0 on your plan · ~$X via API" for everything on a plan. |
 | Catalogue date | "Catalogue verified <date>". With several videos, rows show combined costs. |
 
-**Expected article words per video** drives the estimate for generated articles (and how many images **More images for long videos** adds). About 150 words is one minute. Default: 1500. Once the article is written, its real length is used.
+**Words per video** (in the rail's **Expected length**, with **Change**) drives the estimate for articles the AI writes (and how many images **More images for long videos** adds). About 150 words is one minute. Default: 1500. Once the article is written, its real length is used.
 
-The estimate is what the providers are likely to charge, from their published prices. Actual usage can differ, and the estimate does not cap spending.
+The estimate is what the services are likely to charge, from their published prices. Actual usage can differ, and the estimate does not cap spending.
 
-## While a run is going: Cost so far
+## The cost line
 
-On a running project, the side panel shows **Cost so far**:
+Under the status list on the project page, one line sums up what the run cost: for example `Cost $0.42 · ~$3.10 via API · 12 min of working time · See the breakdown`.
 
-- **spent**: what has been paid to providers so far ("known, spent" when some calls have no price).
-- **same work via API**: the API equivalent of the CLI calls.
-- One meter per plan window a CLI reported, such as "Codex: 14% of your weekly limit". The meter turns amber once the plan is at 80% or more.
+- While the run goes it reads **Cost so far**, and the title row's clock counts the working time instead.
+- **known** after the amount means some calls have no price.
+- **~$X via API** is what the calls that ran on a CLI plan would have cost through the API.
+- Before anything is spent it reads **Nothing spent yet**.
 
-When a CLI's plan is used up, the run waits instead of failing: the status reads **Waiting for limits**, for example "Waiting for Codex limits (resets at 14:00)". The run carries on by itself when the plan resets.
+When a CLI's plan is used up, the run waits instead of failing: the state reads **Waiting for limits**, for example "Waiting for Codex limits (resets at 14:00)". The run carries on by itself when the plan resets.
 
-## After a run: the run cost line
-
-When a run has ended, one line at the top of its project page, under the title, sums it up: for example `This run cost $0.42 · ~$3.10 via API · 12 min of work`. A failed or canceled run says **Spent so far**, and calls without a known price add "plus unpriced calls". **See cost by stage** opens the full breakdown below. The line doesn't show while the run is going, or when it spent nothing.
-
-## After a run: the Run cost tab
+## The breakdown: the Cost part
 
 1. Open the project from **Projects** or **Home**.
-2. Choose **Cost** in the section rail (or **See cost by stage** on the run cost line).
+2. Press **See the breakdown** on the cost line.
 
-If nothing has been spent yet, it says "Nothing has been spent yet. The cost of each provider call appears here as the run makes it."
+If nothing has been spent yet, it says "Nothing has been spent yet. The cost of each call to an AI service appears here as the run makes it."
 
 ### Summary
 
+The summary shows only what the cost line beside it does not: the total cost and the working time are in the cost line, and again in the last line under the tables. It appears when one of these applies.
+
 | Figure | What it is |
 |---|---|
-| **paid to providers** | The total cost of this project's calls. Reads "known cost, paid to providers" when some calls have no price, with a line "Plus N calls the model catalogue has no price for." |
 | **same work via API** | The API equivalent of the calls that ran on a CLI plan. |
 | Plan meters | One per plan window a CLI reported, for example "3% of weekly Codex limit". Hover or read the line below for the level it is at now. |
-| **this run's working time** | How long some step of the run was working. Waiting on a review, a limit or a pause never counts, and steps that ran side by side count once. Each save that remakes something starts a new run. |
 
 Lines under the summary:
 
+- "Plus N calls the model catalogue has no price for.", when some calls have no price.
 - "CLI calls: $0 on your plan · ~$1.20 via API", when any call ran on a plan.
 - "This run used ~3% of your weekly Codex limit (now at 41%, resets Mon 09:00)." Codex reports whole percents, so a short run can read "under 1%".
 - When a CLI reported nothing (Gemini, or a Docker host helper older than the app), it says the share is not known.
 
-### By stage
+### By step
 
-**Cost by stage**: what each stage has cost so far, from every provider call it made, retries and remakes included.
+**By step**: what each stage has cost so far, from every call it made to a service, retries and everything made again included.
 
 | Column | What it shows |
 |---|---|
-| **Stage** | Research, Article, Audio, Images, Thumbnail, Video, Document. |
-| **Cost** | What you paid. "$0 on plan" for CLI stages; "Unknown" when no call in it has a price; "$0.40 + unknown" when some do not. |
+| **Step** | Research, Article, Narration, Images, Thumbnail, Video, PDF. |
+| **Cost** | What you paid. "$0 on plan" for CLI stages; "Not known" when no call in it has a price; "$0.40 + not known" when some do not. |
 | **Via API** | The API equivalent for CLI calls, or "No API price". |
 | **Usage** | Tokens in and out (and cached), characters, images, seconds of video. |
-| **Time** | How long the stage ran. |
+| **Working time** | How long the step's work ran, over every run. |
 
 ### By model
 
-**Cost by model**: the same spending split by provider and model, with **Cost**, **Via API**, **Usage** and **Calls**. A CLI model shows the API model it was priced as, in brackets after "as". The CLI's own default model shows as "default model".
+**By model**: the same spending split by service and model, named as Create names them (for example **Inworld · Inworld TTS-2**), with **Cost**, **Via API**, **Usage** and **Calls**. A CLI model shows the API model it was priced as, in brackets after "as". The CLI's own default model shows as "its default model", and a sample's own services as **Sample artist**, **Sample writer** and so on.
 
-The last lines give the total usage and the working time over every run, and "Priced from the model catalogue of <date> when each call finished."
+The last lines give the total, for example "In total: $0.42 · 12,400 characters · 9 images · 12 min working, over every run." (with **known** after the amount when some calls have no price), and "Priced from the model catalogue of <date> when each call finished."
 
 ## Across all projects: Home → This week
 
@@ -99,7 +97,7 @@ Home's **This week** section, since Monday:
 - **spent**, followed by "· ~$X via API" and "· N calls without a price" when they apply.
 - One bar per CLI plan: how much of its weekly limit is used, from the tool's last reading. The bar turns amber at 80%.
 
-It includes calls that belong to no project: a schedule's topic suggestions, a channel's episode summaries and a cast member's picture. These never appear on a project's Run cost tab. The channel picker at the top of Home narrows the numbers to one channel. See [Home-and-Projects](Home-and-Projects).
+It includes calls that belong to no project: a schedule's topic suggestions, a channel's episode summaries and a cast member's picture. These never appear on a project's cost breakdown. With two or more channels, **Showing:** in Home's header narrows the numbers to one channel. See [Home-and-Projects](Home-and-Projects).
 
 ## Your usage totals: Settings → Usage
 
@@ -108,12 +106,12 @@ Settings → **Usage** shows this install's own counters, worked out on this com
 | Counter | What it counts |
 |---|---|
 | **Videos made** | Videos finished. |
-| **Hours of audio** | Narration made, in hours. |
+| **Hours of narration** | Narration made, in hours. |
 | **Images made** | Images drawn. |
-| **Tokens used** | Text tokens, in and out. |
+| **AI text read and written** | Text the AI read and wrote, in tokens (pieces of about three quarters of a word). |
 | **Projects** | Projects made. |
 
-Below them, **Tokens by stage** lists **Stage**, **Provider · model**, **Tokens in** and **Tokens out**. A fresh install says "Numbers appear after your first run." The last line shows the install's machine ID and Slopify version.
+Beside them, **AI text by part of the video** lists **Part**, **Service · model**, **Read** and **Written**. A fresh install shows only **Nothing made yet** with **Make your first video**. The last line shows this computer's random number (the one each count carries) and the Slopify version.
 
 The same counters, anonymised, feed the public totals on slopify.stream. They never include your keys, prompts, keywords, titles, text or files.
 
@@ -121,7 +119,7 @@ To jump there, press `Ctrl+K` and run **Open usage and costs**. The old `/usage`
 
 ## Tips
 
-- Set **Expected article words per video** close to what your prompt really writes; it is the biggest lever on the estimate for a generated article.
+- Set **Words per video** close to what your prompt really writes; it is the biggest lever on the estimate for a generated article.
 - Compare the **Via API** column with your plan's price to see whether a subscription or a key is cheaper for how you work.
 - If a total says "known cost", check which model has no price in [Models](Models) and add one to your catalogue file if you know it.
 
@@ -129,8 +127,8 @@ To jump there, press `Ctrl+K` and run **Open usage and costs**. The old `/usage`
 
 - [Models](Models)
 - [AI-CLIs](AI-CLIs)
-- [Providers-and-Keys](Providers-and-Keys)
-- [Play-Outputs](Play-Outputs)
+- [Keys and Services](Providers-and-Keys)
+- [Create: Extras](Create-Extras)
 - [Project-Page](Project-Page)
 - [Home-and-Projects](Home-and-Projects)
 - [Settings-Reference](Settings-Reference)

package/dist/tutorials/Create-Article.md

@@ -0,0 +1,114 @@
+# Create: Article
+
+The article is the script of your video: the narration reads it, the captions show it, the chapters come from its headings and the PDF lays it out. On Create you either have an AI write it from a prompt, or use your own text. This page covers the **Article** row: where the text comes from, the article prompt, **Written by**, research and the language.
+
+**Where to find it:** Create → **Article** row → **Change**. Keywords and the title pattern are in the **Keywords** row; see [Create Overview](Create-Overview#keywords). The intro and outro are in the Narration row; see [Narration](Create-Narration#intro-and-outro).
+
+## Choose where the article comes from
+
+The row starts with an **Article** switch:
+
+| Choice | What happens | Cost |
+| --- | --- | --- |
+| **Write it for me** (default) | The AI writes the article from the article prompt, in one call. | One AI call |
+| **Use my text as written** | Slopify narrates the text you paste, word for word. No AI writes one. | Nothing for the article |
+| **Adapt my text** | The AI rewrites the text you paste with the article prompt, for example to shorten it or change its tone. The narration reads what the prompt makes of it. | One AI call |
+| **No text** | No article at all, for a set of images or a thumbnail made from prompts. Narration, the PDF and anything else that reads the article stay off. | Nothing |
+
+### Write the article from a prompt
+
+1. Open the **Article** row and leave it on **Write it for me**.
+2. Pick an **Article prompt**. Each card shows the prompt's name, its first line and the length it asks for (for example **About 20 min · 2800-3200 words**). With many prompts, a filter box narrows the list.
+3. Optional: open **Text of the prompt** to read the picked prompt.
+4. Fill in any keywords the prompt asks for (at the top, or in the **Keywords** row).
+5. Check the service and model under **Written by** (below).
+
+With no article prompts yet, the row says so with **New article prompt**. It opens a drawer beside Create where you write one, and the prompt you save is picked. See [Prompts](Prompts).
+
+When the narration has several speakers and the script is written for them, the field becomes **Script prompt**: a script prompt asks for speaker turns instead of a plain article. See [Multiple Voices](Multiple-Voices).
+
+### Paste your own article
+
+1. Open the **Article** row and pick **Use my text as written**.
+2. Paste the text into **Article text**.
+3. Check the count under it (words and characters). About 150 words is one minute of narration.
+
+Include everything that should be read, headings too. Headings become chapters. **Text that will be spoken** folds out the words the narrator will say: your text without its end matter (sources and the Pronunciation Glossary are never read), with your narration aliases applied when they are on. Research is off while you use your own text.
+
+### Adapt your own text
+
+Pick **Adapt my text**, paste the source under **Your text**, and pick the **Article prompt** that rewrites it. Your text stays the source; the article prompt decides the length and tone.
+
+## Written by
+
+One AI writes everything this run needs in words: the article, the research, the thumbnail prompt when the AI writes it, intros and outros written for each video, narration preparation, descriptions of tables and figures, the YouTube description and picking the shorts. Each is a separate call, counted in Usage.
+
+The **Written by** group appears whenever the run needs an AI writer, in the row of the first thing that needs it, and its line says what it is used for (for example "for writing the article, writing the YouTube description and picking the shorts"). It is in **Article** when the article or research is written for you, in **Narration** when only the narration needs it (an audiobook whose speakers are worked out from a book you pasted, say), and in **Extras** when only the YouTube description, the shorts or the thumbnail prompt need it. There is one writer per run, wherever it shows.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Service** | Who runs the writer: a tool you are signed in to, such as Claude Code or Codex, or a keyed service such as OpenRouter, billed per token. Each service in the list says when it has **No key** or is **Not found**; fix it under Settings → Keys & services. | The one Settings → Keys & services says Create picks |
+| **Model** | The model the service runs for every writing step. Bigger models write better and cost more per token. | The service's default |
+| **Thinking** | How long the model reasons before it answers, for models that offer it. Higher levels can write more carefully but take longer and use more tokens. | **Model default** |
+
+Notes on the pickers:
+
+- Changing the service clears the model, so pick a model again.
+- **Type a model ID…** at the end of the model list lets you type one the list does not show.
+- The line under the model says whether it was checked (for example **Works · checked 2 min ago**), with **Manage models ↗** to Settings → Models.
+- **Thinking** only appears when the model offers levels.
+
+If the run needs a writer and none is picked, the row says to pick a service and model. See [Keys and Services](Providers-and-Keys), [AI CLIs](AI-CLIs) and [Models](Models).
+
+## Research
+
+Research gives the writer notes to write from, beyond what it already knows. It has its own **Research** switch in the Article row:
+
+| Choice | What happens | Cost |
+| --- | --- | --- |
+| **Off** (default) | The article is written from the prompt alone. | Nothing extra |
+| **Let the AI research** | The AI plans chapters and looks each one up on the web before it writes. | A few more AI calls: one to plan, one per chapter, one to combine |
+| **Paste my notes** | Uses notes you paste in **Research notes**. Nothing is looked up. | Nothing extra |
+
+### Research on the web
+
+1. Set **Research** to **Let the AI research**.
+2. Make sure the model can search the web. A model that cannot fails the Research step straight away, rather than falling back to what it already knows.
+3. Make the video. You can watch the notes being written in the project's **Progress**.
+
+### Give your own research notes
+
+1. Set **Research** to **Paste my notes**.
+2. Paste the facts, sources and quotes the article should draw on into **Research notes**.
+
+The notes are given to the writer with the article prompt, in place of web research.
+
+## Language
+
+**Language** at the end of the row picks the language the article, narration, YouTube description and shorts titles are written in. **Channel's language** uses the channel's. The line under it says what is written and timed in that language. See [Other Languages](Other-Languages).
+
+## Expected length
+
+**Expected length** in the rail tells Slopify how long you expect each article to be, which drives the cost estimate and how many images **More images for long videos** adds. Once the article is written, its real length is used. Set it to roughly what your article prompt asks for. See [Create Overview](Create-Overview#expected-length).
+
+## What the row says
+
+Folded, the Article row says what will happen, for example `Written by Claude Code CLI (Sonnet 5.5) from the “History · Documentary” prompt, with web research.`, or `Your own text, used as written.` What is still missing follows, such as "No article prompt picked yet."
+
+## Tips
+
+- Ask for a Pronunciation Glossary at the end of your article prompt if the topic has unusual names. See [Narration](Create-Narration#pronunciation-glossary).
+- **See everything this run will do** → **The prompts as they will be sent** shows the article prompt exactly as it goes out, keywords filled in.
+- An AI check can read the article after it is written. See [Pauses and Checks](Reviews-and-Checkpoints).
+- To change the article after the run, edit it on the project page. See [Editing a Project](Editing-a-Project).
+
+## Related pages
+
+- [Create Overview](Create-Overview)
+- [Prompts](Prompts)
+- [Intros and Outros](Intros-and-Outros)
+- [Models](Models)
+- [Keys and Services](Providers-and-Keys)
+- [AI CLIs](AI-CLIs)
+- [Multiple Voices](Multiple-Voices)
+- [Other Languages](Other-Languages)