@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/tutorials/Create-Overview.md

@@ -0,0 +1,244 @@
+# Create Overview
+
+Create is the screen where you set up something new and make it: a video, an article, an audiobook, a podcast episode or a set of images. You pick what you are making, what it starts from and what it is about, then press **Make the video**. You get a project that writes the article, records the narration, draws the images and puts the video together, plus any extras you switched on.
+
+**Where to find it:** **Create** at the top of the rail (in the middle of the phone's bottom bar), `Ctrl+K` → **Create a video**, or press `C` anywhere. **Make a video** on a prompt, a template or a channel opens Create with it picked.
+
+## How Create is laid out
+
+Create is one screen, read from top to bottom:
+
+1. **What are you making?** Five cards: **Video** (narration over images), **Article** (written text, also as a PDF), **Audiobook** (a text read aloud by a narrator), **Podcast** (a conversation between speakers) and **Images** (pictures from your prompts).
+2. **Start from**: a blank one (**A blank video**, **A blank article** and so on) or one of your templates. With two or more channels, **For** beside it picks the channel.
+3. **What's the video about?**: the topic. The question follows what you make ("What's the episode about?", "What are the images of?"). **Another topic** adds more videos made the same way.
+4. **The rows**: one line each for **Keywords**, **Article**, **Narration**, **Images**, **Video and style**, **Extras**, **Pauses and checks** and **Channel**. Each says in one sentence what the run will do. Under a row's name, **From History starter** (or your template's name) means it is as the template set it, and **Changed here** that you changed it on this screen.
+5. **A picture instead?**: **Design a poster** and **Edit a picture** open the design editor.
+6. **The rail on the right**: how many videos, the expected length, the estimated cost, the **Make the video** button with the next thing to fix under it, **See everything this run will do**, and the style preview.
+
+The page header holds **Save as template** and **Draft:** with the draft's name.
+
+Nothing is made until you press **Make the video**. Every change is saved to the current draft as you make it.
+
+### Rows open one at a time
+
+**Change** opens a row's editor under its line; **Close** (for example **Close narration**) folds it again. Opening one row folds the others. A row that needs something says what in red and its button reads **Fix**. When you open a draft, the first row that needs something opens by itself.
+
+A row with nothing to set for this video is left out: **Keywords** shows only when a prompt asks for a keyword besides the topic or the title is a pattern such as `History: {{Topic}}`, **Channel** only when you have two or more channels, and **Narration** not while the article is **No text**. What you are making decides the rest:
+
+| You make | Rows |
+| --- | --- |
+| **Video** | Keywords, Article, Narration, Images, Video and style, Extras, Pauses and checks, Channel |
+| **Article** | Keywords, Article, Extras, Pauses and checks, Channel |
+| **Audiobook** or **Podcast** | Keywords, Article, Narration, **Sound and captions** (the Video and style row of spoken work), Extras, Pauses and checks, Channel |
+| **Images** | Keywords, Images, **Shape and look**, Pauses and checks, Channel |
+
+For anything but a video, the thumbnail, YouTube description, shorts and posts fold away under **Publishing extras** in the Extras row. A row that is open or needs fixing stays in view whatever you make, so nothing that stops the run is ever out of reach.
+
+## Make a video
+
+1. Open Create.
+2. Optional: pick a template under **Start from**. Picking one opens a fresh draft made from it, and the topic you already typed comes along.
+3. Type what the video is about.
+4. Look over the rows. If the line under **Make the video** names something to fix, press it: it opens the row and the field that needs it.
+5. Check the estimated cost in the rail.
+6. Press **Make the video** (or **Queue 3 videos** if you added more topics).
+
+Slopify opens the new project as soon as the run is created. The button's name follows what you make: **Make the article**, **Make the audiobook**, **Make the podcast**, **Make the images**.
+
+## Start from a template
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Start from** | Starts from a saved template: its prompts, voice, images, style, extras and pauses. Picking one opens a fresh draft made from it and carries the topic you typed. | **A blank video** (or blank article, audiobook, episode, image set) |
+
+Make templates with **Save as template** (below), or add the starter templates under **Templates** → **Add starter templates**. See [Templates](Templates).
+
+## The topic and the title
+
+The topic is the video's subject in your own words, such as "The Library of Alexandria". With a blank start it is also the video's title, shown on the project and in Projects. Up to 200 characters.
+
+A template's title can be a pattern with a keyword in double braces, for example `History: {{Topic}}`:
+
+- The field then asks for **Topic**, and shows the title it makes under it (**Title will be: History: The Lost City**).
+- The pattern itself is in the **Keywords** row as **Title pattern**, where you can change it.
+- Each keyword the title names is typed once per video. Templates save it empty.
+
+When the video goes to YouTube, the title is also its YouTube title unless one is written for it, so YouTube's limit is said under the field (it never stops the run).
+
+### Already made on this channel
+
+As you type, a line under the topic says when the channel already has a video on it, using the same near-duplicate rule as [schedules](Schedules#how-generation-works):
+
+- `This channel already has a video on this: "<title>" (in Projects). Make it anyway if you want another take.`
+- That the channel already uploaded a video with that title, from the channel's **Titles to avoid**.
+
+It never stops you; it is there so you don't make the same video twice by accident.
+
+## Keywords
+
+A keyword is a value that a picked prompt or the title asks for with `{{name}}`. You type it once, and it fills every place that names it. The line under each keyword lists where it is used.
+
+The topic keywords (the ones the title names) are typed at the top. Any others are in the **Keywords** row, whose line reads, for example, `Asks for: Era, Audience.`
+
+| Option | What it does | Limit |
+| --- | --- | --- |
+| Each keyword | Fills every `{{name}}` in the title and the picked prompts. A keyword the title does not name keeps its value in a template. | 200 characters, one line |
+
+Every keyword must be filled before the run can start. Some keywords are filled by Slopify itself; see [Keywords Slopify fills](Keywords-Slopify-Fills).
+
+## More videos from the same setup
+
+**Another topic** queues more videos with everything else the same. Only the topic and keywords differ.
+
+1. Press **Another topic** under the topic.
+2. Type the next topic and press **Add**. Add as many as you like, then press **Done** or `Esc`.
+3. Each extra video shows as a chip. Press its name to open a side panel where you can change that video's **Title** and keywords. Everything else comes from this setup.
+4. Press the remove button on a chip to drop that video.
+
+One press makes at most 50 videos: this one and 49 more.
+
+### One after another
+
+With more than one video, the rail shows **One after another** (on by default):
+
+| One after another | What happens | The button reads |
+| --- | --- | --- |
+| **On** | The videos run one after another, in order, each starting when the one before finishes. | **Queue 3 videos** |
+| **Off** | They all start at once, as separate runs. | **Make 3 videos** |
+
+All at once finishes sooner while the steps wait on services (research, narration, images), but the videos are put together on your computer's processor at the same time, so each takes longer, and Claude or Codex plan limits are reached sooner (Slopify waits and goes on when they reset).
+
+### The video queue
+
+Videos queued together wait their turn. Home and the Calendar list them under **Waiting to start**, with **Earlier**, **Later** and **Remove** on each. Projects has a **Queued** filter, and the page of a project in the queue says how many videos wait to start and opens the list. Pausing a project holds the queue; when one fails or is canceled, the next one starts.
+
+## Drafts
+
+Create saves every change to the current draft by itself. **Draft:** in the page header names the draft and opens the list of drafts:
+
+- The top line says **Saved. Every change is saved as you go.**, **Saving…**, **Not saved yet**, **Couldn't save** or **Changed in another tab**.
+- **New draft** starts an empty draft and keeps the current one in the list.
+- **Saved drafts** lists the others with their last change; press one to open it, or its delete button to delete it. A deleted draft is gone for good; it does not go to the trash.
+- If saving fails, **Couldn't save** appears beside the button with **Retry**.
+
+### When a draft was changed elsewhere
+
+If the same draft is open in another tab and was saved there, the header says **Changed in another tab.** with two buttons:
+
+| Button | What it does |
+| --- | --- |
+| **Reload saved draft** | Shows the version saved elsewhere and drops your unsaved change. |
+| **Save as a new draft** | Keeps your version as a separate draft and leaves the other one alone. |
+
+## The rows at a glance
+
+| Row | What it holds | Details |
+| --- | --- | --- |
+| **Keywords** | The title pattern and every keyword besides the topic | This page |
+| **Article** | Where the text comes from, the article prompt, **Written by** (service, model, thinking), research and the language | [Article](Create-Article) |
+| **Narration** | Where the narration comes from, **Read by** (service, model, voice), a sample, **Speakers**, and **More narration settings** (splitting, intro, outro, preparation, pronunciation, tables and figures) | [Narration](Create-Narration) |
+| **Images** | Where the images come from, **Images by** (service, model), the image styles and counts, the establishing image, more images for long videos, scenes from the article | [Images](Create-Images) |
+| **Video and style** | Video on or off, frame format, captions, **Images and cuts**, **Look**, ambient sound and **Sound polish** | [Video and style](Create-Video-and-Style) |
+| **Extras** | Thumbnail, YouTube description, shorts, posts to other sites and the PDF | [Extras](Create-Extras) |
+| **Pauses and checks** | Where the run pauses for your approval, and whether an AI checks the results | [Pauses and checks](Reviews-and-Checkpoints) |
+| **Channel** | Whether the channel's brand kit fills the defaults | [Channel row](#channel-row) |
+
+## Channel row
+
+The channel itself is picked with **For** beside **Start from**, shown when you have two or more channels. A fresh draft starts in the channel Home, Projects and the Calendar are showing.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **For** | The channel this video belongs to. Its brand kit fills what these settings leave at their default, and its cast goes with the images. | The template's channel, or the channel you are showing |
+| **Use the channel's brand kit** | Its caption font, intro, outro, PDF look and sounds fill what these settings leave at their default. What you set on Create wins. Off takes none of it; the cast still applies. | On |
+
+**Open <channel>** goes to the channel's page. The language is in the [Article](Create-Article#language) row. For the cast, see [Cast](Cast-Library); for the brand kit, [Channels](Channels).
+
+## The rail
+
+### Expected length
+
+**Expected length: about 20 min · 3,000 words**, with **Change** to type **Words per video**. It feeds the estimate and how many images **More images for long videos** adds; the article prompt decides the real length, and once the article is written its real length is used. About 150 words is one minute of narration. It shows while the article is written for you.
+
+| Option | Default | Range |
+| --- | --- | --- |
+| **Words per video** | 1500, or what the template sets | 1 to 100,000 |
+
+### Estimated cost
+
+What the services are likely to charge for this run, in US dollars, from their published prices. Actual usage can differ, and the estimate does not cap spending. It reads **Estimated cost: shown once nothing is missing.** until every row is ready.
+
+- The total shows as **Estimated total** (a low to high range when it can vary). If some prices are unknown, it shows **Known subtotal** and how many stage charges have unavailable pricing.
+- **Cost by stage** folds out the price of each stage, what each assumes and the date the price catalogue was checked. With several videos, the rows show combined costs.
+- Steps run through a tool you are signed in to (such as Claude Code or Codex) show **$0 on your plan**, with the approximate API price beside them for comparison, and how much of the plan's limits the run would use.
+
+The estimate is checked again by itself a moment after you stop typing. See [Costs and Run Cost](Costs-and-Run-Cost).
+
+### The Make button
+
+| Label | When |
+| --- | --- |
+| **Make the video** | One video (or **Make the article**, **Make the audiobook**, **Make the podcast**, **Make the images**) |
+| **Queue 3 videos** / **Make 3 videos** | You added more topics, with **One after another** on or off |
+| **Starting…** | The start is being sent |
+| **Check whether it started** | Slopify didn't confirm the last start. Press it to find out before starting again. |
+
+The button stays an outline until the run can start. The line under it names the first thing to do, as a button that goes there (for example **Type what the video is about first**), or says what it waits for (**Wait for the uploads to finish first**, **Checking your setup and the estimate…**).
+
+### See everything this run will do
+
+Opens a side panel with every setting of the run in words, row by row, each with its **Change** link; what must be fixed before you can start; the topic and title; and **The prompts as they will be sent**, each prompt exactly as it goes out with its keywords filled in. `Ctrl+Enter` anywhere on Create opens it too.
+
+### Style preview
+
+When the video is made from images, the rail's last line names the caption style (for example **Captions: Barlow Regular 44, bottom**) with **Watch a 6-second preview**. It opens a dialog that puts six seconds of the bundled sample together with your captions, Look and motion, on this computer at no cost. See [Video and style](Create-Video-and-Style#style-preview).
+
+## Save as template
+
+**Save as template** in the page header keeps this setup so you can start the next video from it.
+
+1. Press **Save as template**.
+2. Type a **Template name** (up to 120 characters). This is the name it is listed under on Create and Templates.
+3. Read what is left out, then press **Save template**.
+
+What a template keeps and leaves out:
+
+- Keywords the title names (like `{{Topic}}`) are saved empty. The dialog names each one.
+- Other keywords (a word count, a style) keep their values.
+- The other videos you added with **Another topic** are not saved.
+- The template belongs to the draft's channel.
+
+A project's settings can be saved as a template too, from its **More** menu. See [Templates](Templates).
+
+## Command palette
+
+Every Create action is in the command palette (`Ctrl+K`), under **Create**:
+
+| Command | What it does |
+| --- | --- |
+| **Make the video** / **Queue 3 videos** | Starts, or opens the row that holds it back |
+| **Add another topic** | Opens the Another topic field |
+| **Save as template** | Opens the Save as template dialog |
+| **See everything this run will do** (`Ctrl+Enter`) | Opens the side panel |
+| **Pick what to start from** | Moves to the Start from picker |
+| **Change article**, **Change narration** and one per row | Opens that row and scrolls to it |
+
+## Tips
+
+- A long video on the same topic as a finished short is one press away: **Make the full video on this topic** on the short's project page opens Create set up for it. See [Your First Short](Your-First-Short#make-the-full-video-next).
+- Start from a template and change only the rows you need. The row lines tell you what each one will do without opening it.
+- Use a title pattern and **Another topic** to queue a series in one go.
+- If a template names a prompt you have since deleted, its row asks you to pick another.
+
+## Related pages
+
+- [Your First Short](Your-First-Short)
+- [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)
+- [Templates](Templates)
+- [Costs and Run Cost](Costs-and-Run-Cost)
+- [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette)

package/dist/tutorials/Create-Video-and-Style.md

@@ -0,0 +1,144 @@
+# Create: Video and Style
+
+The **Video and style** row decides how your images become a video: the frame shape, the captions, how long each image stays on screen and how it moves and cuts, the Look over the picture, an optional ambient sound and the polish on the narration's sound. The video is put together on this computer, so none of this costs service money except **Animate images**. A six-second style preview shows your choices on the bundled sample.
+
+**Where to find it:** Create → **Video and style** row → **Change**. For an audiobook or podcast the row is called **Sound and captions**, and for a set of images **Shape and look**. After the run, the same controls are in the project's **Edit settings**; see [Video Editing](Video-Editing).
+
+## Choose whether to make a video
+
+The row starts with a **Video** switch:
+
+| Choice | What happens | Cost |
+| --- | --- | --- |
+| **On (free)** (default) | Puts the slideshow video together on this computer from the images and narration. | No service money, only time |
+| **Off (sound only)** | No video. With narration on, you get the narration as one audio file (a WAV with the intro, the article, the outro and the gaps between them). Without narration, each finished part downloads on its own. | None |
+
+**On** needs images, so the video is off while Images is **None**. The line under the switch says what you will get: "The narration over the images, put together on this computer · free.", "Sound only: the narration as one audio file." or "Each finished stage downloads on its own."
+
+## Frame format
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Frame format** | **Landscape** (16:9, for YouTube and screens), **Portrait** (9:16, for shorts and phones) or **Square** (1:1, for feeds). The images are drawn in this shape and the captions placed for it. Shorts are always portrait. | Landscape |
+
+## Captions
+
+Captions are timed from your narration on this computer, with no paid service. The first English captions download the speech model chosen in Settings → Production defaults → **Caption timing model** (378 MB unless changed). They need narration.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **Captions** | **Off** makes none. **Caption files only (.srt + .vtt)** gives you files to upload beside the video. **Show captions in the video** draws them into the picture and also makes the files; it needs the video on. | Off |
+| **Caption font** | The typeface of captions shown in the video and of chapter cards: the bundled **Barlow**, the fonts on this computer, or a font you uploaded. A sample line shows each one. | Barlow |
+| **Upload font (.ttf or .otf)** | Adds your own font, right here in the caption font picker. Uploaded fonts stay available to every project and to a channel's brand kit. | |
+| **Caption size** | How big captions in the video are. Larger is easier to read on phones but covers more of the picture. Once changed, it says **Changed · default 48** with **Reset**. | 48; 16 to 120, whole numbers |
+| **Caption position** | Where captions in the video sit: **Top**, **Upper-middle**, **Center**, **Lower-middle** or **Bottom**. Move them up when the pictures have important detail near the bottom. | Bottom |
+| **Preview sentence** | The words the style preview's captions show. Only the preview shows it; real captions come from the narration. | "Every story begins with a word." |
+
+Font, size and position show only while captions are shown in the video: with caption files only (or no video) they are left out, since players style `.srt` and `.vtt` files themselves. The channel's brand kit can fill the caption font when you leave it at the default.
+
+### Show captions in the video
+
+1. Make sure Narration is not **Off** and Video is **Make the video**.
+2. Set **Captions** to **Show captions in the video**.
+3. Pick a **Caption font**, or press **Upload font (.ttf or .otf)** and pick a file. Wait for the upload to finish; the run cannot start during it.
+4. Set **Caption size** and **Caption position**.
+5. Press **Watch a 6-second preview** in the rail.
+
+If a saved font is missing (for example after a reinstall), the picker says so: choose another font or upload it again.
+
+After the run, you can fix a misheard word or nudge a caption's timing on the project page. See [Video Editing](Video-Editing).
+
+## Images and cuts
+
+**Images and cuts** is the part of the row under the captions.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **Seconds per image** | How long each image stays on screen. When cuts follow the narration, it is the target and a cut waits for a sentence end. When the images run out they start again. | 15; 1 to 600 |
+| **Zoom (%)** | How far each image zooms in or out over its time on screen. 0 keeps images still. | 22.5; 0 to 50 |
+| **Motion** | How each image moves: **Zoom in and out**, **Pan across**, **Mix of both** (by turns) or **Still**. A mix keeps a long video watchable. | Zoom in and out |
+| **Cuts** | **Every N seconds** holds each image for Seconds per image. **Follow the narration** cuts in the pause after a sentence, as close to that length as the sentences allow (never under 40% of it), and starts a new image at every chapter. | Follow the narration for new projects |
+
+**Follow the narration** needs word timing, so it works in English and the languages that have it. For a language without word timing, **Cuts** stays on **Every N seconds** and a note under it says why. See [Other Languages](Other-Languages).
+
+Turning on **More images for long videos** in the Images row switches **Motion** from Zoom to **Mix of both**. See [Images](Create-Images#more-images-for-long-videos).
+
+## The Look
+
+**Look** is a fold in the row. Folded, its line lists what is on (for example **Crossfade 2 s · Warm fantasy · Fog · Vignette**). Everything in it is drawn on this computer at no cost; only animated images are charged, by the image service.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **Transition** | How one image hands over to the next: **Cut**, **Crossfade**, **Fade through black**, **Slide** or **Wipe**. The change is centred on the cut and takes the length you pick, so the video stays exactly as long as its narration. | Cut; length 0.6 s (0.2, 0.4, 0.6, 0.8, 1, 1.2, 1.5 or 2 s) |
+| **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 for an older, filmic feel: **Subtle** or **Strong**. | Off |
+| **Atmosphere** | An overlay Slopify draws itself: rising **Embers**, drifting **Dust**, or low **Fog** along the bottom of the frame. Nothing is downloaded and no service is called. | 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 service (fal.ai or Replicate). **Chapter openers** animates the first image of each chapter (needs narration); **Every Nth image** animates every 2nd to 10th. Pick the image-to-video model in the box beside it. Each clip is one paid call, shown in the estimate. An image that cannot be animated stays still. | Off |
+
+### Animate some images
+
+1. Make sure the Images row uses fal.ai or Replicate. Other services have no image-to-video models, and the Look says so.
+2. Open **Look** and set **Animate images** to **Chapter openers** or **Every Nth image**.
+3. For **Every Nth image**, pick how often (every 2 to every 10).
+4. Pick the image-to-video model. The run cannot start until one is picked.
+5. Check the added cost in the estimate.
+
+## Ambient sound
+
+An optional sound of rain, a fireplace, wind or your own audio file, played quietly under the whole narration of the long video. It dips while the narrator speaks, including under the intro and outro. It is shown while both the video and the narration are on.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **Ambient sound** | **The channel's (brand kit)** uses whatever the channel's kit says, which may be nothing. **None** plays nothing, whatever the channel has. **Rain**, **Fireplace** and **Wind** are made on this computer, so nothing is downloaded and the same settings always sound the same. **My own file** uploads an audio file, looped if shorter than the video. | The channel's (brand kit) |
+| **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 steps of 0.5 |
+| **Tail after the narration (seconds)** | How long it keeps playing, fading out, after the narration ends. It plays over the silence already at the end; a tail longer than **Silence at start and end** makes the video that much longer. | 6; 0 to 30 in steps of 0.5 |
+
+Only the long video gets it: shorts keep their own background music, and the sound-only WAV stays the narration alone. It costs no service calls. A template with **My own file** cannot run on a schedule, because the file has to be attached again on Create; pick a built-in sound for scheduled runs. A channel's brand kit can only hold the three built-in sounds.
+
+## Sound polish
+
+**Sound polish** is a fold at the end of the row. Its line says what is on (for example **Volume levelled**). It shows while there is narration.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Pause between sentences (seconds)**, **Pause between paragraphs (seconds)** | The least quiet after each sentence and each paragraph. | 0.4 and 0 |
+| **Soften breaths** | Turns the audible breaths between sentences down. Words and timing stay the same. | Off |
+| **Soften S sounds** | Takes the sharp edge off s and sh sounds; very light, the voice keeps its brightness. | Off |
+| **Level each sentence** | Holds each sentence to the ones around it, so no line jumps out or drops away. Needs **Level the volume**. | Off |
+| **Level the volume**, **Video volume**, **Audio files volume** | Brings every narration piece to one loudness and sets the finished files to a target loudness. | On; 0 dB and 0 dB |
+| **Silence at start and end (seconds)**, **Silence between segments (seconds)** | Quiet before and after the narration, and between the intro, the article and the outro. | 2, and the Settings value |
+
+The pauses, levelling and silences shape the narration, so they are described in full on [Narration](Create-Narration#pauses-between-sentences-and-paragraphs).
+
+## Style preview
+
+**Watch a 6-second preview** in the rail opens **Preview with your captions and look**: six seconds put together on this computer by the real video renderer, with your captions, Look and motion. It plays the bundled sample project's real narration over three of its pictures, two seconds each, so a transition and a chapter card both show, and the captions are timed to the narration's words, as in a real video. It plays with sound, and costs nothing.
+
+The pictures are the sample's (in your frame shape), unless there is something closer to your video: your uploaded establishing image, or else a picture of the cast member the title names (or the first cast member with a picture). The line beside the button names the caption settings. **Make the preview again** makes a fresh one after you change a setting. If the caption settings are invalid, it says "Fix the caption settings to render the preview."
+
+The preview's captions show the **Preview sentence**. Left at the sample sentence (or empty), they are the sample narration's own words; any other text is spread over the stretches where the narration speaks. It never reaches the video.
+
+The same preview is in a project's **Edit settings** while its captions are open. Shorts have their own [Shorts preview](Shorts#shorts-preview).
+
+## What the row says
+
+Folded, the row reads like `Landscape 16:9, a new image at each sentence, a 2 s crossfade, a subtle vignette, a warm fantasy grade and drifting fog, captions in Barlow Regular.`: the frame, the cuts, the Look and the captions, or "No video: sound only" and "no captions".
+
+## Tips
+
+- Keep **Seconds per image** near the length of a few sentences (10 to 20 s) when cuts follow the narration.
+- Try one Look setting at a time and watch the preview; they stack.
+- Everything except **Animate images** only costs time on this computer, so you can change the Look later in **Edit settings** and make the video again for free.
+
+## Related pages
+
+- [Create Overview](Create-Overview)
+- [Images](Create-Images)
+- [Narration](Create-Narration)
+- [Video Editing](Video-Editing)
+- [Channels](Channels)
+- [Other Languages](Other-Languages)
+- [Schedules](Schedules)

package/dist/tutorials/Docker.md

@@ -36,7 +36,7 @@ Running the same command again with nothing changed does nothing, apart from sta
 | Image | `ghcr.io/gentbajko/slopify:<version>`, pinned to the version of the installer you ran. It runs as a non-root user and already contains ffmpeg, the caption model and eSpeak NG, so the [System voice](Providers-and-Keys#the-system-voice) can narrate with no key. A healthcheck asks the app whether it is up. |
 | Compose file | Copied to `~/.local/share/slopify/docker/slopify/` with a private `.env` beside it. One service, `slopify`, with `restart: unless-stopped`. |
 | Port | `127.0.0.1:6969` on the host, localhost only. |
-| Data volume | `slopify-data`, mounted at `/data`. It holds the database, provider keys, settings, logs and staging. It is declared external, so `docker compose down` (even with `-v`) never deletes it. |
+| Data volume | `slopify-data`, mounted at `/data`. It holds the database, service keys, settings, logs and staging. It is declared external, so `docker compose down` (even with `-v`) never deletes it. |
 | Projects folder | A folder on your computer, mounted at `/data/projects`. |
 | Backups folder | A folder on your computer for scheduled backups, mounted at `/data/backups` (new installs from 3.0). |
 | Host CLI bridge | Optional. A small helper that lets the container use your AI command-line tools. |
@@ -115,7 +115,7 @@ systemctl --user status slopify-cli-bridge.service
 systemctl --user disable --now slopify-cli-bridge.service
 ```
 
-Turning it off leaves Docker, your API providers, your data and your host logins as they are. Run the install again after installing or moving a CLI.
+Turning it off leaves Docker, your keyed services, your data and your host logins as they are. Run the install again after installing or moving a CLI.
 
 If the installer can't ask (no interactive terminal), it stops and tells you to rerun with `--accept-host-cli` or `--host-cli=off`. Using the bridge needs systemd user services (`systemctl --user`); without them, use `--host-cli=off`.
 
@@ -152,7 +152,7 @@ SLOPIFY_PROJECTS_DIR=~/Documents/Slopify/Projects SLOPIFY_USER="$(id -u):$(id -g
 
 Update by changing `SLOPIFY_IMAGE` and running `docker compose up -d` again. This way has no automatic recovery copy or rollback, and Settings → General can't tell whether Docker starts at login.
 
-Keep the `127.0.0.1` binding. Anyone who reaches Slopify's port controls the app and its provider keys.
+Keep the `127.0.0.1` binding. Anyone who reaches Slopify's port controls the app and its service keys.
 
 ## Tips
 

package/dist/tutorials/Document-Themes.md

@@ -1,40 +1,40 @@
-# Document Themes
+# PDF Looks
 
-A document theme is the look of the PDF Slopify makes from the article: paper size, colours, fonts, spacing, the title page, contents, sources and closing pages, headers and page numbers. Slopify ships a built-in **Plain** theme. Copy it to make themes of your own, with a live preview as you edit.
+A PDF look (saved as a document theme) is how the PDF Slopify makes from the article looks: paper size, colors, fonts, spacing, the title page, contents, sources and closing pages, headers and page numbers. Slopify ships three ready looks, **Plain**, **Book** and **Modern**. Copy one to make looks of your own, with a live preview as you edit.
 
-**Where to find it:** **Library → PDF themes**. Pick a theme on Play's **Document** row, in **Edit project**, or as a channel's default in its brand kit.
+**Where to find it:** **Edit PDF looks** beside the **PDF look** on Create's **Extras** row, in Edit template's **PDF** section or under **Settings → Production defaults**. Pick a look on Create, in a project's **Edit settings**, or as a channel's default in its brand kit.
 
-## Built-in and your own themes
+## Built-in and your own looks
 
 | List | What it holds |
 |---|---|
-| **Built-in themes** | Looks that ship with Slopify and can't be changed. **Plain** is an unbranded flat page and what a new project gets. Press **Copy theme** to make an editable copy. |
-| **Your themes** | Themes you made or copied. Each has **Edit**, **Duplicate** and **Delete**. |
+| **Built in** | Looks that ship with Slopify and can't be changed. **Plain** is an unbranded flat page and what a new project gets; **Book** is book type on parchment; **Modern** is a sans-serif on white. Press **Copy look** to make an editable copy. |
+| **Your looks** | Looks you made or copied. Each has **Edit**, **Duplicate** and **Delete**. |
 
-A project keeps its own copy of the theme's settings. Editing or deleting a theme never changes a PDF already made or queued.
+A project keeps its own copy of the look's settings. Editing or deleting a look never changes a PDF already made or queued.
 
-## Make a theme
+## Make a look
 
-1. Open **Library → PDF themes**.
-2. Press **New theme** (it starts from Plain), or pick a built-in theme and press **Copy theme**, or press **Duplicate** on one of your themes.
-3. Type a **Name** (up to 80 characters). This is what the Document row on Play and Edit project shows.
-4. Open the groups on the left and change what you like (every setting is listed below). The first two groups start open.
-5. Watch the **Preview** on the right. It lays out a sample article with this theme using the same renderer that makes a project's PDF, redrawn about half a second after you stop typing. It runs on your computer and costs nothing.
+1. Open **PDF looks** (Settings → Production defaults → PDF look → **Edit PDF looks**).
+2. Press **New look** (it starts from Plain), or pick a built-in look and press **Copy look**, or press **Duplicate** on one of your looks.
+3. Type a **Name** (up to 80 characters). This is what the **PDF look** picker on Create and a project's Edit settings shows.
+4. Open the groups on the left and change what you like (every setting is listed below). The first two groups start open. One line under each group's title says what its settings place and in what unit, and a setting that needs more says it under its box. A changed setting offers a reset back to where it started.
+5. Watch the **Preview** on the right. It lays out a sample article with this look using the same renderer that makes a project's PDF, redrawn about half a second after you stop typing. It runs on your computer and costs nothing.
 6. Press **Save**. If a setting is out of range it is highlighted, and Save says "Fix the highlighted settings first."
 
-## Use a theme
+## Use a look
 
-- **On Play:** open the **Document** row (the PDF output) and pick the theme. See [PDF documents](PDF-Documents).
-- **On a finished project:** open **Edit project** (the **Edit settings** button), pick the theme under **Document theme**, save, and remake the document.
-- **For a channel:** set **Document theme** in the channel's brand kit. Videos whose template picks no theme get it. See [Channels](Channels).
+- **On Create:** open the **Extras** row, tick **PDF of the article** and pick the **PDF look**. See [PDF documents](PDF-Documents).
+- **On a finished project:** open **Edit settings** → **Extras**, pick the look under **PDF look**, press **Save changes**, then **Make the PDF again (free)**.
+- **For a channel:** set **PDF look** in the channel's brand kit. Videos whose template picks no look get it. See [Channels](Channels).
 
-## Delete a theme
+## Delete a look
 
-Press **Delete** on the theme and confirm. Projects that used it keep their own copy of its settings. A channel whose brand kit named it skips it.
+Press **Delete** on the look and confirm. Projects that used it keep their own copy of its settings. A channel whose brand kit named it skips it.
 
 ## Every setting
 
-Sizes are in millimetres (mm) unless marked pt (points; 1 pt is about 0.35 mm). Defaults are the Plain theme's.
+Sizes are in millimeters (mm) unless marked pt (points; 1 pt is about 0.35 mm). Defaults are the Plain look's.
 
 ### Page
 
@@ -43,21 +43,21 @@ Sizes are in millimetres (mm) unless marked pt (points; 1 pt is about 0.35 mm).
 | **Paper size** | A4 (210 × 297 mm) for most of the world, US Letter (216 × 279 mm) for the US and Canada. | A4 | |
 | **Margins** | Blank space on every edge of each page. Wider margins mean shorter lines and more pages. | 22 mm | 5 to 60 |
 | **Text starts at** | How far from the top the text begins on pages with the running header. Raise it when text crowds the header. | 32 mm | 5 to 80 |
-| **Background** | **Parchment texture** stretches an aged-paper picture over every page. **Flat colour** fills each page with the Page colour, slightly darker at the edges. | Flat colour | |
-| **Page colour** | The page colour with Flat colour. Type a hex code or use the picker. | `#fdfaf3` (warm off-white) | |
+| **Background** | **Parchment texture** stretches an aged-paper picture over every page. **Flat color** fills each page with the Page color, slightly darker at the edges. | Flat color | |
+| **Page color** | The page color with Flat color. Type a hex code or use the picker. | `#fdfaf3` (warm off-white) | |
 
-### Colours
+### Colors
 
-| Setting | What it colours | Default |
+| Setting | What it colors | Default |
 |---|---|---|
-| **Heading colour** | Headings, drop caps, the brand name and links | `#1f3a5f` (dark blue) |
-| **Body text colour** | Paragraphs, lists, bold and italic text. Keep it dark against the page. | `#1a1a1a` (near black) |
-| **Muted colour** | Dates, bullets, quotes and the dotted lines on the contents page | `#555555` (mid grey) |
-| **Faint colour** | The running header and page numbers | `#888888` (light grey) |
+| **Heading color** | Headings, drop caps, the brand name and links | `#1f3a5f` (dark blue) |
+| **Body text color** | Paragraphs, lists, bold and italic text. Keep it dark against the page. | `#1a1a1a` (near black) |
+| **Muted color** | Dates, bullets, quotes and the dotted lines on the contents page | `#555555` (mid gray) |
+| **Faint color** | The running header and page numbers | `#888888` (light gray) |
 
 ### Fonts
 
-Each font has three controls: the family, its weight or italic, and **Letter spacing (mm)** from −0.5 to 2. The families are **Cinzel** (bundled; four weights, no italics), **Literata** (bundled; a text face made for long reading, in regular, bold, italic and bold italic) and **Times**, **Helvetica** and **Courier** (built into every PDF reader).
+Each font has three controls: the family, its weight or italic, and the space between its letters, in the box marked **mm between letters**, from −0.5 to 2. The families are **Cinzel** (bundled; four weights, no italics), **Literata** (bundled; a text face made for long reading, in regular, bold, italic and bold italic) and **Times**, **Helvetica** and **Courier** (built into every PDF reader).
 
 | Setting | Where it is used | Default |
 |---|---|---|
@@ -95,7 +95,7 @@ Each font has three controls: the family, its weight or italic, and **Letter spa
 | **After a list item** | Extra space after each bulleted or numbered item | 0.2 | 0 to 3 |
 | **List indent** | How far lists are pushed in from the left margin | 6 mm | 0 to 30 |
 | **Quote indent** | How far quotes are pushed in | 8 mm | 0 to 40 |
-| **Divider width** | The width of the short centred line a `---` in the article becomes | 30 mm | 0 to 150 |
+| **Divider width** | The width of the short centered line a `---` in the article becomes | 30 mm | 0 to 150 |
 
 ### Drop caps
 
@@ -203,5 +203,5 @@ These appear in a PDF reader's document properties, not on the pages.
 
 - [PDF documents](PDF-Documents)
 - [Channels](Channels)
-- [Library overview](Library-Overview)
-- [Play outputs](Play-Outputs)
+- [Prompts and Templates](Prompts-and-Templates)
+- [Create: Extras](Create-Extras)