@gentbajko/slopify 4.0.0 → 4.1.0

package/dist/tutorials/Video-Editing.md

@@ -1,12 +1,12 @@
 # Video Editing
 
-These settings decide how the finished video looks and sounds: how long each image stays, where the cuts fall, how images move and hand over, the Look, chapter cards, animated images, ambient sound and captions. All of it except animated images is done on your computer with ffmpeg, so it costs render time, not API calls.
+These settings decide how the finished video looks and sounds: how long each image stays, where the cuts fall, how images move and hand over, the Look, chapter cards, animated images, ambient sound and captions. All of it except animated images is done on your computer with ffmpeg, so it costs time on your computer, not service calls.
 
-**Where to find it:** a project → **Edit settings** → **Inputs** (**Timing**, **Cuts and look**, **Ambient sound**) and **Subtitles**. On a new run the same controls are on Play → **Video and style** (see [Play Video and Style](Play-Video-and-Style)).
+**Where to find it:** a project → **Edit settings** → **Video and style** (**Images and cuts**, and **Sound polish** for the silences and ambient sound) and **Captions**. On a new run the same controls are on Create → **Video and style** (see [Create: Video and Style](Create-Video-and-Style)).
 
 ## How the video is put together
 
-Slopify plans the whole video as an edit list: which image or clip plays, for how long, how it moves, how it hands over to the next, and the effects on top. The renderer reads only that list, so the same project renders the same video every time. The video is always exactly as long as its narration plus the silence you set.
+Slopify plans the whole video as an edit list: which image or clip plays, for how long, how it moves, how it hands over to the next, and the effects on top. The video is put together from that list alone, so the same project makes the same video every time. The video is always exactly as long as its narration plus the silence you set.
 
 ## Timing
 
@@ -39,95 +39,95 @@ New projects default to **Follow the narration**. It needs word timing, so it wo
 | --- | --- | --- |
 | **Transition** | How one image hands over to the next: **Cut**, **Crossfade**, **Fade through black**, **Slide** or **Wipe**. The change is centred on the cut, so the video stays exactly as long as its narration. | Cut |
 | **Transition length** | How long the transition takes (ignored for Cut). | 0.6 s; 0.2, 0.4, 0.6, 0.8, 1, 1.2, 1.5 or 2 s |
-| **Colour grade** | A colour treatment over the whole video: **Warm fantasy**, **Cold**, **Desaturated** or **Sepia**. | None |
+| **Color grade** | A color treatment over the whole video: **Warm fantasy**, **Cold**, **Desaturated** or **Sepia**. | None |
 | **Vignette** | Darkens the corners to draw the eye to the middle: **Subtle** or **Strong**. | Off |
 | **Film grain** | Moving film grain over the whole picture: **Subtle** or **Strong**. | Off |
 | **Atmosphere** | An overlay Slopify draws itself: **Embers** (rising), **Dust** (drifting) or **Fog** (low, along the bottom). No footage is downloaded. | None |
 | **Chapter cards** | Shows each chapter's title in the middle of the picture for 2.5 seconds as the chapter starts, in the caption font. Chapters come from the YouTube description when that step runs, otherwise from the article's headings. Needs narration. | Off |
-| **Animate images** | Turns some images into 5-second moving clips with an image-to-video model on your image provider (fal.ai or Replicate). **Chapter openers** animates the first image of each chapter (needs narration); **Every Nth image** animates every 2nd to 10th image (**Animate every how many images**). Pick the model in **Image-to-video model**. | Off |
+| **Animate images** | Turns some images into 5-second moving clips with an image-to-video model on your image service (fal.ai or Replicate). **Chapter openers** animates the first image of each chapter (needs narration); **Every Nth image** animates every 2nd to 10th image (**Animate every how many images**). Pick the model in **Image-to-video model**. | Off |
 
-Every Look option except **Animate images** is applied while the video renders, with no API cost. Each animated clip is one paid call, shown in the estimate. An image that cannot be animated stays still, and the Video section lists it under **Render notes**.
+Every Look option except **Animate images** is applied while the video is put together, at no cost. Each animated clip is one paid call, shown in the estimate. An image that cannot be animated stays still, and the Video part says so in its notes under the player.
 
 ### Set up the Look
 
-1. Open the project → **Edit settings** → **Inputs**.
-2. Under **Cuts and look**, click **Look** to open it.
+1. Open the project → **Edit settings** → **Video and style**.
+2. Under **Images and cuts**, open **Look**.
 3. Pick a transition, grade, vignette, grain, atmosphere, chapter cards or animation.
 4. Press **Save changes**.
-5. Press the next action, **Remake the outdated video**, or review it in **Choose what to remake**.
+5. Press the next action, **Make the outdated video again**, or look it over in **Choose what to make again**.
 
 Changing the Look outdates the video; narration and images are kept.
 
 ## Video clips in place of images
 
-In **Edit project → Images**, **Add a video clip** puts your own clip into the image order. It plays muted for as long as an image would be shown: trimmed, slowed (to half speed at most) or looped to fit. See [Editing a Project](Editing-a-Project#edit-images).
+In **Edit settings** → **Images**, **Add a video clip** puts your own clip into the image order. It plays muted for as long as an image would be shown: trimmed, slowed (to half speed at most) or looped to fit. See [Editing a Project](Editing-a-Project#edit-images).
 
-If the clips you uploaded are real filmed footage, turn on **Real footage** in Prepare upload so YouTube's AI-use answer is right. See [Publishing to YouTube](Publishing-to-YouTube).
+If the clips you uploaded are real filmed footage, turn on **The uploaded clip is real footage** (or **The 3 uploaded clips are real footage**) in Copy for YouTube Studio so YouTube's AI-use answer is right. See [Publishing to YouTube](Publishing-to-YouTube).
 
 ## Ambient sound
 
-A quiet bed under the whole narration of the long video. It dips while the narrator speaks. Costs no API calls. Shorts never get it. Changing it remakes only the video.
+A quiet bed under the whole narration of the long video. It dips while the narrator speaks. It costs nothing. Shorts never get it. Changing it makes only the video again.
 
-**Where to find it:** a project → **Edit settings** → **Inputs** → **Ambient sound** (shown when the project has narration and video).
+**Where to find it:** a project → **Edit settings** → **Video and style** → **Sound polish** → **Ambient sound** (shown when the project has narration and video).
 
 | Option | What it does | Default / range |
 | --- | --- | --- |
-| **Ambient sound** | **Rain**, **Fireplace** or **Wind**, made on your computer, or **None**. **My own file** stays offered while the project has an uploaded bed; a new file is chosen on Play. | None, or the channel's bed |
+| **Ambient sound** | **Rain**, **Fireplace** or **Wind**, made on your computer, or **None**. **My own file** stays offered while the project has an uploaded bed; a new file is chosen on Create. | None, or the channel's bed |
 | **Level (dB)** | How loud it plays under the voice, from -40 (barely there) to -6 (close to the voice). Whole numbers only. | -18 |
 | **Fade in (seconds)** | How long it takes to rise from silence at the start. | 3; 0 to 30 in 0.5 steps |
 | **Tail after the narration (seconds)** | How long it keeps playing, fading out, after the narration ends. A tail longer than the silence at the end makes the video that much longer. | 6; 0 to 30 in 0.5 steps |
 
 With **Level the volume** on, the bed is mixed and ducked first, then the whole mix is mastered. See [Editing a Project](Editing-a-Project#pauses-and-volume).
 
-## Subtitles
+## Captions
 
-**Where to find it:** a project → **Edit settings** → **Subtitles**.
+**Where to find it:** a project → **Edit settings** → **Captions**.
 
 | Option | What it does | Default / range |
 | --- | --- | --- |
-| **Subtitles** | **Off** makes none. **Subtitle files (.srt + .vtt)** gives you files to upload beside the video. **Burn into video + files** draws the captions into the picture and also makes the files; it needs Video on. | Off |
-| **Subtitle font** | The typeface of burned-in captions and chapter cards. Pick a bundled font (**Default font · bundled**) or upload one with **Upload font (.ttf or .otf)**; uploaded fonts stay available to every project. | The bundled font |
-| **Subtitle font size** | How big burned-in captions are. Larger is easier to read on phones but covers more of the picture. | 48; 16 to 120 |
-| **Subtitle position** | Where burned-in captions sit: **Top**, **Upper-middle**, **Center**, **Lower-middle** or **Bottom**. Move them up when pictures have detail near the bottom. | Bottom |
+| **Captions** | **Off** makes none. **Show captions in the video** draws them into the picture and also saves them as .srt and .vtt files for YouTube; it needs Video on. **Caption files only (.srt + .vtt)** gives you files to upload beside the video, which itself shows none. | Off |
+| **Caption font** | The typeface of captions in the video and of chapter cards. Pick a bundled font (**Default font · bundled**) or upload one with **Upload font (.ttf or .otf)**; uploaded fonts stay available to every project. | The bundled font |
+| **Caption size** | How big captions in the video are. Larger is easier to read on phones but covers more of the picture. | 48; 16 to 120 |
+| **Caption position** | Where captions in the video sit: **Top**, **Upper-middle**, **Center**, **Lower-middle** or **Bottom**. Move them up when pictures have detail near the bottom. | Bottom |
 
-Captions are timed from your narration on your computer, with no paid API. The first use downloads a speech model of about 378 MB (Settings → Production defaults → **Subtitle timing model** offers smaller ones). Subtitle files carry no font, size or position, because players style them. Changing the font, size or position remakes only the video.
+Captions are timed from your narration on your computer, at no cost. The first use downloads a speech model of about 378 MB (Settings → Production defaults → **Caption timing model** offers smaller ones). Caption files carry no font, size or position, because players style them. Changing the font, size or position makes only the video again.
 
-Subtitles need narration: with Audio off the section says "Turn Audio on to add subtitles." With Video off (an audio export), only subtitle files are offered.
+Captions need narration: with Narration off the section says "Captions come from the narration: turn Narration on to add them." With Video off (sound only), only caption files are offered.
 
 To fix a misheard word or move a caption, edit the captions themselves: see [Editing a Project](Editing-a-Project#edit-captions).
 
 ## Style preview
 
-**Style preview** (under Subtitles in Edit project, and in Play's right rail) renders six seconds of video with the real renderer, at a small size: your format, captions, Look, transition, motion and a chapter card when chapter cards are on.
+**Style preview** (under Captions in Edit settings, and from **Watch a 6-second preview** in Create's rail) makes six seconds of video the way the real video is made, at a small size: your format, captions, Look, transition, motion and a chapter card when chapter cards are on.
 
 - It is drawn on the project's establishing image or a cast picture when there is one (the line under it says "Drawn on ..."), otherwise on three plain stills.
-- It renders again by itself a moment after you change a setting. **Render again** forces a fresh one.
-- Captions show in the preview only when they are burned in.
-- The sound is silence. It costs no API calls, only a few seconds of your computer's time.
+- It is made again by itself a moment after you change a setting. **Make the preview again** forces a fresh one.
+- Captions show in the preview only when they are shown in the video.
+- The sound is silence. It costs nothing, only a few seconds of your computer's time.
 
-If it says "Fix the caption settings to render the preview", correct the subtitle fields first.
+If it says "Fix the caption settings to make the preview.", correct the caption fields first.
 
-## What a change remakes
+## What a change makes again
 
 | You change | What is made again |
 | --- | --- |
-| Seconds per image, zoom, motion, cuts, the Look (except Animate images), subtitles style, ambient sound | The video only |
+| Seconds per image, zoom, motion, cuts, the Look (except Animate images), the captions' style, ambient sound | The video only |
 | Animate images | The animated clips (paid) and the video |
-| Subtitle mode | Subtitle files and the video |
-| Caption text or timing | Subtitle files and the video |
+| Captions (Off, in the video, files only) | Caption files and the video |
+| Caption text or timing | Caption files and the video |
 | Pauses between sentences or paragraphs | The narration join and timing, captions, the video, and (when on) the YouTube description and the shorts' pick |
 
-The rebuild review lists exactly what will be made before anything runs. See [Editing a Project](Editing-a-Project#choose-what-to-remake).
+**Choose what to make again** lists exactly what will be made before anything runs. See [Editing a Project](Editing-a-Project#choose-what-to-make-again).
 
 ## Tips
 
 - Try a Look on the style preview first; it costs nothing.
 - A crossfade longer than about a second eats into short shots. Keep transitions short when Seconds per image is low.
-- Captions burned into the picture cannot be turned off by viewers. Subtitle files let YouTube viewers switch them.
+- Captions shown in the video cannot be turned off by viewers. Caption files let YouTube viewers switch them.
 
 ## Related pages
 
-- [Play Video and Style](Play-Video-and-Style)
+- [Create: Video and Style](Create-Video-and-Style)
 - [Editing a Project](Editing-a-Project)
 - [Project Page](Project-Page)
 - [Shorts](Shorts)

package/dist/tutorials/Where-Your-Files-Live.md

@@ -2,16 +2,16 @@
 
 Slopify keeps two kinds of files apart: your files (projects, backups, exports), in a normal folder you can open, and Slopify's own data (database, settings, keys, logs), in a hidden folder. This page says where each is, how to move your files, and how to free disk space.
 
-**Where to find it:** Settings → **Backup & storage** → **Your files**, **Export and import**, **Disk space** and **Sample projects**.
+**Where to find it:** Settings → **Backup & storage** → **Your files**, **Export and import** and **Disk space**.
 
 ## The two places
 
 | What | Where (new install) | Contains |
 | --- | --- | --- |
 | Your files | `<Documents>/Slopify/` | `Projects/`: one folder per project, with its video, images, narration, captions and documents. `Backups/`: scheduled backups, unless you choose another folder. `Exports/`: files Slopify saves for you; downloads go through the browser today, so it stays empty, and Slopify never cleans it. |
-| Slopify's data | `~/.slopify` (or `--data-dir` / `SLOPIFY_DATA_DIR`) | The database (`slopify.db`) with your library, settings and provider keys, `logs/`, `staging/` (uploads in progress), `models/` (caption models), and depending on use `fonts/`, `cache/`, `autostart/`, `updates/` (in-app updates) and `bin/` (a downloaded ffmpeg). |
+| Slopify's data | `~/.slopify` (or `--data-dir` / `SLOPIFY_DATA_DIR`) | The database (`slopify.db`) with your prompts, templates, settings and service keys, `logs/`, `staging/` (uploads in progress), `models/` (caption models), and depending on use `fonts/`, `cache/`, `autostart/`, `updates/` (in-app updates) and `bin/` (a downloaded ffmpeg). |
 
-The data folder is readable by your user only, because it holds your provider keys. Never share it; share an export instead (keys are never in one).
+The data folder is readable by your user only, because it holds your service keys. Never share it; share an export instead (keys are never in one).
 
 The terminal prints both places when Slopify starts (`Slopify data directory:` and `Projects:`).
 
@@ -33,7 +33,7 @@ Each project has one folder in `Projects/`, named after its title (`Lolth | D&D
 | --- | --- | --- |
 | `Upload/` | The current version, ready to publish: `video.mp4`, `thumbnail.png` (and `thumbnail 2.png`…), `subtitles.srt` and `.vtt`, `description.txt`, `tags.txt`, `titles.txt`, `pinned comment.txt`, `document.pdf`, `article.md`, `Images/` (every image the video shows, in order; an older version's images in `Images/Earlier/<date>/`), and `Shorts/1 - <title>.mp4`… with each short's images beside it in `Shorts/1 - <title>/`. No cleanup ever deletes these images. | No: it is what you upload. |
 | `Working/` | What the current version was made from: `Narration/` (each chunk, the joined and levelled narration), `Research/`, `Article/`, `Subtitles/`, `Render/`. | Only to free space on a finished video: changing that project later makes these again, which takes time and provider credits. **Keep outputs only** does it for you. |
-| `History/<date>/` | Files of older versions, by the day they were made (an earlier render, the narration before a voice change). | Yes. Delete a day's folder, or all of `History/`, to free its space. Going back to that version in History makes its files again. |
+| `History/<date>/` | Files of older versions, by the day they were made (an earlier render, the narration before a voice change). | Yes. Delete a day's folder, or all of `History/`, to free its space. Going back to that version under **Versions** makes its files again. |
 
 A hidden `.slopify-project` file tells Slopify which project the folder holds and where its files went. Leave it there.
 
@@ -116,11 +116,11 @@ Use `--projects-dir <folder>` for another folder. The installer waits for runnin
 
 | Button | What it does |
 | --- | --- |
-| **Export everything** | Downloads one `.tar` file with every project and its files and history, your library, templates, schedules, Play drafts, fonts, settings and usage. Never provider keys. Keep Slopify running until your browser's download finishes. |
+| **Export everything** | Downloads one `.tar` file with every project and its files and versions, your prompts, templates, schedules, Create drafts, fonts, settings and usage. Never service keys. Keep Slopify running until your browser's download finishes. |
 | **Import a backup** | Adds a `.tar` (or `.zip`) backup to this install and replaces nothing. Projects already here are skipped, taken names arrive as "(imported)" and schedules arrive paused. Running projects must finish or pause first. Afterwards a summary lists what was added and skipped. |
 | **Clear leftover files** | See below. |
 
-After an import, enter your provider keys again in Settings → **Providers**. For daily automatic copies, see [Backups](Backups).
+After an import, enter your service keys again in Settings → **Keys & services**. For daily automatic copies, see [Backups](Backups).
 
 ## Free disk space
 
@@ -132,15 +132,15 @@ Deleted projects free their space when the trash removes them after 30 days, or
 
 ### Keep outputs only
 
-On a finished project, **Keep outputs only** deletes the working files it was made from (narration parts, subtitle timing, render settings) and keeps the video, shorts, the images they show, thumbnail, article, description, document and your uploads.
+On a finished project, **Keep outputs only** deletes the working files it was made from (narration parts, caption timing, video settings) and keeps the video, shorts, the images they show, thumbnail, article, description, document and your uploads.
 
 1. Find the project in the **Disk space** list. The button says how much it frees.
 2. Press **Keep outputs only**.
 3. Read the confirmation and press **Keep outputs only** again.
 
-If you change that project later (edit an image, a caption style or the narration, or re-render), Slopify has to make those files again first, which takes time and provider credits. The button is disabled until the project has finished, or when nothing is left to remove.
+If you change that project later (edit an image, a caption style or the narration, or make the video again), Slopify has to make those files again first, which takes time and service credits. The button is disabled until the project has finished, or when nothing is left to remove.
 
-A finished project's own page offers the same in its right rail: **Free space** with **Free 1.2 GB: keep the outputs, drop the working files** (see [Project Page](Project-Page#free-space)).
+A finished project's own page offers the same under **Edit settings** → **Versions**: **Free space** with **Free 1.2 GB** (see [Project Page](Project-Page#free-space)).
 
 ### Delete old versions and Clean up everything
 
@@ -160,7 +160,7 @@ Cleanup only looks inside `Projects`. It leaves `Backups` alone (only Slopify's
 
 ## Sample projects
 
-**Sample projects** lists the three bundled samples and whether each is in your projects, with **Open**. **Restore samples** adds back any that were deleted and replaces the others with the originals. Your own copies of them are not touched. See [First Launch and Welcome](First-Launch-and-Welcome#explore-the-samples).
+At the foot of **Disk space**, **Restore samples** puts the three bundled samples back: it adds back any that were deleted (the line beside it names them) and replaces the others with the originals. Your own copies of them are not touched. See [First Launch and Welcome](First-Launch-and-Welcome#explore-the-samples).
 
 ## Tips
 

package/dist/tutorials/YouTube-Description.md

@@ -2,7 +2,7 @@
 
 Slopify can write your video's YouTube description for you: a short summary, chapters at the narration's real times, hashtags, and a separate list of search tags. Each part has a Copy button and can be edited in place, and your edits survive when the description is written again.
 
-**Where to find it:** Play → **Outputs** row → **YouTube description**. On a finished project: the **YouTube** section (Description, Tags, Pinned comment and Other titles), and Edit project → **Prompts**.
+**Where to find it:** Create → **Extras** row → **YouTube description**. On a finished project: the **YouTube** part (Description, Tags, Pinned comment and Other titles), and **Edit settings** → **Extras**.
 
 ## What you get
 
@@ -19,19 +19,19 @@ Slopify lays out the description itself (summary, blank line, one chapter per li
 
 ## Turn it on
 
-1. On Play, open the **Outputs** row.
+1. On Create, open the **Extras** row.
 2. Tick **YouTube description**. It is greyed out, with "Needs narration", when the Narration row is off.
 3. Pick a **Description prompt**, or leave it on **Built-in**.
 4. Start the run.
 
-The description is written after the video's subtitle timing, beside the render, in one text-model call. The project language decides the language it is written in; see [Other-Languages](Other-Languages).
+The description is written once the captions are timed, while the video is put together, in one AI call. The project language decides the language it is written in; see [Other-Languages](Other-Languages).
 
 ## Options
 
 | Option | What it does | Default |
 |---|---|---|
-| **YouTube description** | Writes the description, chapters, hashtags and tags after subtitle timing. One text-model call. Needs narration. | Off |
-| **Description prompt** | The Library prompt the description is written from. | **Built-in** |
+| **YouTube description** | Writes the description, chapters, hashtags and tags once the captions are timed. One AI call. Needs narration. | Off |
+| **Description prompt** | Your Description prompt the description is written from. | **Built-in** |
 
 The **Built-in** prompt asks for:
 
@@ -40,34 +40,34 @@ The **Built-in** prompt asks for:
 - 3 to 5 hashtags, most specific last;
 - 15 to 25 tags, from broad to specific.
 
-To change the tone or add your own links, write a prompt of the kind **YouTube Description** in **Library → Prompts**. Each `{{keyword}}` in it becomes a field on Play. The prompt editor's starter button (see **Starter text** in its help) fills in the Built-in wording to start from. See [Prompts](Prompts).
+To change the tone or add your own links, write a prompt of the kind **YouTube Description** in **Prompts**. Each `{{keyword}}` in it becomes a field on Create. The prompt editor's **Start from an example** → **Slopify's own wording** fills in the wording Slopify uses, to start from. See [Prompts](Prompts).
 
 ## Read and copy it
 
-When the step has run, the project page's **YouTube** section shows four parts. A finished project with a written description opens on this section, so copying it is one press:
+When the step has run, the project page's **YouTube** part shows four pieces. A finished project with a written description opens on this section, so copying it is one press:
 
 - **Description**, with the Summary, Chapters and Hashtags, a character count such as `1,240 / 5000 characters`, and **Copy**.
 - **Tags**, shown as chips, with a count against YouTube's 500-character limit and **Copy**.
 - **Pinned comment**, below the tags, with **Copy**. YouTube pins comments only on a published video: once it is live, post the comment from your channel and choose **Pin** in its menu.
-- **Other titles**, below the pinned comment, with **Copy**. In Studio, press **A/B Testing** beside the title and add them next to the video's own title. Prepare upload lists them in its Title step with **Copy others**.
+- **Other titles**, below the pinned comment, with **Copy**. In Studio, press **A/B Testing** beside the title and add them next to the video's own title. Copy for YouTube Studio lists them in its Title step with **Copy others**.
 
 **Copy** on Description copies the whole description, placeholders filled in. **Copy** on Tags copies them comma-separated, ready to paste. A count over YouTube's limit turns red and says "over YouTube's limit".
 
 You can also run **Copy description** (`Shift+D`), **Copy tags** and **Copy pinned comment** from the command palette (`Ctrl+K`) while the project is open. The **YouTube description (.txt)** and **YouTube tags (.txt)** downloads are the text exactly as the page shows it: your edits, the fitted chapters and the filled links. See [Keyboard-Shortcuts-and-Command-Palette](Keyboard-Shortcuts-and-Command-Palette).
 
-While the stage is running the parts say "Written after the subtitle timing."; before it starts they say "Not written yet. It is made with the video."
+While the stage is running the parts say "Written once the captions are timed."; before it starts they say "Not written yet. It is made with the video."
 
 ## Edit a part
 
-1. In the project's YouTube section, press **Edit** beside Summary, Chapters, Hashtags, Tags, Pinned comment or Other titles.
+1. In the project's YouTube part, press **Edit** beside Summary, Chapters, Hashtags, Tags, Pinned comment or Other titles.
 2. Change the text and save.
 
-Your text is now marked **Your edit**. It is kept as yours:
+A line under it says it is your own text, kept when the description is written again:
 
-- When the description is written again, your part stays and "New generated version available." appears beside it with **Use it**, **Keep mine** and **View diff**.
-- **Use generated** goes back to the model's text at any time.
+- When the description is written again, your part stays and "*Part* written again. Yours stays until you choose." appears beside it with **Use the new one**, **Keep mine** and **Show the changes**.
+- **Use the written *part*** (for example **Use the written summary**) goes back to the AI's text at any time.
 
-Edits cost nothing and don't re-run anything.
+Edits cost nothing and make nothing again.
 
 ## Chapters follow YouTube's rules
 
@@ -87,19 +87,19 @@ Write a name in double braces, such as `{{Patreon}}` or `{{Discord}}`, in a desc
 
 Each channel has its own links:
 
-1. Open **Channels** → the project's channel → **Brand**.
+1. Open **Channels** → the project's channel → **Name and look**.
 2. Under **Channel links**, press **Add link**, type the name (for example `Patreon`) and the address, and press **Save channel**.
 
-A description takes the links of its project's channel. Names match without regard to case or extra spaces. A placeholder with no saved link stays as typed, is marked, and the YouTube section says "No link is saved for {{Name}}, so it stays as typed. Add it under Channel links on the channel's Brand tab."
+A description takes the links of its project's channel. Names match without regard to case or extra spaces. A placeholder with no saved link stays as typed, is marked, and the YouTube part says "No link is saved for {{Name}}, so it stays as typed. Add it under Channel links on the channel's Name and look tab."
 
-Links saved in **Settings → Channel links** before each channel had its own still fill the default channel's descriptions until you save that channel's Brand tab. See [Channels](Channels#channel-links).
+Links saved in **Settings → Channel links** before each channel had its own still fill the default channel's descriptions until you save that channel's Name and look tab. See [Channels](Channels#channel-links).
 
 ### Previous video
 
 `{{Previous video}}` is special: each project can have its own.
 
-1. In the project's YouTube section, paste the link under **Previous video for this project**.
-2. Press **Save links**.
+1. In the project's YouTube part, paste the link under **Previous episode**.
+2. Press **Save**.
 
 The project's link wins over a **Previous video** link in the channel's links. It changes only what is shown and copied, with no text-model call.
 
@@ -107,16 +107,16 @@ Because placeholders are filled when shown or copied, changing a channel's link
 
 ## Write it again, or turn it on later
 
-To write a description again, press **Write again** beside **Description** in the project's YouTube section, then confirm. Only this step runs. A description written before pinned comments and other titles existed shows neither until it is written again this way.
+To write a description again, press **Write the description again · 1 AI call** in the project's YouTube part, then confirm. Only this step runs. A description written before pinned comments and other titles existed shows neither until it is written again this way.
 
 To turn it on, or to change its prompt first:
 
-1. Open the project and press **Edit project**.
-2. Open **Prompts**. Tick **YouTube description** if it was off, and pick a **Description prompt**.
+1. Open the project and press **Edit settings**.
+2. Open **Extras**. Tick **YouTube description** if it was off, and pick a **Description prompt**.
 3. To replace a description that is already written, press **Write the description again after review**. **Keep the current description** cancels it.
-4. Save, then continue the run or start the rebuild review.
+4. Press **Save changes**, then make the outdated description again (the title row's next action, or **Choose what to make again**).
 
-Writing it again is one paid text-model call. The description you have now is replaced, except for parts you edited, which stay yours with the new text offered beside them.
+Writing it again is one paid AI call. The description you have now is replaced, except for parts you edited, which stay yours with the new text offered beside them.
 
 ## Limits
 
@@ -127,11 +127,11 @@ Writing it again is one paid text-model call. The description you have now is re
 | Hashtags | YouTube ignores every hashtag if a description has more than 15 |
 | Chapters | At least 3, first at 0:00, each at least 10 seconds |
 
-Slopify does not upload the description to YouTube. Paste it in YouTube Studio yourself, or use Prepare upload and the optional Studio extension; see [Publishing-to-YouTube](Publishing-to-YouTube).
+Slopify does not upload the description to YouTube. Paste it in YouTube Studio yourself, or use Copy for YouTube Studio and the optional Studio extension; see [Publishing-to-YouTube](Publishing-to-YouTube).
 
 ## Related pages
 
-- [Play-Outputs](Play-Outputs)
+- [Create: Extras](Create-Extras)
 - [Prompts](Prompts)
 - [Publishing-to-YouTube](Publishing-to-YouTube)
 - [Studio-Extension](Studio-Extension)

package/dist/tutorials/Your-First-Short.md

@@ -1,6 +1,6 @@
 # Your First Short
 
-The quickest way to see Slopify work: type a topic, press one button, and get a narrated, captioned 9:16 short of about a minute. Slopify picks the providers for you from what your computer already has.
+The quickest way to see Slopify work: type a topic, press one button, and get a narrated, captioned 9:16 short of about a minute. Slopify picks the services for you from what your computer already has.
 
 **Where to find it:** the first-run screen (**Welcome to Slopify**) → **3 · Make your first short** → **Make a 60-second short**. On a fresh install it opens by itself; its address is `http://127.0.0.1:6969/welcome`.
 
@@ -8,10 +8,10 @@ The quickest way to see Slopify work: type a topic, press one button, and get a
 
 | Part | Details |
 | --- | --- |
-| Script | About 150 words, written from your topic by a text model. No web research. |
-| Narration | Spoken by your voice provider, or by your computer's own voice when no voice key is saved. |
+| Script | About 150 words, written from your topic by an AI. No web research. |
+| Narration | Spoken by your voice service, or by your computer's own voice when no voice key is saved. |
 | Images | Four vertical images, one for each 15 seconds of the minute. |
-| Video | A 9:16 short with word-by-word captions and the title on top, rendered on your computer. |
+| Video | A 9:16 short with word-by-word captions and the title on top, put together on your computer. |
 | Not made | No thumbnail, no PDF, no YouTube description and no further shorts. |
 
 With the command-line tools it usually takes about five minutes.
@@ -24,36 +24,36 @@ You need three things. Slopify checks them when you press the button and tells y
 | --- | --- |
 | Text | Claude Code CLI (a Sonnet model when it has one), Codex CLI, Antigravity CLI, then an OpenRouter key. |
 | Images | Codex CLI, then an OpenAI, Google, fal.ai or Replicate key. |
-| Voice | Your first saved voice whose provider has a key. If none, the style's suggested OpenAI voice when an OpenAI key is saved. If there is no voice key at all, your computer's own voice (the **System voice**): macOS or Windows speech, or Piper, SVOX Pico, eSpeak NG or eSpeak on Linux. |
+| Voice | Your first saved voice whose voice service has a key. If none, the style's suggested OpenAI voice when an OpenAI key is saved. If there is no voice key at all, your computer's own voice (the **System voice**): macOS or Windows speech, or Piper, SVOX Pico, eSpeak NG or eSpeak on Linux. |
 
-Command-line tools can't speak, but you don't need a voice key to start: with none saved, the short is narrated by your computer's built-in voice, for free. It sounds robotic, so add a key when you want a better voice. With ElevenLabs, Cartesia or Inworld, also save a voice in Settings → **Voices**. See [the system voice](Providers-and-Keys#the-system-voice).
+Command-line tools can't speak, but you don't need a voice key to start: with none saved, the short is narrated by your computer's built-in voice, for free. It sounds robotic, so add a key when you want a better voice. An OpenAI key is the simplest: the suggested voices work with it right away. With ElevenLabs, Cartesia or Inworld, also save a voice in Settings → **Voices**. See [the system voice](Providers-and-Keys#the-system-voice).
 
 To set these up:
 
-1. Install and sign in to Claude Code, Codex or Antigravity CLI (see [AI CLIs](AI-CLIs)), or add keys in Settings → **Providers** (see [Providers and Keys](Providers-and-Keys)).
-2. Optional: add a voice key in Settings → **Providers**. An OpenAI key is the simplest: the suggested voice works with it right away.
-3. Back on the first-run screen, step **1 · What you have** shows which tools are ready and who will narrate.
+1. Install and sign in to Claude Code, Codex or Antigravity CLI (see [AI CLIs](AI-CLIs)), or add keys in Settings → **Keys & services** (see [Keys and Services](Providers-and-Keys)).
+2. Optional: add a voice key in Settings → **Keys & services**. An OpenAI key is the simplest: the suggested voice works with it right away.
+3. Back on the first-run screen, step 1, **What a short needs**, shows the Article, Narration and Images lines, each **Ready**, **No key** or **No voice saved** with its fix. Press **Check again** after installing a speech program.
 
 ## Make the short
 
 1. Open the first-run screen.
-2. On **2 · Pick a style**, press **Use this style** on one row:
+2. On step 2, **Pick a style**, press one row; it reads **Picked**:
    - **General**: a neutral explainer style, with the OpenAI voice `alloy` as its suggestion.
-   - **Sleep lore**, **True crime**, **History** or **Science explainers**: that starter pack's script prompt, image style and suggested voice.
-3. Go to **3 · Make your first short**. In **Topic**, type what the short is about, in a few words or a question (up to 200 characters). For example: `Why the sea glows at night`. A specific topic gives a sharper short than a broad one.
-4. Press **Make a 60-second short**. The status line says **Starting your short…**.
-5. Slopify creates the project and starts it. The step now says "Your short is being made." Press **Watch it being made** to open its page.
+   - **Sleep lore**, **True crime**, **History** or **Science explainers**: that starter template's script prompt, image style and suggested voice.
+3. Press **Next: Make your first short**. In **Topic**, type what the short is about, in a few words or a question (up to 200 characters). For example: `Why the sea glows at night`. A specific topic gives a sharper short than a broad one.
+4. Press **Make a 60-second short** in the bar at the bottom of the window. The status line says **Starting your short…**.
+5. Slopify creates the project and starts it. The step now says "Your short is being made." Press **Watch it being made** in the bar to open its page.
 
 Pressing the button twice, or retrying after a dropped connection, opens the same project instead of starting a second one.
 
 ## What Slopify sets up for you
 
 - **The project.** Its title is your topic, with a capital first letter. Its format is 9:16.
-- **Library prompts.** The style's script and vertical-scene prompts are added to your Library (for General: **Starter · 60-second short** and **Starter · Vertical scene**). If you already have a prompt with that name and different text, the new one comes in as `<name> (2)`. Reusing them later changes nothing.
-- **A saved voice.** The style's suggested OpenAI voice is added to Settings → **Voices** (for General: **Starter narrator**), unless you already have one with that voice. When the computer's own voice narrates, it is saved there too, named `<voice> (computer voice)`, so Play offers it later.
+- **Prompts.** The style's script and vertical-scene prompts are added to your **Prompts** (for General: **Starter · 60-second short** and **Starter · Vertical scene**). If you already have a prompt with that name and different text, the new one comes in as `<name> (2)`. Reusing them later changes nothing.
+- **A saved voice.** The style's suggested OpenAI voice is added to Settings → **Voices** (for General: **Starter narrator**), unless you already have one with that voice. When the computer's own voice narrates, it is saved there too, named `<voice> (computer voice)`, so Create offers it later.
 - **Settings.** Captions at the bottom, a slow zoom or pan on each image, half a second of silence at each end, and the volume levelled as in your Settings.
 
-The pack's Play template is not added this way. To get it, press **Add to library** on the pack's row in step 2, or use Library → **Templates** → **Add pack**. **Make the full video on this topic** (below) also adds it.
+The style's starter template is not added this way. To get it, use **Templates** → **Add starter templates**. **Make the full video on this topic** (below) also adds it.
 
 ## Watch it being made
 
@@ -62,9 +62,9 @@ The project page shows each step as it runs:
 1. **Article**: the script is written.
 2. **Narration**: the script is spoken.
 3. **Images**: four vertical images are drawn.
-4. **Video**: the words are timed against the narration and the short is rendered with word-by-word captions and the title on top.
+4. **Video**: the words are timed against the narration and the short is put together with word-by-word captions and the title on top.
 
-Open the **Live** tab to see the steps, the script as it is written, the images as they land and the narration's waveform. Each running step says its time left. While it runs, Home also lists it under **Running now**, and the sidebar shows how many runs are going.
+Open **Progress** at the top of the status list to see the script as it is written, the images as they land and the narration's waveform. Each running step says its time left. While it runs, Home also lists it under **Running**, and the rail shows how many runs are going.
 
 See [Project Page](Project-Page) for everything else on this page.
 
@@ -72,54 +72,54 @@ See [Project Page](Project-Page) for everything else on this page.
 
 1. When the run is done, open **Video** on the project page.
 2. Play the short in Slopify's own player. See [Project Page](Project-Page#the-players).
-3. Press **Download** and pick **Video (.mp4)**, or press **Open folder** to see the file on your computer.
+3. Press **Download video (.mp4)**, or press **Open folder** to see the file on your computer.
 
 The file is also in the project's folder under your Projects folder (see [Where Your Files Live](Where-Your-Files-Live)).
 
 ## What it costs
 
-- **Narration** uses your voice provider's credit, billed per character of the roughly 150-word script. The computer's own voice costs nothing.
-- **Text and images** through a command-line tool count toward that tool's plan, not a per-call bill. Through API keys, they are billed by that provider.
-- The project's **Cost** tab shows what each step cost. See [Costs and Run Cost](Costs-and-Run-Cost).
+- **Narration** uses your voice service's credit, billed per character of the roughly 150-word script. The computer's own voice costs nothing.
+- **Text and images** through a command-line tool count toward that tool's plan, not a per-call bill. Through API keys, they are billed by that service.
+- The project's cost line, with **See the breakdown**, shows what each step cost. See [Costs and Run Cost](Costs-and-Run-Cost).
 
 ## If it refuses to start
 
-The message names what is missing and where to fix it:
+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." and the lines under the topic say what is missing, each with the button that fixes it. They are the same lines as step 1:
 
-| Message starts with | Fix |
+| Line says | Fix |
 | --- | --- |
-| No text model is ready. | Install Claude Code, Codex or Antigravity CLI and sign in, or add an OpenRouter key in Settings → Providers. |
-| No image model is ready. | Install Codex CLI and sign in, or add an OpenAI, Google, fal.ai or Replicate key in Settings → Providers. |
-| No voice is ready to narrate the short | Install `espeak-ng` (Linux) so the computer's voice can narrate, or add an OpenAI, ElevenLabs, Cartesia or Inworld key in Settings → Providers. |
-| Your voice provider has no saved voice yet. | Add a voice in Settings → Voices, then try again. |
+| Nothing can write the article yet. | Sign in to Claude Code, Codex or Antigravity, or press **Add a key for writing** (OpenRouter). |
+| Nothing can make the images yet. | Press **Add an image key** (OpenAI, Google, fal.ai or Replicate), or sign in to Codex. |
+| Nothing can read the article aloud yet. | Press **Add a voice key** (OpenAI works at once), or on Linux install `espeak-ng` and press **Check again**. |
+| *Voice service* has a key but no voice saved yet. | Press **Save a voice** (Settings → Voices), or **Add an OpenAI key**. |
 | Slopify can't list the models on this machine right now. | Restart Slopify and try again. |
 
 If the run fails later, the project page and Home's **Needs you** say which step failed and offer the fix. See [Recovery and Retries](Recovery-and-Retries).
 
 ## Make the full video next
 
-When the short is done, the project's next action is **Make the full video on this topic**. It opens Play set up for a long video: the same topic and title, the starter pack's Play template (added to your Library if it wasn't yet), and the text, image and voice providers the short used, since those are known to work on your computer. Nothing starts until you press **Start run**. See [Play Overview](Play-Overview).
+When the short is done, the project's next action is **Make the full video on this topic**. It opens Create set up for a long video: the same topic and title, the starter template (added to Templates if it wasn't yet), and the writing, image and voice services the short used, since those are known to work on your computer. Nothing starts until you press **Make the video**. See [Create Overview](Create-Overview).
 
 ## Change the short afterwards
 
-It is a normal project: you can edit the script, change an image, pick another voice or caption style, and Slopify rebuilds only what the change affects. See [Editing a Project](Editing-a-Project) and [Video Editing](Video-Editing).
+It is a normal project: you can edit the script, change an image, pick another voice or caption style, and Slopify makes again only what the change affects. See [Editing a Project](Editing-a-Project) and [Video Editing](Video-Editing).
 
 ## Next steps
 
-- Make a long video with more control: [Play Overview](Play-Overview).
+- Make a long video with more control: [Create Overview](Create-Overview).
 - Cut shorts from a long video automatically: [Shorts](Shorts).
-- Reuse the style: add the starter pack and pick its template on Play ([Templates](Templates)).
+- Reuse the style: add its starter template (**Templates** → **Add starter templates**) and pick it under **Start from** on Create ([Templates](Templates)).
 - Let Claude Code or Codex look after your runs, fix failures and answer reviews: [Agents (MCP)](Agents-MCP).
 
 ## Tips
 
-- The first-run screen disappears once you have a real project. Your later shorts are made from Play, or from Shorts on a long video.
+- The first-run screen disappears once you have a real project. Your later shorts are made from Create, or from Shorts on a long video.
 - Want to try without spending anything first? Open a sample project from the first-run screen ([First Launch and Welcome](First-Launch-and-Welcome#explore-the-samples)).
 
 ## Related pages
 
 - [First Launch and Welcome](First-Launch-and-Welcome)
-- [Providers and Keys](Providers-and-Keys)
+- [Keys and Services](Providers-and-Keys)
 - [AI CLIs](AI-CLIs)
 - [Project Page](Project-Page)
 - [Shorts](Shorts)

package/dist/tutorials/_Sidebar.md

@@ -12,22 +12,22 @@
 - [Updating and patch notes](Updating-and-Patch-Notes)
 - [Uninstalling and moving](Uninstalling-and-Moving)
 
-**Providers**
-- [Providers and keys](Providers-and-Keys)
+**Services and keys**
+- [Keys and services](Providers-and-Keys)
 - [AI CLIs](AI-CLIs)
 - [Models](Models)
 - [Costs and run cost](Costs-and-Run-Cost)
 
 **Making a video**
-- [Play overview](Play-Overview)
-- [Title and article](Play-Title-and-Article)
-- [Narration](Play-Narration)
-- [Images](Play-Images)
-- [Video and style](Play-Video-and-Style)
-- [Outputs](Play-Outputs)
-- [Reviews and checkpoints](Reviews-and-Checkpoints)
+- [Create overview](Create-Overview)
+- [Article](Create-Article)
+- [Narration](Create-Narration)
+- [Images](Create-Images)
+- [Video and style](Create-Video-and-Style)
+- [Extras](Create-Extras)
+- [Pauses and checks](Reviews-and-Checkpoints)
 
-**Formats and outputs**
+**Formats and extras**
 - [Multiple voices](Multiple-Voices)
 - [Other languages](Other-Languages)
 - [Shorts](Shorts)
@@ -48,7 +48,7 @@
 
 **Automation**
 - [Templates](Templates)
-- [Template studio](Template-Studio)
+- [Edit template](Template-Studio)
 - [Schedules](Schedules)
 - [Calendar](Calendar)
 - [Notifications](Notifications)
@@ -58,15 +58,15 @@
 
 **Channels**
 - [Channels](Channels)
-- [Cast library](Cast-Library)
+- [Cast](Cast-Library)
 
-**Library**
-- [Library overview](Library-Overview)
+**Prompts and templates**
+- [Prompts and templates](Prompts-and-Templates)
 - [Prompts](Prompts)
 - [Keywords Slopify fills](Keywords-Slopify-Fills)
 - [Intros and outros](Intros-and-Outros)
 - [Aliases and glossary](Narration-Aliases-and-Glossary)
-- [Document themes](Document-Themes)
+- [PDF looks](Document-Themes)
 
 **Reference**
 - [Settings reference](Settings-Reference)