@gentbajko/slopify 4.0.0 → 4.2.0

package/dist/tutorials/Create-Images.md

@@ -0,0 +1,165 @@
+# Create: Images
+
+The images are the pictures your video shows while the narration plays. On Create you pick who draws them, which image prompts (styles) they come from and how many each makes, and optionally an establishing image that keeps characters and style the same. You get a set of images, drawn in the video's frame shape, played in order.
+
+**Where to find it:** Create → **Images** row → **Change**.
+
+## Choose where the images come from
+
+The row starts with an **Images** switch:
+
+| Choice | What happens | Cost |
+| --- | --- | --- |
+| **Made by AI (paid)** (default) | Draws images from the ticked image prompts, one image call each. | Per image, by the service |
+| **My own images** | Uses your own PNG, JPEG or WebP files (**Your images, in the order they play**). | None |
+| **None** | No images. This turns the video off too. | None |
+
+### Use your own images
+
+1. Set **Images** to **My own images**.
+2. Pick the files under **Your images, in the order they play**. Each is numbered in the order it plays.
+3. Remove a file with its remove button, or attach one again 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 Make the video.
+
+## Pick the image service and model
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Service** (under **Images by**) | Who draws the images, the thumbnail and the shorts' pictures: a keyed service billed per image (fal.ai, Replicate, OpenAI, Google), or a tool you are signed in to (Codex CLI). Each service in the list says when it has **No key** or is **Not found**. When none has a key, the line under it offers **Add an image key ↗**, or **Set Images to None**. | Your template's, or a service with a saved key |
+| **Model** | The service's image model. Models differ in quality, speed and price per image; the estimate in the rail shows what this run costs. **Type a model ID…** at the end of the list lets you type one. | The service's 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 service clears the model.
+
+### Drawing with the Codex CLI
+
+With **Codex CLI** as the image service, 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 styles
+
+1. Under **Image prompts**, tick the image prompts that should draw the video's images. Each one shows the first sentence of its text, so you can see what it draws.
+2. Type in each ticked prompt's box how many images it makes, 1 to 20.
+3. Check the total under the list, for example **16 of at most 60 images · each is one paid image call.**
+
+| Rule | Value |
+| --- | --- |
+| Images per prompt | 1 to 20 (a freshly ticked prompt starts on 16 for a video) |
+| Images per run, typed | 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 call. A prompt that has been deleted since this draft picked it shows **No longer in Prompts · untick to remove**. With no image prompts at all, the row says to write one on Prompts. See [Prompts](Prompts).
+
+### Photorealistic prompts
+
+An image prompt has a **Draws photorealistic pictures** tick in its editor. Turn it on when the prompt's style looks like real photos or film. Copy for YouTube Studio then answers Yes to YouTube's question about altered or synthetic content for videos and shorts drawn with it. Leave it off for painterly or illustrated styles. It is set on the prompt, not on Create: open **Prompts** → **Image** → 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** (keeps characters and style the same) | **Off** (each image is drawn on its own), **Drawn from an image prompt** (one more image call) or **Upload mine** (your own PNG or JPEG, **Establishing image file**). | Off |
+| **Establishing prompt** | The image prompt that draws it, keywords filled like the others. Describe the characters, setting and style every other image should share. | None |
+| **Use it as a reference for the thumbnail 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. Shown while a thumbnail is on (in the Extras row). | On |
+
+Changing the establishing image later marks the images drawn from it as outdated. When you upload the establishing image, the style preview 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 **Drawn from an image prompt** or **Upload mine**.
+2. For a drawn one, pick the **Establishing prompt**. For **Upload mine**, pick the file.
+3. Leave **Use it as a reference for the thumbnail too** ticked if the thumbnail should match.
+
+## The channel's cast
+
+The video's channel 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](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): 30 images, 26 more than the prompts' 4."
+
+How the count is worked out:
+
+- The length is your own article's word count, or else the **Expected length** in the 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 **Video and style** → **Images and cuts**) 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.
+
+## Scenes from the article
+
+Without it, every image of a prompt is drawn from the same text, so three images of one prompt tend to show the same picture three times. **Scenes from the article** gives every image its own moment.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Scenes from the article** | Before the images are drawn, the AI writer reads the article once and writes a short scene for each image. Scene 1 comes from the article's opening and the last from its ending, in the order the images are shown. Each image is drawn from its prompt with its scene added. One more AI call per run. | Off |
+
+Where the scene goes:
+
+- A prompt with `{{Scene}}` gets the scene there, for example a line `Scene: {{Scene}}` under the prompt's first sentence. `{{Scene}}` is never a keyword to fill in: Slopify writes it.
+- A prompt without it gets the scene as a line of its own after its first paragraph, so any prompt works unchanged.
+- With the switch off, a line holding `{{Scene}}` is left out and the prompt is drawn as it always was.
+- A **thumbnail** prompt with `{{Scene}}` gets a scene from a call of its own (one more AI call, in the Thumbnail step, so changing the thumbnail never makes the images again): the article's most striking moment, the one that would make someone click, taken from anywhere in the article. With **How many thumbnails** set to 3, each thumbnail gets a different moment, so the A/B test compares ideas as well as compositions. A thumbnail prompt without `{{Scene}}` is drawn as it always was.
+
+A prompt using `{{Slopify_Scene}}`, `{{Slopify_Setting}}` or `{{Slopify_Mood}}` gets its scene even with the switch off, and the switch shows it as on for that prompt. `{{Slopify_Setting}}` adds the era and place of each moment, so the picture stays true to its period, and `{{Slopify_Mood}}` its feeling, for light and color; both are written by the same call. See [Keywords Slopify fills](Keywords-Slopify-Fills#per-picture).
+
+The style, composition and everything else in the prompt stay as written; only the scene changes from image to image. The scenes are written once the article exists, and each image waits for them. Switching it on or off in a project's **Edit settings** makes the images again.
+
+## Looks looked up: {{Appearance}}
+
+An image model draws a named figure from whatever it half remembers, so the same character can look different in every image. Put `{{Appearance}}` in an image, thumbnail, establishing or shorts image prompt, for example a line `Looks: {{Appearance}}`, and Slopify looks the looks up instead.
+
+- Once the article exists, one call to the AI writer **searches the web** for how the video's subject and every named character in the article look: build, face, clothing, colors and the marks that make them recognizable. Where depictions disagree, it describes the most iconic one.
+- With **Scenes from the article** on, each picture gets the looks of the figures its scene names (up to three besides the subject), so a scene of a place or of someone else isn't redrawn with the subject in it; a scene that names no one leaves the looks line out. A thumbnail always gets the subject's look. Without scenes, every picture gets the subject's look.
+- There is no switch: a prompt with `{{Appearance}}` turns it on, and prompts without it are drawn as they always were. `{{Appearance}}` is never a keyword to fill in.
+- It costs one more AI call per run, with web search. The pictures that use it wait for it.
+- `{{Slopify_Appearance}}` is the new name of `{{Appearance}}` and means exactly the same.
+
+## How long each image stays on screen
+
+**Seconds per image** (1 to 600, default 15) is in **Video and style** → **Images and cuts**, beside **Zoom**, **Motion** and **Cuts**. 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 [Video and style](Create-Video-and-Style#images-and-cuts).
+
+## The thumbnail and the shorts
+
+The thumbnail and the shorts' images use the same image service and model. If the video's images are not made by AI but the thumbnail is, the thumbnail gets its own **Drawn by** service and model in the **Extras** row. See [Extras](Create-Extras) and [Shorts](Shorts).
+
+## What the row says
+
+Folded, the Images row says what will be drawn, for example `16 images from “Sleep lore · Scene”, made by fal.ai (FLUX.2), all in the look of one establishing image.` With your own images it says how many there are.
+
+## Tips
+
+- Keep one style across the video with an establishing image, instead of repeating the style in every image prompt.
+- Picture checks can look at each image for malformed hands, stray text and a match with its brief. They need Claude Code or Codex as the checker. See [Pauses and Checks](Reviews-and-Checkpoints).
+- After the run, you can add, remove or make single images again on the project page. See [Editing a Project](Editing-a-Project).
+
+## Related pages
+
+- [Create Overview](Create-Overview)
+- [Prompts](Prompts)
+- [Keywords Slopify fills](Keywords-Slopify-Fills)
+- [Cast](Cast-Library)
+- [Channels](Channels)
+- [Models](Models)
+- [Costs and Run Cost](Costs-and-Run-Cost)
+- [Video and style](Create-Video-and-Style)
+- [Extras](Create-Extras)

package/dist/tutorials/Create-Narration.md

@@ -0,0 +1,178 @@
+# Create: Narration
+
+The narration is the article read aloud by an AI voice. On Create you pick the voice service, its model and the voice, and fine-tune how the text is split, prepared and pronounced. You get a narration track that the captions, cuts, chapters and shorts are all timed from.
+
+**Where to find it:** Create → **Narration** row → **Change**. The pauses, the volume levelling and the silences sit in Create → **Video and style** → **Sound polish**; they are described here because they shape the narration.
+
+## Choose where the narration comes from
+
+The row starts with a **Narration** switch:
+
+| Choice | What happens | Cost |
+| --- | --- | --- |
+| **AI voice (paid per character)** (default) | A voice service reads the article aloud. | Charged by the service per character |
+| **My own audio file** | 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 "None: a silent video." | None |
+
+With **My own audio file**, the file is used as it is; include any intro and outro in it. 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 it on **AI voice (paid per character)**.
+2. Under **Read by**, pick the **Service**. Each service in the list says when it has **No key** or is **Not found**.
+3. Pick the **Model**.
+4. Pick a **Voice**. When none of the listed services has a key, the line under it offers **Add a voice key ↗**, or **Set Narration to Off**.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Service** | The voice service, charged per character of text: ElevenLabs, OpenAI, Cartesia, Inworld, Google Gemini, or **System voice**, your computer's own speech, which is free (it says **Not found** when no speech program is installed; see [the system voice](Providers-and-Keys#the-system-voice)). Changing it clears the model and voice. | The voice service your template or Settings picks |
+| **Model** | The service's voice model. Models differ in quality, languages, speed and price per character. Narration preparation needs Inworld TTS-2. The line under it says whether the model was checked, with **Manage models ↗**. | The service's default |
+| **Voice** | Who reads the narration: the voices you added under Settings → Voices for this service, for the project's language. With several speakers, this voice reads only the intro and outro. | None |
+| **Show all voices** | Shown when some voices are hidden because they are listed for other languages. Tick it to pick one anyway, for example a multilingual voice whose languages are listed wrong. A voice with unknown languages is always shown. | Off |
+
+### Hear a sample
+
+**Sample of your text in this voice** folds out a **Passage** box and **Hear the sample**. It reads one passage of up to 300 characters in the picked voice, at the service's price for those characters (free with the system voice). The article's pronunciation glossary and narration preparation are not applied, and the sample is not reused in the run. Until a voice is picked and a passage typed, the line beside **Hear the sample** says which is missing.
+
+### Speakers
+
+Under the voice is the **Speakers** fold. It reads **One voice** by default. Open it to pick a **Format**: **Narration (one voice)**, **Audiobook**, **Podcast**, **Radio drama** or **Interview**, with several speakers, each with their own voice. Picking **Audiobook** or **Podcast** at the top of Create sets this for you. See [Multiple Voices](Multiple-Voices) for every speaker setting, and [Other Languages](Other-Languages) for narrating in another language.
+
+## More narration settings
+
+**More narration settings** is a fold under the voice. Its line says what is set, for example **Read as one piece, tables and figures described**.
+
+### Split the narration
+
+How the narration is split into voice requests. Split it when a service refuses long text. It changes the number of requests, not the characters charged.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Split the narration by** | **Nothing (one piece)** sends the narration in one request. **Paragraph** sends one per paragraph. **Every 500 words** or **Every 3000 characters** ends each request at a sentence end. | **Nothing (one piece)** |
+| **Words** / **Characters** | 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 request.
+
+### Intro and outro
+
+An intro is read before the article and an outro after it. Both are saved under **Prompts** → **Intros** and **Outros**.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Intro** | Read before the article. One saved as **Say these exact words** is read as written; one saved as **Let the AI write it from these instructions** is written for each video, one extra AI call. | Off |
+| **Outro** | Read after the article, such as a sign-off. Exact words or AI-written, as above. | Off |
+
+1. Open the **Narration** row and press **Change**.
+2. Open **More narration settings**.
+3. Pick an **Intro** and an **Outro**, or leave them **Off**.
+4. Optional: set **Silence between segments** in **Video and style** → **Sound polish** 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 voice under **Read by** reads the intro and outro. Your own audio file must already include any intro and outro. See [Intros and Outros](Intros-and-Outros).
+
+### Narration preparation
+
+Has the AI writer add delivery directions and sounds, such as a sigh or a laugh, before the voice reads, following the narration prompt you pick. The words stay the same.
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Narration preparation** | Pick a narration prompt, or **Off**. One AI call per narration piece and per intro or outro. **New narration prompt** writes one in a drawer beside Create and picks it. | Off |
+
+It needs the Inworld TTS-2 model. 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 nothing earlier needs a writer (your own text, say), **Written by** appears in this row.
+
+### Pronunciation Glossary
+
+| Option | What it does | Default |
+| --- | --- | --- |
+| **Use pronunciations** | Shown only for voices that read IPA. Reads names with the IPA they are given, with no extra AI call: your **Name pronunciations** list first, so a listed name sounds the same in every video, then the article's own Pronunciation Glossary, such as `Arda: /ˈɑɹdə/`. 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 service or model the tick is not shown; your choice is kept for when you pick an Inworld TTS-2 voice.
+
+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 your pronunciation list** | Says the words listed under Settings → Voices → **Pronunciation** the way they are written there, such as `Dr.` as `Doctor`, with any AI 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 AI writer 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 AI call per block, in the estimate and kept for reuse. The article and PDF keep the real table; captions show what is said. | On |
+| **Leave code out** | Shown under the switch above. Drops code blocks from the narration instead of summing each up in a sentence or two. Tables, figures and equations are still described. | Off |
+| **Also show them on screen** | Shown under the switch above. 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 color for the rest. The images take turns around them, and shorts that include one show it upright. Drawn on this computer at no cost. | 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 **Video and style** → **Sound polish**, and only show while the narration is an AI voice.
+
+| 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 leaves 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 keeps 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.
+
+**Soften breaths**, **Soften S sounds** and **Level each sentence** in the same fold polish the voice itself; see [Video and style](Create-Video-and-Style#sound-polish).
+
+## Level the volume
+
+AI voices come 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 request, 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 service calls. It is in **Video and style** → **Sound polish** 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 → Production defaults. | 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 sound-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 line under each field says what 0 dB is matched to. 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 **Video and style** → **Sound polish** 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 Create only offers voices you have added.
+
+1. Open Settings → **Voices**.
+2. Under **Add a voice**, pick the **Voice service**.
+3. Pick a **Voice** from the service's list, or **A voice of my own (paste its ID)** and paste the ID from the service's voice library.
+4. Type a **Name** (how you pick it on Create) and, optionally, **Languages it speaks**.
+5. Press **Add voice**. The voice joins the table above the form.
+
+On the voice's row in the table, turn on **Sounds like a real person** if it was cloned from, or made to sound like, someone real: Copy for YouTube Studio then answers Yes to YouTube's question about altered or synthetic content for videos it narrates. See [Settings Reference](Settings-Reference#voices) and [Publishing to YouTube](Publishing-to-YouTube).
+
+## What the row says
+
+Folded, the Narration row says who reads it, for example `Read by Ada, an Inworld voice, with the “Welcome” intro.`, or the speakers' format and count. With your own file it names the file.
+
+## Tips
+
+- If a service refuses long requests, set **Split the narration by** to **Paragraph** or **Every 500 words**. The characters charged stay the same.
+- Listen to the narration on the project page before publishing. Fix a single piece there instead of making everything again. See [Editing a Project](Editing-a-Project).
+- An AI check can listen for missing or garbled passages. See [Pauses and Checks](Reviews-and-Checkpoints).
+
+## Related pages
+
+- [Create Overview](Create-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)
+- [Keys and Services](Providers-and-Keys)
+- [Video and style](Create-Video-and-Style)

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)