@gentbajko/slopify 2.5.0 → 3.0.1

package/dist/tutorials/Play-Overview.md

@@ -0,0 +1,216 @@
+# Play Overview
+
+Play is the screen where you set up a new video and start it. You pick a template (or none), type what the video is about, check the setup rows, and press the Play key. You get a project that writes the article, records the narration, draws the images and renders the video, plus any extra outputs you switched on.
+
+**Where to find it:** **New video** in the sidebar, **New video** on Home or Projects, `Ctrl+K` → **New video**, or press `C` anywhere. The page header reads **What's the video about?**
+
+## How Play is laid out
+
+Play is one path from topic to queue:
+
+1. **Template** and the topic fields at the top.
+2. **More videos from the same setup**: extra topics that run with the same settings.
+3. **The setup rows**: one line each for Title and keywords, Article, Narration, Images, Video and style, Outputs, Reviews and Channel. Each line says what the run will do. **Change** opens the row's editor under it, and **Done** folds it again.
+4. **The right rail**: the style preview, the number of videos, the estimated cost, the Play key, and the buttons **Refresh review**, **Review the whole setup** and **Save as template**.
+
+Nothing starts until you press the Play key. Every change is saved to the current draft as you make it.
+
+## Start a video
+
+1. Open Play.
+2. Optional: pick a **Template**. Picking one opens a fresh draft made from it, and the topic you already typed comes along.
+3. Type the **Title**, or the topic if the title is a pattern (see below).
+4. Look over the setup rows. A row that needs something shows **Needs setup** and says what is missing. Press **Change** to fix it.
+5. Check the estimate in the right rail.
+6. Press **Start run** (or **Queue N videos** if you added more topics).
+
+Slopify opens the new project page as soon as the run is created. When the Play key cannot start, the reason is written right under it, with **Go to the field** beside it to jump to the field that needs fixing.
+
+## Template
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Template** | Starts this video from a saved setup: prompts, voice, images, style, outputs and reviews. Picking one opens a fresh draft made from it and carries the topic you typed. | **No template**, the default setup |
+
+Under the picker you see the template's channel and version. If the template was deleted since you picked it, the picker says **Template no longer saved**. With no templates yet, it says to set up a video and press **Save as template**. See [Templates](Templates) for managing them.
+
+## Title, title pattern and topic
+
+The **Title** is the video's name, shown on the project and in Projects. Up to 200 characters.
+
+Write a keyword in double braces and the title becomes a pattern. For example, `History: {{Topic}}`:
+
+- The top of Play then asks for **Topic** instead of the whole title, and shows the title it makes underneath (**Title: History: The Lost City**).
+- The pattern itself moves to **Title and keywords → Title pattern**, where you can change it.
+- Each keyword the title names is a topic you type once per video. Templates save it empty.
+- A topic value is up to 200 characters, on a single line.
+
+A title without braces is typed as is.
+
+### Already made on this channel
+
+As you type, a quiet line under the topic fields says when the picked 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). Start anyway if you want another take.`
+- `This channel already uploaded "<title>" (Channel → Existing videos). Start anyway if you want another take.`
+
+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.
+
+Keywords live in the **Title and keywords** row. Topic keywords (the ones the title names) are typed at the top of Play instead. If there are none, the row says: "No keywords. A prompt or the title that names {{a keyword}} adds one here."
+
+| Option | What it does | Limit |
+| --- | --- | --- |
+| **Keyword** | Fills every `{{name}}` in the title and the picked prompts. A keyword the title does not name is saved with a template. | 200 characters, single line |
+
+## More videos from the same setup
+
+**Add topic** queues another video with everything else the same. Only its title and keywords differ.
+
+1. Press **Add topic** under the topic fields.
+2. Type the new topic (or the new title, if the title has no keywords) and press **Add**. Add as many as you like, then press **Done** or `Esc`.
+3. Each extra video shows as a chip. Its name is a button with a pencil (**Change the keywords of …**): press it to open a side panel where you can change that video's **Title** and keywords. Everything else comes from the setup of the first video.
+4. Press the **x** on a chip to remove that video.
+
+One Start queues at most 50 videos: this setup and 49 more. The Play key reads **Queue N videos**, and the videos run one at a time, in order.
+
+### The video queue
+
+Videos started together wait in the queue, shown on the Calendar under **Batch queue** (see [Calendar](Calendar#the-batch-queue)) and behind the **Queue · N** button in a project page's right rail. Projects has a **Queued** filter for them. Pausing a project holds the queue. When one fails or is cancelled, the next one starts.
+
+## Drafts
+
+Play saves every change to the current draft on its own. The status beside **Drafts** in the page header says **Unsaved**, **Saving…**, **Saved**, **Couldn't save** or **Changed elsewhere**.
+
+- **Drafts** lists your saved setups with their last edit time. Press anywhere on a draft's row to open it, or **Discard** to delete it (it asks you to confirm, and this cannot be undone).
+- **New draft** starts an empty draft and keeps the current one in the list.
+- If saving fails, press **Retry**.
+- A draft the app cannot read is marked "Unsupported or corrupt draft". Try opening it to recover it, or discard it.
+
+### When a draft was changed elsewhere
+
+If you have the same draft open in another tab or window and it was saved there, the status says **Changed elsewhere** and offers 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 setup rows at a glance
+
+| Row | What it holds | Details |
+| --- | --- | --- |
+| **Title and keywords** | The title pattern and every keyword value | This page |
+| **Article** | Article source, article prompt, text generation (LLM, model, thinking), research | [Play Title and Article](Play-Title-and-Article) |
+| **Narration** | Narration source, TTS, model, voice, speakers, Audio Advanced (chunking, intro, outro, preparation, glossary, aliases, tables and figures) | [Play Narration](Play-Narration) |
+| **Images** | Images source, provider, model, effort, image prompts, establishing image, more images for long videos | [Play Images](Play-Images) |
+| **Video and style** | Video source, seconds per image, zoom, motion, cuts, the Look, ambient sound, pauses and volume, silence, frame format, captions, preview text | [Play Video and Style](Play-Video-and-Style) |
+| **Outputs** | Thumbnail, YouTube description, Shorts, tables and figures on screen, PDF document | [Play Outputs](Play-Outputs) |
+| **Reviews** | Review checkpoints and automatic reviews (opens the side panel) | [Reviews and Checkpoints](Reviews-and-Checkpoints) |
+| **Channel** | Channel, brand kit, language | This page, [Channels](Channels), [Other Languages](Other-Languages) |
+
+When you open a draft, rows that need attention start open. The others stay folded until you press **Change**.
+
+## Channel row
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Channel** | The channel this video belongs to. Its brand kit fills what this setup leaves at its default, and its cast of characters goes with the images. The list shows how many are in each channel's cast. | The template's channel, or the default channel |
+| **Use the channel's brand kit** | Fills what this setup leaves at its default from the channel: the caption font, intro, outro, document theme and ambient sound. What you set on Play wins. Off takes none of it; the cast and language still apply. | On |
+| **Language** | The language the article, narration, YouTube description and shorts titles are written in. Blank uses the channel's language. | Channel's language |
+
+The row has an **Edit** link to the channel's page. For the language, voices and caption timing in other languages, see [Other Languages](Other-Languages). For the cast, see [Cast Library](Cast-Library).
+
+## The right rail
+
+### Style preview
+
+When the video is generated from images, the rail shows **Style preview**: six seconds of the bundled sample project, its real narration over three of its pictures, rendered by the real renderer with your captions, Look and motion, and the captions timed to the narration. See [Play Video and Style](Play-Video-and-Style#style-preview).
+
+### Estimated cost
+
+What the providers 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.
+
+- 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 says 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 command-line 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.
+
+The estimate refreshes on its own a moment after you stop typing. Press **Refresh review** to check the setup and recalculate now, for example after changing a prompt in the Library.
+
+See [Costs and Run Cost](Costs-and-Run-Cost) for how prices are worked out.
+
+### Expected article words per video
+
+How long you expect each generated article to be. It drives the cost estimate and how many images **More images for long videos** adds. Once the article is written, its real length is used. About 150 words is one minute of narration.
+
+| Option | Default | Range |
+| --- | --- | --- |
+| **Expected article words per video** | 1500 | 1 to 100,000 |
+
+### The Play key
+
+| Label | When |
+| --- | --- |
+| **Start run** | One video |
+| **Queue N videos** | You added more topics |
+| **Starting…** | The start is being sent |
+| **Check Start result** | Slopify didn't confirm the last start. Press it to find out before starting again. |
+
+The line under the key says why it can't start yet (a missing field, an upload still running, the estimate still being checked), or "Nothing starts until you press it."
+
+### Review the whole setup
+
+Opens the **Review** side panel: every setting of the run in words, any setup errors (press one to jump to it), the review checkpoints, the automatic reviews, and **Read the resolved prompt**, which shows each prompt exactly as it will be sent, with keywords filled in. `Ctrl+Enter` anywhere on Play opens the same panel. See [Reviews and Checkpoints](Reviews-and-Checkpoints).
+
+## Save as template
+
+**Save as template** in the right rail keeps this setup's prompts, voice, images, style, outputs and reviews 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 the template is listed under on Play and Templates.
+3. Read the list of 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, and the value you typed for this video.
+- Other keywords (a word count, a style) keep their values. If the title names no keywords, the dialog says every keyword keeps its value.
+- The other videos you queued with **Add topic** are not saved.
+- The template belongs to the draft's channel.
+
+You can also save a template from Templates → **Save a setup**, which picks a saved Play draft (**Saved Play draft**), a **Template name** of up to 120 characters and a **Channel**. The same keyword rule applies there, and queued extra videos and uploaded fonts are left out. See [Templates](Templates).
+
+## Command palette
+
+Every Play action is in the command palette (`Ctrl+K`):
+
+| Command | What it does |
+| --- | --- |
+| **Start run** / **Queue N videos** | Starts, or jumps to what holds it back |
+| **Add a topic for another video** | Opens the Add topic field |
+| **Save as template** | Opens the Save as template dialog |
+| **Review the whole setup** (`Ctrl+Enter`) | Opens the Review panel |
+| **Pick a template** | Focuses the Template picker |
+| **Change title and keywords**, **Change article**, 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 Play set up for it. See [Your First Short](Your-First-Short#make-the-full-video-next).
+- Start with a template and only change the rows you need. The row summaries tell you what each one will do without opening it.
+- Use a title pattern and **Add topic** to queue a series in one go.
+- If a template refers to a prompt you have since deleted, the Article or Images row shows **Needs setup**. Pick another prompt.
+
+## Related pages
+
+- [Your First Short](Your-First-Short)
+- [Play Title and Article](Play-Title-and-Article)
+- [Play Narration](Play-Narration)
+- [Play Images](Play-Images)
+- [Play Video and Style](Play-Video-and-Style)
+- [Play Outputs](Play-Outputs)
+- [Reviews and Checkpoints](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/Play-Title-and-Article.md

@@ -0,0 +1,135 @@
+# Play Title and 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 Play you either have a text model write it from a prompt, or paste your own. This page covers the **Title and keywords** row, the **Article** row (article source, prompt, text generation and research) and the intro and outro that wrap the article.
+
+**Where to find it:** Play → **Title and keywords** row and **Article** row → **Change**. The intro and outro are under Play → **Narration** → **Change** → **Audio Advanced**.
+
+## Title and keywords
+
+The title and the topic are typed at the top of Play. The **Title and keywords** row holds the rest:
+
+| Field | What it does | Limit |
+| --- | --- | --- |
+| **Title pattern** | Shown when the title names a keyword in double braces, like `History: {{Topic}}`. Change the pattern here; the topic values stay at the top of Play. | 200 characters |
+| Each keyword | A value a picked prompt or the title asks for with `{{name}}`. Typed once, it fills every place that names it; the line under it lists where. | 200 characters, one line |
+
+The row's summary says how many keywords the setup has. Keywords come from the title and from every prompt you pick (article prompt, image prompts, thumbnail prompt and so on), so the list grows as you pick prompts. Every keyword must be filled before the run can start ("Fill in this field.").
+
+For title patterns, topics and queuing more videos, see [Play Overview](Play-Overview#title-title-pattern-and-topic).
+
+## Choose where the article comes from
+
+The Article row starts with a **Source** switch:
+
+| Source | What happens | Cost |
+| --- | --- | --- |
+| **Generate** (default) | The text model writes the article from the article prompt, in one call. | One text-model call |
+| **Provide** | Slopify narrates the text you paste, word for word. No text model writes one. | No text-model cost for the article |
+
+The article is what the narration reads and what the PDF lays out.
+
+### Generate an article from a prompt
+
+1. Open the **Article** row and leave **Source** on **Generate**.
+2. Pick an **Article prompt**. These are the article prompts saved in the Library, with their keywords filled in.
+3. Optional: press **View prompt** to read the prompt's text.
+4. Fill in any keywords the prompt asks for in the **Title and keywords** row.
+5. Pick the text model under **Text generation** (below).
+
+If you have no article prompts yet, the row says "No article prompts saved. Create a prompt to begin." Press **Create prompt** to open a new article prompt in the Library. Your draft is saved first. See [Prompts](Prompts).
+
+When the narration uses several speakers with **Write a script**, 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 set **Source** to **Provide**.
+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. Research is turned off when the article is provided: the row says "Research is Off because the article is provided."
+
+## Text generation
+
+One text model writes everything this run needs in words: the article, the research, the thumbnail's image prompt, intro and outro entries set to LLM, Narration Preparation, table and figure descriptions, the YouTube description and picking shorts. Each is a separate call, counted in usage.
+
+The **Text generation** section appears under the Article row whenever the run needs a text model. **Settings** beside it opens Settings, where you set the default for new drafts.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **LLM** | Who runs the text model: a command-line tool you are signed in to, such as Claude Code or Codex, or a keyed service such as OpenRouter, billed per token. A greyed provider says why it cannot be used; fix it under Settings. | Your Settings default |
+| **Text model** | The model the provider runs for every text step. Bigger models write better and cost more per token. | Your Settings 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 **LLM** clears the model, so pick a model again.
+- The refresh button beside **Text model** asks the provider for its current list.
+- **Custom ID** lets you type a model the list does not show. **Use list** goes back to the list.
+- **Thinking** only appears when the model offers levels. It lists **Model default** and the levels the model supports, from **Off**, **Low**, **Medium**, **High**, **Xhigh**, **Max** and **Ultra**.
+
+If no text model is picked but the run needs one, the row shows "Choose a text (LLM) provider and model." See [Providers and Keys](Providers-and-Keys), [AI CLIs](AI-CLIs) and [Models](Models).
+
+## Research
+
+Research gives the text model notes to write from, beyond what it already knows. It has its own **Source** switch under the Article row:
+
+| Source | What happens | Cost |
+| --- | --- | --- |
+| **Off** (default) | The article is written from the prompt alone. | Nothing extra |
+| **Generate** | The text model plans chapters, researches each one on the web and combines the notes before the article is written. The row reads "Runs through the LLM, one agent per chapter". | One call to plan, one per chapter, one to combine |
+| **Provide** | Uses notes you paste in **Research notes**. Nothing is looked up. | Nothing extra |
+
+### Research on the web
+
+1. Set the Research **Source** to **Generate**.
+2. Make sure the text model can search the web. A model that cannot fails the Research stage straight away, rather than falling back to what it already knows.
+3. Start the run. You can watch the notes being written on the project page's live view.
+
+### Give your own research notes
+
+1. Set the Research **Source** to **Provide**.
+2. Paste facts, sources and quotes the article should draw on into **Research notes**.
+
+The notes are given to the text model with the article prompt, in place of web research.
+
+## Expected article words
+
+**Expected article words per video** sits in the right rail under the estimate. It tells Slopify how long you expect each generated 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. Default 1500, range 1 to 100,000. Set it to roughly what your article prompt asks for.
+
+## Intro and outro
+
+An intro is read before the article and an outro after it. Both are Library entries, picked in the Narration row under **Audio Advanced**.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Intro** | A Library entry read before the article. A text entry is read as written; an LLM entry is written by the text model for each video, one extra call. | Off |
+| **Outro** | A Library entry read after the article, such as a sign-off. Text or LLM, as above. | Off |
+
+1. Open the **Narration** row and press **Change**.
+2. Open **Audio Advanced**.
+3. Pick an **Intro** and an **Outro**, or leave them **Off**.
+4. Optional: set **Silence between segments** in the **Video and style** row to change the quiet between the intro, the article and the outro (Settings has the default, 3 seconds).
+
+The channel's brand kit can fill the intro and outro when you leave them at their default. With several speakers, the main **Voice** in the Narration row reads the intro and outro. Uploaded narration (**Provide**) must already include any intro and outro. Write entries in the Library; see [Intros and Outros](Intros-and-Outros).
+
+## What the row summary says
+
+Folded, the Article row shows the prompt, the provider and model, and the research source, for example `History article · Claude Code · sonnet · research off`, or **Your article** when you pasted one. A row that is missing something shows **Needs setup** and the reason, such as "Pick an article prompt." or "Paste the article."
+
+## Tips
+
+- Ask for a Pronunciation Glossary at the end of your article prompt if the topic has unusual names. See [Play Narration](Play-Narration#pronunciation-glossary).
+- Use **Review the whole setup** → **Read the resolved prompt** to see the article prompt exactly as it will be sent, keywords filled in.
+- A Review prompt can check the article after it is written. See [Reviews and Checkpoints](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
+
+- [Play Overview](Play-Overview)
+- [Prompts](Prompts)
+- [Intros and Outros](Intros-and-Outros)
+- [Models](Models)
+- [Providers and Keys](Providers-and-Keys)
+- [AI CLIs](AI-CLIs)
+- [Multiple Voices](Multiple-Voices)
+- [Other Languages](Other-Languages)

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

@@ -0,0 +1,143 @@
+# Play Video and Style
+
+The **Video and style** row decides how your images become a video: how long each stays on screen, how they move and cut, the Look over the picture, an optional ambient sound bed, the frame shape and the captions. The video is rendered on this computer, so none of this costs provider money except **Animate images**. A six-second style preview in the right rail shows and plays your choices as you make them.
+
+**Where to find it:** Play → **Video and style** row → **Change**. After the run, the same controls are in the project's **Edit project**; see [Video Editing](Video-Editing).
+
+## Choose whether to render a video
+
+The row starts with a **Source** switch:
+
+| Source | What happens | Cost |
+| --- | --- | --- |
+| **Generate** (default) | Renders the slideshow video on this computer from the images and narration. | No provider money, only time |
+| **Off** | No video. Each finished stage is left to download on its own. With narration on, you get a combined WAV of the narration with its segment gaps instead. | None |
+
+**Generate** needs images, so the video is Off while Images is Off. The line beside the switch says what you will get:
+
+| Line | When |
+| --- | --- |
+| "Images and narration · 3 s segment gaps" | Video on, narration on (the gap is your silence between segments) |
+| "Silent video · each image shown once" | Video on, narration Off |
+| "Combined WAV export with narration and segment gaps" | Video Off, narration on |
+| "Download each enabled stage separately" | Video Off, narration Off |
+
+## Timing and motion
+
+| 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 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 |
+| **Silence at start and end (seconds)** | Quiet time before the narration starts and after it ends. Shown while there is narration. | 2; 0 to 30 |
+| **Silence between segments (seconds)** | Quiet between the intro and the narration, and between the narration and the outro. Only matters with an intro or outro. Empty uses the Settings gap. | Settings value (3 unless changed); 0 to 30 |
+
+**Follow the narration** needs word timing, so it works in English and the languages that have it. For a language without word timing, **Cuts** is locked to **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 [Play Images](Play-Images#more-images-for-long-videos).
+
+## The Look
+
+**Look** is a disclosure under the timing controls. Closed, its line lists what is on, or "Plain cuts, no effects". Everything in it is applied while the video renders.
+
+| 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) |
+| **Colour grade** | A colour treatment over the whole video: **Warm fantasy**, **Cold**, **Desaturated** or **Sepia**. Only render time. | 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. No footage is downloaded and no API 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 provider (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 third box. 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 providers 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 model in the model box ("Choose a model"). The run cannot start until one is picked.
+5. Check the added cost in the estimate.
+
+## Ambient sound
+
+An optional bed 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 no bed, 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 the bed plays under the voice, from −40 (barely there) to −6 (close to the voice). Whole numbers only. | −18 |
+| **Fade in (seconds)** | How long the bed takes to rise from silence at the start. | 3; 0 to 30 in steps of 0.5 |
+| **Tail after the narration (seconds)** | How long the bed 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 the bed: shorts keep their own background music, and the audio-only WAV stays the narration alone. It costs no API calls. A template with **My own file** cannot run on a schedule, because the file has to be attached again on Play; pick a built-in bed for scheduled runs. A channel's brand kit can only hold the three built-in beds.
+
+## Pauses and Level the volume
+
+Below the ambient sound are **Pause between sentences**, **Pause between paragraphs** and **Level the volume** with its **Video volume** and **Audio files volume**. They shape the narration, so they are described on [Play Narration](Play-Narration#pauses-between-sentences-and-paragraphs).
+
+## Frame format
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Frame format** | **16:9** is a landscape video for YouTube and screens. **9:16** is a portrait video for phones. Images are drawn in this shape and captions are placed for it. | 16:9 |
+
+## Captions
+
+Captions are timed from your narration on this computer, with no paid API. The first use downloads a speech model of about 95 MB. They need narration: with narration Off, the section says "Turn Audio on to add subtitles."
+
+| 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 the video on. | Off |
+| **Subtitle font** | The typeface of burned-in captions and chapter cards. Pick **Default font · bundled** or a font you uploaded. | Default font |
+| **Upload font (.ttf or .otf)** | Adds your own font, right here in the caption font picker (there is no separate font screen in Settings). Uploaded fonts stay available to every project and to a channel's brand kit. | |
+| **Subtitle font size** | How big burned-in captions are. Larger is easier to read on phones but covers more of the picture. Type it or use the slider. | 48; 16 to 120, whole numbers |
+| **Subtitle position** | Where burned-in captions sit: **Top**, **Upper-middle**, **Center**, **Lower-middle** or **Bottom**. Move them up when the pictures have important detail near the bottom. | Bottom |
+
+Font, size and position apply to burned-in captions only. Players style `.srt` and `.vtt` files themselves. The channel's brand kit can fill the caption font when you leave it at the default.
+
+### Burn captions into the video
+
+1. Make sure the Narration row is not Off and the video Source is **Generate**.
+2. Set **Subtitles** to **Burn into video + files**.
+3. Pick a **Subtitle font**, or press **Upload font (.ttf or .otf)** and pick a file. Wait for "Uploading font…" to finish; the run cannot start during the upload.
+4. Set **Subtitle font size** and **Subtitle position**.
+5. Watch the style preview in the right rail.
+
+If a saved font is missing (for example after a reinstall), the picker says "Saved font is unavailable. 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).
+
+## Style preview
+
+The **Style preview** at the top of the right rail ("6 seconds of the sample, rendered with your settings") is rendered on this computer by the real video renderer, with your captions, Look and motion. It plays six seconds of 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 in Slopify's own player, with sound.
+
+The pictures are the sample's (landscape or portrait, following **Frame format**), 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 under it names the caption settings, and "Drawn on …" when it uses one of your pictures. It renders again by itself a moment after you change a setting, costs no API calls, and **Render again** forces a fresh one.
+
+It shows while the video is generated from images. If the caption settings are invalid, it says "Fix the caption settings to render the preview."
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Preview text** | The words the preview's captions show, in your caption font, size and position. Left at the sample sentence (or empty), the captions are the sample narration's own words; any other text is spread over the stretches where the narration speaks. It is only for the preview and never reaches the video; real captions come from your narration. | "Every story begins with a word." |
+
+The same preview is in Edit project while its **Subtitles** section is open. Shorts have their own [Shorts preview](Shorts#shorts-preview).
+
+## What the row summary says
+
+Folded, the row reads like `16:9 · follow the narration · Warm fantasy · captions Default font 48 bottom`: the frame, the cuts, the Look, and the caption font, size and position, or "no video" 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 render time, so you can change the Look later in Edit project without paying a provider again.
+
+## Related pages
+
+- [Play Overview](Play-Overview)
+- [Play Images](Play-Images)
+- [Play Narration](Play-Narration)
+- [Video Editing](Video-Editing)
+- [Channels](Channels)
+- [Other Languages](Other-Languages)
+- [Schedules](Schedules)