@gentbajko/slopify 2.5.0 → 3.0.1

package/dist/tutorials/PDF-Documents.md

@@ -0,0 +1,100 @@
+# PDF Documents
+
+Slopify can lay out your article as a styled PDF: a title page with the thumbnail as its cover, a table of contents, the article with drop caps, a sources page and an optional closing page. It is drawn on your computer in the theme you pick, needs no provider and costs nothing.
+
+**Where to find it:** Play → **Outputs** row → **Document**. On a finished project: the **Document** section of the project page, and Edit project → **Inputs** → **Stages** → **Document theme**.
+
+## Make a PDF
+
+1. On Play, open the **Outputs** row.
+2. In the **Document** rail, switch the source from **Off** to **Generate**.
+3. Pick a **Theme**: the built-in **Plain**, or one of your own themes from Library → Documents.
+4. Start the run.
+
+The Document stage runs after the article (and the thumbnail, if there is one) is ready. A thumbnail that failed or was cancelled doesn't hold it back: the PDF is then laid out without a cover. It needs an article with some text; an empty article stops the stage with a message pointing you to Edit project → Article.
+
+## Options
+
+| Option | What it does | Default |
+|---|---|---|
+| **Document** source | **Generate** lays out a PDF of the article and title on this computer, in the theme you pick. It needs no provider and costs nothing. | Off |
+| **Theme** | How the PDF looks: the built-in **Plain** theme, or one of yours from **Library → Documents**. **Edit themes** opens the list. | Plain, or the channel's document theme |
+
+A theme of yours is copied into the project when you pick it. Editing the theme later leaves this project alone until you pick it again, so a PDF already made or queued never changes by surprise. A channel's brand kit can set a **Document theme** for its videos whose template picks none; see [Channels](Channels).
+
+## What's in the PDF
+
+In order:
+
+| Part | What it holds |
+|---|---|
+| **Title page** | The theme's brand name and tagline (if the theme sets them), the video's title, the project's thumbnail as a cover, then the date and word count. |
+| **Table of Contents** | Headings from the article, down to the level the theme sets (two levels in Plain), with page numbers. |
+| **Body** | The article: headings, paragraphs with a drop cap after headings, bold and italic, links, lists, quotes and rules. |
+| **Sources Consulted** | The article's "Sources Consulted" section, then any other web link cited in the research notes. Links stay clickable. |
+| **Closing page** | Optional: the theme's own lines, the document's details (written on, total words, total pages), a link and a closing line. Off in Plain. |
+
+Every page after the title page has a running header ("Brand | Title", or the title alone) and a page number in the footer.
+
+### What is left out
+
+- The article's **Pronunciation Glossary** is for the narrator and is never printed.
+- The "Sources Consulted" section becomes the Sources page instead of body text.
+- A heading at the top that repeats the title is not printed twice.
+- Images, raw HTML and footnotes in the article's markdown have no printed form. Tables are printed as rows of cells separated by `|`, and code blocks as plain paragraphs.
+
+### Cover
+
+The title page uses the project's thumbnail as its cover when:
+
+- the project makes or uploads a thumbnail (its Thumbnail source is not Off),
+- the thumbnail is a PNG, JPEG or WebP image, and
+- the theme's cover setting is on (it is in Plain).
+
+Otherwise the title page has no cover and the details sit in the theme's usual place. That includes a thumbnail step that failed or was cancelled: the PDF is made anyway, without a cover. If you make the thumbnail later, the PDF is marked outdated, so you can remake it with the cover. If the thumbnail file can't be read, the Document stage stops and asks you to regenerate or upload the thumbnail again, then use **Try again** on Document.
+
+### Sources
+
+Sources come from two places:
+
+1. The article's own section headed **Sources Consulted** (any heading level, or a bold line). Ask for it in your Article prompt with exactly that heading.
+2. Links in the research notes, when research is on, that the article's list doesn't already have.
+
+When there are no sources, the Sources page is left out.
+
+## The Plain theme
+
+Plain is the one built-in theme: an unbranded A4 page on a warm off-white background, headings in dark blue, the Cinzel typeface for body and headings, a three-line drop cap after headings, a table of contents and a sources page, no closing page.
+
+To change fonts, colours, paper size (A4 or Letter), page parts and the closing page, make your own theme. See [Document-Themes](Document-Themes).
+
+## Open and download the PDF
+
+On the project page, the **Document** section shows the theme's name (for example **Plain theme**) and, once the PDF is made:
+
+- **Open PDF** opens it in a new browser tab.
+- **Download PDF** saves the file to your computer.
+
+While the stage runs it says "The PDF will be saved when rendering finishes." The file lives in the project's folder; see [Where-Your-Files-Live](Where-Your-Files-Live).
+
+## Change the theme of a finished project
+
+1. Open the project and press **Edit project**.
+2. Open **Inputs**. Under **Stages**, set the Document source to Generate if it was Off.
+3. Pick a **Document theme**.
+4. Save. The rebuild review lists the PDF to be made again; it costs nothing.
+
+## Tips
+
+- Use Library → Documents' live preview to try a theme on a sample article before you pick it for a project.
+- If a PDF has no cover, check that the project has a thumbnail and that it is a PNG, JPEG or WebP image.
+- Want the sources page filled? Make sure your Article prompt asks for a "Sources Consulted" section, and consider turning on research.
+
+## Related pages
+
+- [Document-Themes](Document-Themes)
+- [Play-Outputs](Play-Outputs)
+- [Channels](Channels)
+- [Project-Page](Project-Page)
+- [Editing-a-Project](Editing-a-Project)
+- [Play-Title-and-Article](Play-Title-and-Article)

package/dist/tutorials/Play-Images.md

@@ -0,0 +1,135 @@
+# Play Images
+
+The images are the pictures your video shows while the narration plays. On Play you pick who draws them, which Library image prompts they come from and how many each makes, and optionally an establishing image that keeps characters and style consistent. You get a set of images, drawn in the video's frame shape, played in order.
+
+**Where to find it:** Play → **Images** row → **Change**.
+
+## Choose where the images come from
+
+The Images row starts with a **Source** switch:
+
+| Source | What happens | Cost |
+| --- | --- | --- |
+| **Generate** (default) | Draws images from the ticked image prompts, one image-model call each. | Per image, by the provider |
+| **Provide** | Uses your own PNG, JPEG or WebP files (**Slideshow images**) in the order you pick them. | None |
+| **Off** | No images. This turns the video off too: the **Video and style** row says "Video is Off because Images is Off." | None |
+
+### Use your own images
+
+1. Set **Source** to **Provide**.
+2. Pick the files under **Slideshow images**. Each is numbered in the order it plays.
+3. Remove a file with its remove button, or reattach one whose upload was lost.
+
+A video can have at most 60 of your images, and the same file cannot be picked twice. Wait for every upload to finish before pressing Start.
+
+## Pick the image provider and model
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Provider** | Who draws the images, the thumbnail and the shorts' pictures: a keyed service billed per image (fal.ai, Replicate, OpenAI, Google), or a command-line tool you are signed in to (Codex CLI). A greyed provider says why it cannot be used; fix it under Settings. | Your Settings default |
+| **Model** | The provider's image model. Models differ in quality, speed and price per image; the estimate in the right rail shows what this run costs. The refresh button asks for the current list; **Custom ID** lets you type one. | Your Settings default |
+| **Effort** | How long an image agent, such as the Codex CLI, reasons before it draws. Higher effort can follow the prompt more closely but takes longer and uses more tokens. Shown only for models that offer levels. | **Model default** |
+
+Changing the provider clears the model.
+
+### Drawing with the Codex CLI
+
+With **Codex CLI** as the image provider, the **Model** list holds **Codex default** and the Codex CLI's own models. **Codex default** leaves the model and effort to the CLI's own defaults. Any other model runs with the **Effort** you pick. An image agent that reviews and redraws its picture can work for several minutes at a high effort. Images drawn this way cost nothing extra on your plan; the estimate shows the approximate API price beside **$0 on your plan**. See [AI CLIs](AI-CLIs).
+
+## Pick the image prompts
+
+1. Under **Image prompts**, tick the Library prompts that should draw the video's images.
+2. Give each ticked prompt a **Number**: how many images it makes, 1 to 20.
+3. Check the total under the list, for example **8 of 60 images**.
+
+| Rule | Value |
+| --- | --- |
+| Images per prompt | 1 to 20 |
+| Images per run, hand-set | at most 60 |
+| Images per run, with **More images for long videos** | at most 240 |
+| Order | The images play in the order you ticked the prompts |
+
+Each image is one image-model call. A prompt that has been deleted since this draft picked it shows **Missing template · untick to remove**. With no image prompts at all, the row says "No image prompts saved. Write one on Prompts." See [Prompts](Prompts).
+
+### Photorealistic prompts
+
+An image prompt in the Library has a **Draws photorealistic pictures** tick. Turn it on when the prompt's style looks like real photos or film. Prepare upload then answers Yes to YouTube's AI use question for videos and shorts drawn with it. Leave it off for painterly or illustrated styles. It is set on the prompt, not on Play: open Library → Prompts → the prompt. See [Prompts](Prompts) and [Publishing to YouTube](Publishing-to-YouTube).
+
+## Establishing image
+
+The establishing image is made first and never shown in the video. Every other image, the shorts' images and (if ticked) the thumbnail are drawn with it as a reference, so characters, style and palette stay the same across the video.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Establishing image** | **Off**, **From a prompt** (costs one more image) or **Upload** (your own PNG or JPEG, **Establishing image file**). | Off |
+| **Establishing prompt** | The Library image prompt that draws it, keywords filled like the others. Describe the characters, setting and style every other image should share. | None |
+| **Draw the thumbnail from it too** | Draws the thumbnail with the establishing image as a reference too, so it matches the video. Untick it for a thumbnail drawn on its own. | On |
+
+Changing the establishing image later marks the images drawn from it as outdated. When you upload the establishing image, the style preview in the right rail is drawn on it, so you judge the Look and captions on your own picture.
+
+### Set up an establishing image
+
+1. Under **Establishing image**, pick **From a prompt** or **Upload**.
+2. For **From a prompt**, pick the **Establishing prompt**. For **Upload**, pick the file.
+3. Leave **Draw the thumbnail from it too** ticked if the thumbnail should match.
+
+## The channel's cast
+
+The channel you pick in the **Channel** row brings its cast: characters, creatures, places and objects, each with reference pictures. When an image's brief mentions a cast member by name or alias (as a whole word, ignoring case), that image is drawn with the member's pictures as references, after the establishing image when it is on. The establishing image and the thumbnail also take the members the title mentions. At most four members go with one image.
+
+Models that take several input pictures (Codex, OpenAI, Google, and fal.ai's FLUX.2 and Nano Banana 2 edit models) use the pictures directly. A model that takes none gets the members described in words instead. The cast is used even when **Use the channel's brand kit** is off. See [Cast Library](Cast-Library) and [Channels](Channels).
+
+## More images for long videos
+
+A long video with a fixed handful of images repeats them for an hour. **More images for long videos** adds images as the narration gets longer.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **More images for long videos** | Adds images, planned from the expected length when the run starts. The extra images are shared among the ticked prompts in order, up to 240 in all. Each is one more image call. | Off |
+| **How the rate is given** | **Every N minutes**: one image every N minutes of narration (0.25 to 60). **N per hour**: N images per hour (1 to 240). Switching keeps the same rate. | One image every 2 minutes |
+
+### Turn it on
+
+1. Tick at least one image prompt.
+2. Switch on **More images for long videos**.
+3. Pick **Every N minutes** or **N per hour** and type the rate.
+4. Read the line under it, for example: "For about 60 minutes (9,000 words expected, set on Review): 30 images, 26 more than the prompts' 4."
+
+How the count is worked out:
+
+- The length is the pasted article's own word count, or else **Expected article words per video** in the right rail, at 150 spoken words a minute.
+- Each ticked prompt keeps its own **Number** as a minimum. The extra images are handed to the ticked prompts one at a time, in the order they were ticked.
+- When the prompts' own Numbers already cover the length, nothing is added.
+- The count stops at 240. After that the slideshow repeats its images, as it does whenever the narration outlasts them.
+- The count is planned once, when the run starts. A narration that turns out longer is still covered by the slideshow cycling its images.
+
+Turning it on also switches **Motion** (in the **Video and style** row) from **Zoom in and out** to **Mix of both**, so a long video pans and zooms by turns. A **Pan across** or **Still** you picked stays, and you can pick Zoom again.
+
+## How long each image stays on screen
+
+**Seconds per image** (1 to 600, default 15) is in the **Video and style** row, beside **Cuts**, **Zoom** and **Motion**. When cuts follow the narration, it is the target length and a cut waits for a sentence end. When images run out, they start again. See [Play Video and Style](Play-Video-and-Style).
+
+## The thumbnail and the shorts
+
+The thumbnail and the shorts' images use the same image provider and model. If the video's images are not generated but the thumbnail is, the thumbnail gets its own **Provider**, **Model** and **Effort** pickers in the **Outputs** row. See [Play Outputs](Play-Outputs) and [Shorts](Shorts).
+
+## What the row summary says
+
+Folded, the Images row lists each ticked prompt with its Number, the provider and model, and "establishing image" when one is on, for example `Scene × 6, Portrait × 2 · fal.ai · flux-pro · establishing image`. With Provide it says how many of your images there are.
+
+## Tips
+
+- Keep one style across the video with an establishing image, instead of repeating the style in every image prompt.
+- Picture reviews can check each image for malformed hands, stray text and a match with its brief. They need Claude Code or Codex as the reviewer. See [Reviews and Checkpoints](Reviews-and-Checkpoints).
+- After the run, you can add, remove or regenerate single images on the project page. See [Editing a Project](Editing-a-Project).
+
+## Related pages
+
+- [Play Overview](Play-Overview)
+- [Prompts](Prompts)
+- [Cast Library](Cast-Library)
+- [Channels](Channels)
+- [Models](Models)
+- [Costs and Run Cost](Costs-and-Run-Cost)
+- [Play Video and Style](Play-Video-and-Style)
+- [Play Outputs](Play-Outputs)

package/dist/tutorials/Play-Narration.md

@@ -0,0 +1,167 @@
+# Play Narration
+
+The narration is the article read aloud by a text-to-speech (TTS) voice. On Play you pick the service, model and voice, and fine-tune how the text is prepared, split, paced and levelled. You get a narration track that the captions, cuts, chapters and shorts are all timed from.
+
+**Where to find it:** Play → **Narration** row → **Change**. The pauses, the volume levelling and the silences sit in Play → **Video and style**, and **Show tables and figures on screen** sits in Play → **Outputs**; they are described here because they shape the narration.
+
+## Choose where the narration comes from
+
+The Narration row starts with a **Source** switch:
+
+| Source | What happens | Cost |
+| --- | --- | --- |
+| **Generate** (default) | A TTS voice reads the article aloud. | Charged by the provider per character |
+| **Provide** | Uses an audio file you upload (**Narration file**), as it is. | None |
+| **Off** | Makes a silent video with no captions, YouTube description or shorts. The row reads "Off, a silent video". | None |
+
+With **Provide**, the file is used as is: "Uploaded narration is used as-is; include any intro and outro in that file." It is never levelled piece by piece; only the final master reaches it when **Level the volume** is on.
+
+## Pick a voice
+
+1. Open the **Narration** row and leave **Source** on **Generate**.
+2. Pick the **TTS** provider. A greyed provider says why it cannot be used; add its key under Settings.
+3. Pick the **TTS model**.
+4. Pick a **Voice**. If the list says "No voices. Add one in Settings.", add a voice first (see [Add a voice](#add-a-voice-under-settings--voices)).
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **TTS** | The text-to-speech service, charged per character of text: ElevenLabs, OpenAI, Cartesia, Inworld, Google Gemini, or **System voice**, your computer's own speech, which is free (greyed as **Speech Program Missing** when none is found; see [the system voice](Providers-and-Keys#the-system-voice)). Changing it clears the model and voice. | Your Settings default |
+| **TTS model** | The provider's speech model. Models differ in quality, languages, speed and price per character. Narration Preparation needs Inworld TTS-2. The refresh button asks the provider for its current list; **Custom ID** lets you type one. | Your Settings default |
+| **Voice** | Who reads the narration: the voices you added under Settings → Voices for this provider, filtered to the project's language. With several speakers, this voice reads the intro and outro. | None |
+| **Show all voices** | The voice list hides voices listed for other languages than the project's. Tick this to pick one anyway, for example a multilingual voice whose languages are listed wrong. The label says how many are hidden. A voice with unknown languages is always shown. | Off |
+
+### Several speakers
+
+Under the voice is a **Speakers** disclosure. It reads "Narration, one voice" by default. Open it to pick an audiobook, podcast, radio drama or interview format with several speakers, each with their own voice. See [Multiple Voices](Multiple-Voices) for every speaker setting, and [Other Languages](Other-Languages) for narrating in another language.
+
+## Audio Advanced
+
+**Audio Advanced** is a disclosure under the voice. Its line says what is not at the default, for example `words · intro Welcome · glossary on`.
+
+### Chunking
+
+How the narration is split into TTS requests. Split it when a provider refuses long text. It changes the number of requests, not the characters charged.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Chunking** | **Whole** sends the narration in one request. **Paragraph** sends one per paragraph. **Every N words** or **Every N characters** ends each request at a sentence end. | **Whole** |
+| **Words** / **Characters** (chunk size) | How long each request may be. Each request ends at the last whole sentence that fits, so a single longer sentence stays whole. Characters count spaces. | 500 words, or 3000 characters |
+
+Up to 10,000 words or 1,000,000 characters per chunk.
+
+### Intro and outro
+
+**Intro** and **Outro** pick Library entries read before and after the article. See [Play Title and Article](Play-Title-and-Article#intro-and-outro) and [Intros and Outros](Intros-and-Outros).
+
+### Narration Preparation
+
+Has the text model add delivery directions and sounds, such as a sigh or a laugh, following the Library narration prompt you pick. The article and captions stay unchanged.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Narration Preparation** | Pick a narration prompt from the Library, or **Off**. One text-model call per narration chunk and per intro or outro entry. | Off |
+
+It needs the Inworld TTS-2 model. With another model, the field says "Choose Inworld TTS-2 or turn preparation Off." With several speakers it works per speaker: each turn of a speaker on Inworld TTS-2 is prepared on its own, with the speaker's name and role, so every voice gets its own cues. At least one speaker must use TTS-2; turns of speakers on other voices are spoken as written. See [Multiple Voices](Multiple-Voices). When preparation is on, the row offers **Choose text generation under Article** to jump to the text model.
+
+### Pronunciation Glossary
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Use Pronunciation Glossary** | Reads names with the IPA in the article's Pronunciation Glossary, such as `Arda: /ˈɑɹdə/`, with no extra text-model call. Works with Inworld TTS-2 and TTS-2 Flash. The written text stays unchanged. | On |
+| **Also use pronunciations from my other projects** | Adds every term from your other projects' glossaries, copied when this project starts. This project's own glossary wins where they differ. Turn it off to use only this article's glossary. | On |
+
+With another provider or model the switch is greyed and says "Unavailable for this provider or model. Your saved preference is retained."
+
+To get a glossary, ask for one in your article prompt: a section in slash-delimited standard-English IPA, one `Term: /IPA/` per line, with an English approximation for foreign names. A line with sounds English lacks is read as plain text. The glossary is never narrated itself. See [Narration Aliases and Glossary](Narration-Aliases-and-Glossary).
+
+### Narration aliases
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Use narration aliases** | Says the words listed in Library → Aliases the way they are written there, such as `Dr.` as `Doctor`, with any generated voice. They are copied when the project starts. The article and captions keep the written words. | On |
+
+Manage the list in [Narration Aliases and Glossary](Narration-Aliases-and-Glossary).
+
+### Tables, figures and code
+
+An article written to be read can contain tables, pictures, equations and code. Read aloud cell by cell or symbol by symbol, they are noise.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Describe tables and figures in the narration** | The text model writes a short spoken passage for each table, picture, equation and code block (a table's pattern, what a figure or equation means, what code does), and the narration says it in its place. One extra text-model call per block, in the estimate and kept for reuse. The article and PDF keep the real table; captions show what is said. Needs a text model. | On |
+| **Leave code out** | Shown under the switch above. Drops code blocks from the narration instead of summarising each in a sentence or two. Tables, figures and equations are still described. | Off |
+| **Show tables and figures on screen** (in the **Outputs** row) | Each block the narration describes is also shown in the video while it is described: the article's own picture for a figure, a card drawn in your brand kit's title font and colour for the rest. The images take turns around them, and Shorts that include one show it upright. Drawn on this computer at no cost. Offered while the narration describes tables and figures. | On |
+
+Even with the switch off, some things are handled for you: links are read without their address, and footnote markers, the Sources Consulted section and the Pronunciation Glossary are never narrated.
+
+## Pauses between sentences and paragraphs
+
+Some voices run one sentence into the next with barely a breath. These settings add quiet where the voice's own pause is shorter. They never shorten a pause or cut a word, and the captions follow. They are in the **Video and style** row, beside **Level the volume**, and only show while the narration is generated.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **Pause between sentences (seconds)** | The least quiet after each sentence. About 0.25 s is brisk, 0.35 to 0.45 natural or documentary, 0.5 to 0.8 an audiobook's relaxed pace, 0.8 and up sleep content. 0 keeps the voice's own. | 0.4; 0 to 2 in steps of 0.05 |
+| **Pause between paragraphs (seconds)** | The least quiet at the end of a paragraph, when you want more than between sentences. Try 0.8 to 1.2 for a slower read. 0 gives paragraphs the sentence pause. | 0; 0 to 2 in steps of 0.05 |
+
+The pauses are added on this computer before the word timing, so the captions, cuts, shorts and YouTube chapters stay in step. With several speakers, the gap between turns is **Gap between turns** under Speakers instead.
+
+## Level the volume
+
+TTS comes back at a different loudness for every voice and even every request, so a joined narration can jump between quiet and loud. **Level the volume** brings every narration piece (each chunk, each intro and outro, each speaker's turn) to one loudness before they are joined, then sets the finished video, shorts and audio files to a target loudness. It runs on this computer with no API calls. It is in the **Video and style** row and shows whenever there is narration.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **Level the volume** | Turns levelling on or off for this run. A draft that never changed it follows Settings → General. | On |
+| **Video volume** | How loud the finished video and shorts are. 0 dB is −14 LUFS, what YouTube and Spotify play everything at. Peaks always stay under −1.5 dBTP. | 0 dB; −10 to +4 dB in steps of 0.5 |
+| **Audio files volume** | How loud the audio-only WAV and an audiobook's MP3 and M4B are. 0 dB is −18 LUFS, the level audiobook shops ask for. Peaks always stay under −3 dBTP. | 0 dB; −10 to +4 dB in steps of 0.5 |
+
+Type each volume in **dB** or as a **%** of the recommended level; the other box follows. −6 dB is about 50% and +4 dB about 158%. The help line under each field says the LUFS it stands for. LUFS is how loud a file sounds on average, measured the way ears hear it.
+
+## Silence at the edges and between segments
+
+Both are in the **Video and style** row and only show while there is narration.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **Silence at start and end (seconds)** | Quiet time before the narration starts and after it ends. | 2; 0 to 30 |
+| **Silence between segments (seconds)** | Quiet between the intro and the narration, and between the narration and the outro. Only matters when an intro or outro is set. Leave it empty to use the gap set in Settings. | Settings value (3 unless changed); 0 to 30 |
+
+## Add a voice under Settings → Voices
+
+The **Voice** list on Play only offers voices you have added.
+
+1. Open Settings → **Voices**.
+2. Fill in **Voice name**, **Provider**, **Voice ID** and, optionally, **Languages**.
+3. Press **Add voice**. The voice joins the table above the form.
+4. Optional: tick **Real person** on the voice's row in the table if it imitates a real person.
+
+| Field | What it does |
+| --- | --- |
+| **Voice name** | The name you pick this voice by on Play and in Edit project. Only you see it. |
+| **Provider** | The TTS service the voice ID belongs to. Only providers set up under Settings are listed. |
+| **Voice ID** | The provider's own id for the voice, copied from its voice library. It is not checked now; a wrong id fails when a run's narration uses it. |
+| **Languages** | The languages the voice speaks, as codes such as `es`, `de`. Play lists the voice only for projects in these languages. Blank asks the provider when it can say; a voice with unknown languages is offered for every language. |
+| **Real person** | Turn on for a voice cloned from, or made to sound like, a real person. Prepare upload then answers Yes to YouTube's AI use question for videos it narrates. An AI voice that imitates no one stays off. |
+
+See [Settings Reference](Settings-Reference) and [Publishing to YouTube](Publishing-to-YouTube).
+
+## What the row summary says
+
+Folded, the Narration row shows the provider and voice (or the speakers format and count), and any preparation prompt, intro and outro, for example `Inworld · Ada · intro Welcome`. With Provide it shows your file's name.
+
+## Tips
+
+- If a provider refuses long requests, switch **Chunking** to **Paragraph** or **Every 500 words**. The characters charged stay the same.
+- Listen to the narration on the project page before publishing, in Slopify's own player (see [Project Page](Project-Page#the-players)). Fix a single chunk there instead of re-running everything. See [Editing a Project](Editing-a-Project).
+- An automatic review can check the narration for missing or garbled passages. See [Reviews and Checkpoints](Reviews-and-Checkpoints).
+
+## Related pages
+
+- [Play Overview](Play-Overview)
+- [Multiple Voices](Multiple-Voices)
+- [Other Languages](Other-Languages)
+- [Narration Aliases and Glossary](Narration-Aliases-and-Glossary)
+- [Intros and Outros](Intros-and-Outros)
+- [Prompts](Prompts)
+- [Providers and Keys](Providers-and-Keys)
+- [Play Video and Style](Play-Video-and-Style)

package/dist/tutorials/Play-Outputs.md

@@ -0,0 +1,109 @@
+# Play Outputs
+
+Besides the long video, a run can make a thumbnail (or three), a YouTube description with chapters, a set of vertical shorts and a PDF of the article. Audio-only runs give you a WAV, and multi-voice runs can add an MP3 and an M4B audiobook. This page lists every output, what it costs and where to set it. The formats with more to them have their own pages.
+
+**Where to find it:** Play → **Outputs** row → **Change**. The row's summary lists what the run will make, for example `1 thumbnail · 3 shorts · YouTube description · PDF (Plain)`, or **Only the video**.
+
+## Every output at a glance
+
+| Output | Where to set it | Default | Cost |
+| --- | --- | --- | --- |
+| Long video (MP4) | **Video and style** → Source **Generate** | On | None, rendered on this computer |
+| Thumbnail | **Outputs** → Thumbnail | Off | One image call per thumbnail (plus one text call with **Prompt by LLM**) |
+| YouTube description | **Outputs** → **YouTube description** | Off | One text-model call |
+| Shorts | **Outputs** → **Shorts** | Off | One text call to pick them, plus new images for each |
+| Tables and figures on screen | **Outputs** → **Show tables and figures on screen** | On (when described) | None |
+| PDF document | **Outputs** → Document | Off | None, laid out on this computer |
+| Subtitle files (.srt, .vtt) | **Video and style** → **Subtitles** | Off | None |
+| Narration WAV | **Video and style** → Source **Off**, with narration on | | None |
+| MP3 and M4B audiobook | **Narration** → **Speakers** | Off | None |
+
+## Thumbnail
+
+The Thumbnail part has its own **Source** switch:
+
+| Source | What happens | Cost |
+| --- | --- | --- |
+| **Off** (default) | No thumbnail. | None |
+| **From prompt** | Draws the thumbnail straight from the thumbnail prompt. | One image call |
+| **Prompt by LLM** | The text model first writes the image prompt from yours, the title and the article, then the image model draws it. | One text call, then one image call |
+| **Provide** | Uses your own PNG, JPEG or WebP (**Thumbnail image**). | None |
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Thumbnail prompt** | The Library thumbnail prompt, keywords filled in. **From prompt** sends it to the image model as it is; **Prompt by LLM** gives it to the text model with the title and article to write the image prompt. | None |
+| **Thumbnails** (**1** or **3**) | **3** makes two more thumbnails from the same prompt with different compositions, for YouTube's Test & compare. Each costs one more image, so 3 thumbnails are 3 image calls. | 1 |
+
+### Make three thumbnails for Test & compare
+
+1. Set the Thumbnail **Source** to **From prompt** or **Prompt by LLM**.
+2. Pick a **Thumbnail prompt**. Write one in [Prompts](Prompts) if you have none.
+3. Set **Thumbnails** to **3**.
+
+You can remake each thumbnail on its own on the project page. The thumbnail uses the Images row's provider and model; if the video's images are not generated, the Thumbnail part shows its own **Provider**, **Model** and **Effort**. With an establishing image and **Draw the thumbnail from it too** ticked, the thumbnail is drawn with it as a reference, and it also takes cast members the title mentions. See [Play Images](Play-Images#establishing-image).
+
+## YouTube description
+
+After subtitle timing, the text model writes a description with chapters at the narration's real times, hashtags at the end, and a separate list of tags, ready to copy. It runs beside the render. It needs narration; without it the switch is disabled and says "Needs narration."
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **YouTube description** | Turns the step on. One text-model call. | Off |
+| **Description prompt** | The Library prompt the description is written from. **Built-in** asks for a short summary, 5 to 12 chapters, 3 to 5 hashtags and 15 to 25 tags. Write your own description prompt on Prompts to change the tone or add links. | Built-in |
+
+See [YouTube Description](YouTube-Description) for the result and the copy buttons.
+
+## Shorts
+
+After subtitle timing, the text model picks the best self-contained moments of the narration. Each becomes a vertical 1080×1920 clip with new images, big word-by-word captions and its own title, description and hashtags. It runs beside the render, and its images are charged like any other. It needs narration.
+
+| Option | What it does | Default / range |
+| --- | --- | --- |
+| **Shorts** | Turns shorts on. | Off |
+| **How many** | How many shorts to cut from this video. Each needs its own new images. | 3; 1 to 10 |
+| **Length** | The shortest and longest a short may run, in seconds. | 60 to 120; 15 to 180 |
+| **Shorts prompt** | The Library prompt the text model follows to pick the moments and write each short's title, description and hashtags. | Built-in |
+| **Image style** | The Library image prompt the shorts' new vertical images are drawn from. | Built-in |
+| **Title on screen** (under **More shorts options**) | Keeps the short's title at the top for the whole clip, large and bold in the caption font. | On |
+| **Speed** | Plays each short faster than the narration, with the pitch kept. | 1.00×; 1.00× to 1.25× in steps of 0.05 |
+| **Music volume** | How loud the background music plays under every short; it dips while the narrator speaks. Only used with a music file. | 15; 0 to 100% |
+| **Full video link** | Each short's description ends with a line pointing to the full video. Without a link, the line says `[PASTE THE FULL VIDEO LINK HERE]`. | Empty |
+| **Background music (optional)** | An audio file, looped if shorter than a short. | None |
+
+See [Shorts](Shorts) for how moments are picked and how to remake a short.
+
+## Show tables and figures on screen
+
+Shown while the narration describes tables and figures. Each described table, figure, equation and code block is also shown in the video while it is described. On by default. See [Play Narration](Play-Narration#tables-figures-and-code).
+
+## PDF document
+
+The Document part lays out a PDF of the article and title on this computer, in the theme you pick. It needs no provider and costs nothing.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| Document **Source** | **Off** or **Generate**. | Off |
+| **Theme** | How the PDF looks: the built-in **Plain** theme, or one of yours from Library → Documents. A theme of yours is copied into the project, so editing it later leaves this project alone until you pick it again. **Edit themes** opens the list. | Plain, or the channel's brand kit theme |
+
+See [PDF Documents](PDF-Documents) and [Document Themes](Document-Themes).
+
+## Audio files
+
+- **Narration WAV.** Set the video **Source** to **Off** in **Video and style** while narration is on. The line beside the switch reads "Combined WAV export with narration and segment gaps". The WAV is mastered to the **Audio files volume** when **Level the volume** is on.
+- **MP3 and M4B.** With several speakers, tick **Also make MP3 and M4B files with chapter markers** under **Narration** → **Speakers**. The M4B is an audiobook file with a chapter marker at each chapter. Both are made on this computer at no provider cost. See [Multiple Voices](Multiple-Voices).
+
+## Tips
+
+- The YouTube description and shorts need subtitle timing but not burned-in captions; you can leave **Subtitles** Off.
+- Automatic reviews can check the thumbnail at phone size and each short's images. See [Reviews and Checkpoints](Reviews-and-Checkpoints).
+- A PDF is free, so switch it on whenever the article is worth reading on its own.
+
+## Related pages
+
+- [Play Overview](Play-Overview)
+- [Shorts](Shorts)
+- [YouTube Description](YouTube-Description)
+- [PDF Documents](PDF-Documents)
+- [Document Themes](Document-Themes)
+- [Multiple Voices](Multiple-Voices)
+- [Publishing to YouTube](Publishing-to-YouTube)