@gentbajko/slopify 3.19.0 → 3.21.0

package/dist/slices/narration/breaths.js

@@ -2,19 +2,20 @@ import { mkdirSync, rmSync } from "node:fs";
 import { open, stat } from "node:fs/promises";
 import { join } from "node:path";
 import { runFfmpeg } from "../video/ffmpeg.js";
-import { breathRate, findBreaths, muteChunk } from "./breaths-detect.js";
-// Remove breaths, made in the join (`breaths-model.ts` says why there). Each narration piece is
+import { breathRate, scanBreaths, softenChunk } from "./breaths-detect.js";
+// Soften breaths, made in the join (`breaths-model.ts` says why there). Each narration piece is
 // decoded by ffmpeg to 16-bit mono PCM at 48 kHz in a file beside it, read once to find its
-// breaths (`breaths-detect.ts`) and once more to write it again as a WAV with them muted. Both
+// breaths (`breaths-detect.ts`) and once more to write it again as a WAV with them turned down. Both
 // reads go in chunks, so a long piece never sits in memory whole, and the detector yields to
 // the event loop as it goes, so the server stays responsive while it works. A piece without a
 // breath is written again all the same: the join takes every piece in the one format.
 // ceiling: one second of audio per read.
 const chunkSamples = breathRate;
-export async function removeBreaths(run, files, directory) {
+export async function softenBreaths(run, files, directory) {
     mkdirSync(directory, { recursive: true, mode: 0o700 });
     const written = [];
-    let removed = 0;
+    let softened = 0;
+    let skipped = 0;
     for (const [index, file] of files.entries()) {
         run.signal.throwIfAborted();
         const name = `breaths-${String(index + 1).padStart(4, "0")}`;
@@ -28,22 +29,23 @@ export async function removeBreaths(run, files, directory) {
                 log: run.log,
                 onProgress: () => { },
             });
-            const stretches = await findBreaths(pcmChunks(raw));
+            const scan = await scanBreaths(pcmChunks(raw));
             run.signal.throwIfAborted();
-            await writeMuted(raw, output, stretches);
-            removed += stretches.length;
+            await writeSoftened(raw, output, scan.stretches);
+            softened += scan.stretches.length;
+            skipped += scan.skipped.length;
         }
         catch (error) {
             if (run.signal.aborted)
                 throw error;
-            throw new Error(`Remove breaths could not process narration piece ${String(index + 1)} (${error instanceof Error ? error.message : String(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Remove breaths in Edit project → Pauses and volume and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
+            throw new Error(`Soften breaths could not process narration piece ${String(index + 1)} (${error instanceof Error ? error.message : String(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften breaths in Edit project → Pauses and volume and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
         }
         finally {
             rmSync(raw, { force: true });
         }
         written.push(output);
     }
-    return { files: written, removed };
+    return { files: written, softened, skipped };
 }
 export function decodeArgs(input, output) {
     return [
@@ -94,7 +96,7 @@ async function readChunk(handle) {
         out[at] = buffer.readInt16LE(at * 2);
     return out;
 }
-async function writeMuted(raw, output, stretches) {
+async function writeSoftened(raw, output, stretches) {
     const size = (await stat(raw)).size;
     const bytes = size - (size % 2);
     const target = await open(output, "w", 0o600);
@@ -102,9 +104,9 @@ async function writeMuted(raw, output, stretches) {
         await target.write(wavHeader(bytes));
         let offset = 0;
         for await (const chunk of pcmChunks(raw)) {
-            const muted = muteChunk(chunk, offset, stretches);
+            const soft = softenChunk(chunk, offset, stretches);
             // Typed arrays are little-endian on every platform Slopify ships for, as WAV is.
-            await target.write(Buffer.from(muted.buffer, muted.byteOffset, muted.byteLength));
+            await target.write(Buffer.from(soft.buffer, soft.byteOffset, soft.byteLength));
             offset += chunk.length;
         }
     }

package/dist/slices/narration/clean-pieces.js

@@ -0,0 +1,69 @@
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { runFfmpeg } from "../video/ffmpeg.js";
+import { softenBreaths } from "./breaths.js";
+import { deEsser } from "./breaths-model.js";
+export async function cleanPieces(run, files, directory, cleaning) {
+    if (!cleaning.breaths && !cleaning.deEss)
+        return undefined;
+    const breaths = cleaning.breaths
+        ? await softenBreaths(run, files, join(directory, "breaths"))
+        : undefined;
+    const soft = breaths?.files ?? files;
+    const cleaned = cleaning.deEss ? await deEssPieces(run, soft, join(directory, "deess")) : soft;
+    return {
+        files: cleaned,
+        ...(breaths === undefined
+            ? {}
+            : { breaths: { softened: breaths.softened, skipped: breaths.skipped } }),
+    };
+}
+export async function deEssPieces(run, files, directory) {
+    mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const written = [];
+    for (const [index, file] of files.entries()) {
+        run.signal.throwIfAborted();
+        const output = join(directory, `deess-${String(index + 1).padStart(4, "0")}.wav`);
+        try {
+            await runFfmpeg({
+                bin: run.bin,
+                args: deEssArgs(file, output),
+                signal: run.signal,
+                log: run.log,
+                onProgress: () => { },
+            });
+        }
+        catch (error) {
+            if (run.signal.aborted)
+                throw error;
+            throw new Error(`Soften S sounds could not process narration piece ${String(index + 1)} (${error instanceof Error ? error.message : String(error)}), so the narration can't be joined together. Use Try again; if it fails again, turn off Soften S sounds in Edit project → Pauses and volume and use Save changes, then use Download diagnostics in Settings and report it.`, { cause: error });
+        }
+        written.push(output);
+    }
+    return written;
+}
+export function deEssFilter() {
+    return `deesser=i=${String(deEsser.intensity)}:m=${String(deEsser.max)}:f=${String(deEsser.frequency)}`;
+}
+// The piece's own rate and channels, written as 16-bit WAV like the other cleaned pieces.
+export function deEssArgs(input, output) {
+    return [
+        "-hide_banner",
+        "-nostdin",
+        "-loglevel",
+        "error",
+        "-nostats",
+        "-y",
+        "-i",
+        input,
+        "-map",
+        "0:a:0",
+        "-af",
+        deEssFilter(),
+        "-c:a",
+        "pcm_s16le",
+        "-f",
+        "wav",
+        output,
+    ];
+}

package/dist/slices/play-drafts/convert.js

@@ -4,7 +4,7 @@ import { runDraftSchema } from "../admission/schema.js";
 import { draftDocumentThemeOf } from "../document/model.js";
 import { defaultExpectedWords, everyMinutesMax, everyMinutesMin, expectedWordsMax, imagesPerHourMax, imagesPerHourMin, perHourFromMinutes, wordCount, } from "../images/scale.js";
 import { defaultLoudness, loudnessOfForm, } from "../loudness/model.js";
-import { breathsOfForm } from "../narration/breaths-model.js";
+import { breathsOfForm, deEssOfForm } from "../narration/breaths-model.js";
 import { pausesOfForm } from "../narration/pauses-model.js";
 import { reviewSettingsFromForm } from "../reviews/model.js";
 import { stageMakesItems } from "../reviews/rules.js";
@@ -293,8 +293,9 @@ export function toAdmissionDraft(input) {
         ...pickLoudness(sources.audio, loudnessOfForm(form.loudness, input.loudness ?? defaultLoudness)),
         // Pauses between sentences: the default for a new run, with a narration to pace.
         ...(sources.audio === "generate" ? pausesOfForm(form) : {}),
-        // Remove breaths: only while on, with a narration made here to clean.
+        // Soften breaths and Soften S sounds: only while on, with a narration made here to clean.
         ...(sources.audio === "generate" ? breathsOfForm(form) : {}),
+        ...(sources.audio === "generate" ? deEssOfForm(form) : {}),
         edgeSilenceSeconds: measure("edgeSilenceSeconds", sources.audio !== "off", defaultEdgeSilenceSeconds, edgeSilenceSecondsProblem),
     };
     const parsed = runDraftSchema.safeParse(draft);

package/dist/slices/play-drafts/schema.js

@@ -86,9 +86,10 @@ export const playDraftFormSchema = z
     // paragraph minimum (`narration/pauses-model.ts`).
     sentencePause: text.optional(),
     paragraphPause: text.optional(),
-    // Remove breaths (`narration/breaths-model.ts`). Absent on drafts and templates saved
-    // before it: off.
+    // Soften breaths and Soften S sounds (`narration/breaths-model.ts`). Absent on drafts and
+    // templates saved before them: off.
     removeBreaths: z.boolean().optional(),
+    deEss: z.boolean().optional(),
     // Absent on drafts and templates saved before the YouTube description: off, built-in prompt.
     youtubeDescription: z.boolean().optional(),
     showFigures: z.boolean().optional(),

package/dist/slices/project-templates/from-project.js

@@ -237,6 +237,7 @@ export function documentFromProject(deps, revision) {
                 ? {}
                 : { paragraphPause: String(config.paragraphPauseSeconds) }),
             ...(config.removeBreaths === true ? { removeBreaths: true } : {}),
+            ...(config.deEss === true ? { deEss: true } : {}),
             imagePrompts,
             ...(config.imageScale === undefined ? {} : { imageScale: imageScaleForm(config.imageScale) }),
             ...(config.imageScenes === true ? { imageScenes: true } : {}),

package/dist/slices/rebuild/preview-details.js

@@ -159,7 +159,8 @@ function inputChanges(parent, view) {
     add("Show tables and figures on screen", before.showFigures === true ? "On" : "Off", after.showFigures === true ? "On" : "Off");
     add("Pause between sentences (seconds)", before.sentencePauseSeconds ?? 0, after.sentencePauseSeconds ?? 0);
     add("Pause between paragraphs (seconds)", before.paragraphPauseSeconds ?? 0, after.paragraphPauseSeconds ?? 0);
-    add("Remove breaths", before.removeBreaths === true ? "On" : "Off", after.removeBreaths === true ? "On" : "Off");
+    add("Soften breaths", before.removeBreaths === true ? "On" : "Off", after.removeBreaths === true ? "On" : "Off");
+    add("Soften S sounds", before.deEss === true ? "On" : "Off", after.deEss === true ? "On" : "Off");
     add("Level the volume", before.loudness === undefined ? "Off" : loudnessSummary(before.loudness), after.loudness === undefined ? "Off" : loudnessSummary(after.loudness));
     add("YouTube description", before.youtubeDescription === true ? "On" : "Off", after.youtubeDescription === true ? "On" : "Off");
     add("Description prompt", before.descriptionPrompt, after.descriptionPrompt);

package/dist/slices/rebuild/recipe-breaths.js

@@ -1,16 +1,26 @@
-import { breathsOn } from "../narration/breaths-model.js";
-// Remove breaths (`narration/breaths-model.ts`) is made in the narration joins, so a join carries
-// it in its values, after the pauses when they are set. Nothing at all while it is off, so
-// every join made before it keeps its fingerprint. The levelled join copies these values, so it
-// removes the same breaths.
-export const breathsValue = "breaths-v1";
+import { breathsOn, deEsser, deEssOn } from "../narration/breaths-model.js";
+// Soften breaths and Soften S sounds (`narration/breaths-model.ts`) are made in the narration
+// joins, so a join carries them in its values, after the pauses when they are set. Nothing at
+// all while they are off, so every join made before them keeps its fingerprint. The levelled
+// join copies these values, so it softens the same.
+// v2: 3.19.0's v1 muted breaths to silence and could clip word edges; its joins are remade.
+export const breathsValue = "breaths-v2";
+export const deEssValue = "deess-v1";
 export function breathValues(config) {
-    return breathsOn(config) ? [[breathsValue]] : [];
+    return [
+        ...(breathsOn(config) ? [[breathsValue]] : []),
+        ...(deEssOn(config) ? [[deEssValue, deEsser.intensity, deEsser.max, deEsser.frequency]] : []),
+    ];
 }
 // Whether a join's values ask for it: any value after the join's own two.
 export function breathsAsked(values) {
-    return (Array.isArray(values) &&
-        values
-            .slice(2)
-            .some((value) => Array.isArray(value) && value.length === 1 && value[0] === breathsValue));
+    return laterValues(values).some((value) => value.length === 1 && value[0] === breathsValue);
+}
+export function deEssAsked(values) {
+    return laterValues(values).some((value) => value[0] === deEssValue);
+}
+function laterValues(values) {
+    return Array.isArray(values)
+        ? values.slice(2).filter((value) => Array.isArray(value))
+        : [];
 }

package/dist/slices/rebuild/runtime-local.js

@@ -5,14 +5,14 @@ import { referenceKey, thumbnailVariant } from "../admission/model.js";
 import { plainText } from "../article/plain.js";
 import { splitEndMatter } from "../article/split.js";
 import { levelPieces } from "../loudness/level-pieces.js";
-import { removeBreaths } from "../narration/breaths.js";
+import { cleanPieces } from "../narration/clean-pieces.js";
 import { joinNarration } from "../narration/concat.js";
 import { applyPauses, planPieces } from "../narration/pauses.js";
 import { allocateAsset, discardPreparedAssets, sealAsset } from "../storage/assets.js";
 import { outputPath } from "../storage/layout.js";
 import { probeDurationMs, runFfmpeg } from "../video/ffmpeg.js";
 import { turnJoinArgs } from "../voices/join.js";
-import { breathsAsked } from "./recipe-breaths.js";
+import { breathsAsked, deEssAsked } from "./recipe-breaths.js";
 import { levelOperation } from "./recipe-loudness.js";
 import { executeFigureCard } from "./runtime-figure-card.js";
 import { publishNarrationText } from "./runtime-narration-text.js";
@@ -136,27 +136,28 @@ async function concatenate(deps, context, piece) {
     try {
         const run = { bin: deps.ffmpeg, log: deps.log, signal: context.signal };
         const levelled = level ? await levelPieces(run, files, piecesDirectory) : undefined;
-        // Remove breaths: muted in what is joined, before the pauses; nothing moves, so the pauses
-        // are still planned from the pieces as spoken.
-        const breathless = breathsAsked(values)
-            ? await removeBreaths(run, levelled?.files ?? files, join(piecesDirectory, "breaths"))
-            : undefined;
-        if (breathless !== undefined)
+        // Soften breaths, then Soften S sounds: made in what is joined, before the pauses; nothing
+        // moves, so the pauses are still planned from the pieces as spoken.
+        const cleaned = await cleanPieces(run, levelled?.files ?? files, piecesDirectory, {
+            breaths: breathsAsked(values),
+            deEss: deEssAsked(values),
+        });
+        if (cleaned?.breaths !== undefined)
             deps.log.write("info", "narration.breaths", {
                 projectId: context.work.projectId,
                 stage: "audio",
-                detail: `${String(breathless.removed)} breaths muted in ${String(files.length)} pieces`,
+                detail: `${String(cleaned.breaths.softened)} breaths softened, ${String(cleaned.breaths.skipped)} left alone (a word sound in them) in ${String(files.length)} pieces`,
             });
         // Pauses between sentences: planned from the pieces as spoken, made in what is joined.
         const pauses = pausesIn(values);
         const paced = pauses === undefined
             ? undefined
-            : await applyPauses(run, breathless?.files ?? levelled?.files ?? files, paceScaled(await planPieces(run, files.map((file, at) => ({
+            : await applyPauses(run, cleaned?.files ?? levelled?.files ?? files, paceScaled(await planPieces(run, files.map((file, at) => ({
                 file,
                 text: pieceText(plan.recipes.find((one) => one.key === recipe.dependsOn[at])),
                 next: pauses.next[at] ?? "end",
             })), pauses.settings), operation === "concat-turns-v1" ? values : undefined), join(piecesDirectory, "paced"));
-        const joined = paced?.files ?? breathless?.files ?? levelled?.files ?? files;
+        const joined = paced?.files ?? cleaned?.files ?? levelled?.files ?? files;
         const durationMs = operation === "concat-turns-v1"
             ? await joinTurns(run, joined, values, pending.absolutePath)
             : await joinNarration({ bin: deps.ffmpeg, log: deps.log }, {
@@ -164,7 +165,7 @@ async function concatenate(deps, context, piece) {
                 output: pending.absolutePath,
                 listPath: join(dirname(pending.absolutePath), "parts.txt"),
                 signal: context.signal,
-                reencode: level || paced !== undefined || breathless !== undefined,
+                reencode: level || paced !== undefined || cleaned !== undefined,
             });
         rmSync(piecesDirectory, { recursive: true, force: true });
         context.signal.throwIfAborted();

package/dist/slices/settings/model.js

@@ -1,4 +1,5 @@
 // The provider catalogue and the settings domain types.
+import { defaultEnglishSubtitleModel, } from "../../kernel/ports/subtitles.js";
 import { defaultLoudness } from "../loudness/model.js";
 // The three families are the three ports, so the set is named beside them.
 export { providerFamilies } from "../../kernel/ports/model.js";
@@ -135,4 +136,5 @@ export const defaultSettings = {
     silenceGapSeconds: 3,
     appearance: "system",
     loudness: defaultLoudness,
+    subtitleModel: defaultEnglishSubtitleModel,
 };

package/dist/slices/settings/playback.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { englishSubtitleModels } from "../../kernel/ports/subtitles.js";
 import { silenceGapSecondsMax } from "../admission/rules.js";
 import { loudnessFields } from "../loudness/model.js";
 import { appearances, defaultSettings } from "./model.js";
@@ -8,8 +9,10 @@ import { readSetting, writeSetting } from "./repo.js";
 const silenceGapKey = "silenceGapSeconds";
 const appearanceKey = "appearance";
 const loudnessKey = "loudness";
+const subtitleModelKey = "subtitleModel";
 const silenceGapValue = z.number().int().min(0).max(silenceGapSecondsMax);
 const appearanceValue = z.enum(appearances);
+const subtitleModelValue = z.enum(englishSubtitleModels);
 const loudnessValue = z.object({
     enabled: z.boolean(),
     videoLufs: z.number(),
@@ -20,6 +23,7 @@ export function readSettings(deps) {
         silenceGapSeconds: parsed(deps, silenceGapKey, silenceGapValue, defaultSettings.silenceGapSeconds),
         appearance: parsed(deps, appearanceKey, appearanceValue, defaultSettings.appearance),
         loudness: parsed(deps, loudnessKey, loudnessValue, defaultSettings.loudness),
+        subtitleModel: parsed(deps, subtitleModelKey, subtitleModelValue, defaultSettings.subtitleModel),
     };
 }
 export function saveSettings(deps, settings) {
@@ -39,12 +43,19 @@ export function saveSettings(deps, settings) {
     else {
         fields.push(...loudnessFields(settings.loudness));
     }
+    if (!subtitleModelValue.safeParse(settings.subtitleModel).success) {
+        fields.push({
+            field: "subtitleModel",
+            message: "Choose Most accurate, Balanced or Smallest in Settings → Production defaults → Subtitle timing model.",
+        });
+    }
     if (fields.length > 0) {
         return { ok: false, fields };
     }
     writeSetting(deps.db, silenceGapKey, JSON.stringify(settings.silenceGapSeconds));
     writeSetting(deps.db, appearanceKey, JSON.stringify(settings.appearance));
     writeSetting(deps.db, loudnessKey, JSON.stringify(settings.loudness));
+    writeSetting(deps.db, subtitleModelKey, JSON.stringify(settings.subtitleModel));
     return { ok: true, settings };
 }
 // A stored value is JSON, and a hand-edited database is the only way it can be anything

package/dist/tutorials/Editing-a-Project.md

@@ -134,7 +134,8 @@ See [Narration Aliases and Glossary](Narration-Aliases-and-Glossary).
 | --- | --- | --- |
 | **Pause between sentences (seconds)** | The least quiet after each sentence. Adds silence where the pause is shorter; never shortens one or cuts a word. About 0.25 s is brisk, 0.35 to 0.45 natural, 0.5 to 0.8 an audiobook's 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. At 0 paragraphs get the sentence pause. Try 0.8 to 1.2 for a slower read. A speaker's turn gap is set under Speakers instead. | 0; 0 to 2 |
-| **Remove breaths** | Mutes the audible in-breaths a voice takes between sentences and after commas (Inworld's TTS-2 takes a loud one almost every time). Only the breath goes quiet: words, pauses and captions stay where they were. | Off |
+| **Soften breaths** | Turns the audible in-breaths a voice takes between sentences and after commas down by 12 dB, with soft fades (Inworld's TTS-2 takes a loud one almost every time). A breath with any word sound in it is left alone; words, pauses and captions stay where they were. | Off |
+| **Soften S sounds** | Takes the sharp edge off s and sh sounds with a very light de-esser; the voice keeps its brightness. Works with or without Soften breaths. | Off |
 | **Level the volume** | Brings every narration piece to one loudness before they are joined, then sets the video, shorts and audio files to a finished loudness. | On for new runs (Settings → General → **Level the volume for new runs**) |
 | **Video volume** | How loud the video and shorts are, in dB from the recommended level (0 dB is -14 LUFS, what YouTube and Spotify play at). -6 dB is about 50%, +4 dB about 158%. Peaks stay under -1.5 dBTP. | 0 dB; -10 to +4 dB in 0.5 dB steps |
 | **Audio files volume** | How loud the WAV, MP3 and M4B are, in dB from -18 LUFS (what audiobook shops such as ACX ask for). Peaks stay under -3 dBTP. | 0 dB; -10 to +4 dB |
@@ -143,7 +144,7 @@ You can type a volume in dB or as a percentage of the recommended level.
 
 What changing them remakes:
 
-- **Pauses or Remove breaths**: the narration is joined again from the pieces it already has and timed again, which remakes what is timed from it: captions, the video and, when on, the YouTube description and the shorts' pick (those two are text calls). No speech is made again.
+- **Pauses, Soften breaths or Soften S sounds**: the narration is joined again from the pieces it already has and timed again, which remakes what is timed from it: captions, the video and, when on, the YouTube description and the shorts' pick (those two are text calls). No speech is made again.
 - **Level the volume on or off**: the levelled narration is joined again and the exports rendered again. No speech is made again, and word timing, description, shorts' pick and reviews are not redone.
 - **A volume only**: the exports are mastered again, nothing else.
 

package/dist/tutorials/FAQ.md

@@ -48,7 +48,7 @@ What you write is sent only to the AI providers you pick, because they make the
 
 ### Does it work offline?
 
-Partly. The AI steps (article, research, narration, images, thumbnails, descriptions) call providers over the internet, or CLIs that do. Rendering the video, levelling the volume, captions, the style preview and the System voice run on your computer. Captions need a speech model of about 95 MB that is downloaded once, on first use. Patch notes ship with the app and open offline.
+Partly. The AI steps (article, research, narration, images, thumbnails, descriptions) call providers over the internet, or CLIs that do. Rendering the video, levelling the volume, captions, the style preview and the System voice run on your computer. Captions need a speech model of about 378 MB (smaller ones can be chosen in Settings → Production defaults) that is downloaded once, on first use. Patch notes ship with the app and open offline.
 
 ## Making and editing videos
 

package/dist/tutorials/Install.md

@@ -11,7 +11,7 @@ Slopify is a local web app you start from a terminal. It runs on your own comput
 | Node.js | Version 26 or newer, with npm (it comes with Node). Get it from nodejs.org. |
 | Operating system | Windows, macOS or Linux for the normal install. The managed Docker install is Linux only (see [Docker](Docker)). |
 | ffmpeg | Nothing to install: Slopify brings its own copy. See [ffmpeg](#ffmpeg) below. |
-| Disk space | Enough for your videos. Every project keeps its video, images, narration and working files. The caption model is a 95 MB download. |
+| Disk space | Enough for your videos. Every project keeps its video, images, narration and working files. The caption model is a 378 MB download (95 MB if you pick Smallest in Settings → Production defaults). |
 | Keys or CLIs | Text and images can come from Claude Code, Codex or Gemini CLI, or from API keys. Narration can use a voice provider key, or your computer's own speech for free (the System voice; on Linux, install `espeak-ng`). See [Providers and Keys](Providers-and-Keys) and [AI CLIs](AI-CLIs). |
 
 ## Choose how to run it
@@ -71,7 +71,7 @@ A flag beats the environment variable, and the variable beats the default.
 | `--no-open` | `SLOPIFY_NO_OPEN` | opens a browser | Doesn't open a browser tab. For the variable, any value except empty, `0` or `false` counts as on. |
 | `--autostart` / `--no-autostart` | | asks once | Turns [Start at Login](Start-at-Login) on or off without asking. Useful in scripts. |
 | | `SLOPIFY_FFMPEG` | the bundled ffmpeg | The full path of another ffmpeg to use. |
-| | `SLOPIFY_NO_MODEL_PREFETCH` | downloads at start | Set to `1` to skip fetching the 95 MB caption model when Slopify starts. It is then fetched the first time a video needs captions. |
+| | `SLOPIFY_NO_MODEL_PREFETCH` | downloads at start | Set to `1` to skip fetching the caption model (the one chosen in Settings → Production defaults, 378 MB by default) when Slopify starts. It is then fetched the first time a video needs captions. |
 
 Options that only work with `--docker`: `--projects-dir <folder>`, `--host-cli=off` and `--accept-host-cli`. See [Docker](Docker). With `--docker`, `--host` and `--data-dir` are refused, because the Docker version always listens on localhost and keeps its data in a Docker volume.
 
@@ -112,7 +112,7 @@ The bundled ffmpeg is a separate program under the GPL-3.0-or-later licence. Slo
 
 ## The caption model
 
-Captions are timed against the narration by a speech model that runs on your computer, at no cost. The English model (95 MB) is downloaded when Slopify starts, in the background, so a run never waits for it later. It is kept in `<data folder>/models/`. Set `SLOPIFY_NO_MODEL_PREFETCH=1` to skip the download at start. Other languages use a separate model that is downloaded the first time a project in that language needs it.
+Captions are timed against the narration by a speech model that runs on your computer, at no cost. The English model is downloaded when Slopify starts, in the background, so a run never waits for it later: the one chosen in Settings → Production defaults → **Subtitle timing model**, Most accurate (378 MB) unless changed. The Docker image already carries it. It is kept in `<data folder>/models/`. Set `SLOPIFY_NO_MODEL_PREFETCH=1` to skip the download at start. Other languages use a separate model that is downloaded the first time a project in that language needs it.
 
 ## Anonymous usage stats
 

package/dist/tutorials/Other-Languages.md

@@ -32,7 +32,7 @@ This applies with the brand kit off too, because language is not styling. Projec
 | | English | Spanish, German, French, Italian, Portuguese, Dutch, Catalan, Polish, Czech | All other languages |
 |---|---|---|---|
 | Article, narration preparation, YouTube description, chapters, tags, shorts titles and hashtags, multi-voice scripts | English | Written in the language | Written in the language |
-| Caption timing | Word by word, English model (95 MB) | Word by word, multilingual model (248 MB, downloaded once, on first use) | Sentence by sentence, no model |
+| Caption timing | Word by word, English model (378 MB; 189 MB or 95 MB in Settings → Production defaults) | Word by word, multilingual model (248 MB, downloaded once, on first use) | Sentence by sentence, no model |
 | Word-by-word Shorts captions | On | On | Off: shorts show whole caption groups |
 | Cuts that follow the narration | Available | Available | Off: cuts fall every N seconds |
 | Pronunciation Glossary | Standard-English IPA | Full IPA (ç, ʁ, ø, y, ɲ, x and so on) | Full IPA |

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

@@ -84,7 +84,7 @@ Below the ambient sound are **Pause between sentences**, **Pause between paragra
 
 ## 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."
+Captions are timed from your narration on this computer, with no paid API. The first use downloads a speech model of about 378 MB (Settings → Production defaults → **Subtitle timing model** offers smaller ones). They need narration: with narration Off, the section says "Turn Audio on to add subtitles."
 
 | Option | What it does | Default / range |
 | --- | --- | --- |

package/dist/tutorials/Settings-Reference.md

@@ -116,7 +116,7 @@ There is nothing to turn on: the address works whenever Slopify runs. See [Agent
 
 ## Production defaults
 
-"How new runs pace the narration and level the volume."
+"How new runs pace the narration and level the volume, and which model times English captions."
 
 ### Silence between segments
 
@@ -136,6 +136,14 @@ Videos already started keep their own gap. A value that is not a whole number fr
 
 The volume fields show only while the switch is on. A project keeps what it started with; change it there in **Edit project**. Levelling runs on this computer and makes no API calls. Changes save as you make them.
 
+### Subtitle timing model
+
+| Control | What it does | Default / range |
+|---|---|---|
+| **Subtitle timing model** | The speech model that times English captions on this computer. The same model in three sizes: **Most accurate (378 MB, recommended)**, **Balanced (189 MB)** and **Smallest (95 MB, less accurate)**. Bigger hears the narration more accurately and, on most computers, also runs faster. | Most accurate |
+
+The chosen model downloads once, the first time captions are timed (or when Slopify starts, unless `SLOPIFY_NO_MODEL_PREFETCH` is set), and is kept in `<data folder>/models/english-subtitles/`. A model already downloaded stays there when you switch, so switching back costs nothing. Smallest can mishear a line and stop a run with "Subtitles stopped matching the audio" where the narration is fine. Changing the model never marks finished subtitles outdated, and a timing that is already running finishes with the model it started with; the next one uses the new choice. It is a setting of this computer, not of a project. Other languages use their own model and are not affected. Changes save as you make them.
+
 ## Notifications
 
 "When a run finishes, fails, or waits for you."

package/dist/tutorials/Troubleshooting.md

@@ -67,7 +67,7 @@ Slopify ships its own ffmpeg; you do not need to install one. In Docker it is in
 | "The audio/video export failed (ffmpeg exited with code ...)" | Open **Error details**: it quotes what ffmpeg could not do, for example an input file it could not open. Replace that file (an uploaded image or clip in **Edit project → Images**), or try again. |
 | "Slopify couldn't measure the loudness of the narration" | Try again. If it happens again, turn off **Level the volume** in **Edit project → Inputs → Pauses and volume**, then download diagnostics and report it. |
 | "The style preview couldn't render ... Press Render again." | Press **Render again**. If it fails again, download diagnostics and report it. |
-| "The free subtitle model could not be downloaded" / "download was interrupted" / "failed download verification" | The 95 MB caption model downloads on first use. Check your connection and try again. `SLOPIFY_NO_MODEL_PREFETCH` only skips the download at start; captions still need it. |
+| "The free subtitle model could not be downloaded" / "download was interrupted" / "failed download verification" | The caption model (378 MB by default, the size chosen in Settings → Production defaults → **Subtitle timing model**) downloads on first use. Check your connection, then **Continue** the run, or pick a smaller model there. `SLOPIFY_NO_MODEL_PREFETCH` only skips the download at start; captions still need it. |
 | "Captions can't be edited until the current narration has finished and its subtitle timing is ready." | Let the narration and subtitle timing finish, then edit captions. |
 | "The saved subtitle timing doesn't match the current narration." | Do what the message says: make the subtitle timing again (More → make it again), then edit the captions. |
 | "Subtitles recovered after missing narration (N)" under the video | Some transcript passages could not be matched to the audio and were left out of the captions. The audio is fine. Review those passages before sharing. |

package/dist/tutorials/Video-Editing.md

@@ -90,7 +90,7 @@ With **Level the volume** on, the bed is mixed and ducked first, then the whole
 | **Subtitle font size** | How big burned-in captions are. Larger is easier to read on phones but covers more of the picture. | 48; 16 to 120 |
 | **Subtitle position** | Where burned-in captions sit: **Top**, **Upper-middle**, **Center**, **Lower-middle** or **Bottom**. Move them up when pictures have detail near the bottom. | Bottom |
 
-Captions are timed from your narration on your computer, with no paid API. The first use downloads a speech model of about 95 MB. Subtitle files carry no font, size or position, because players style them. Changing the font, size or position remakes only the video.
+Captions are timed from your narration on your computer, with no paid API. The first use downloads a speech model of about 378 MB (Settings → Production defaults → **Subtitle timing model** offers smaller ones). Subtitle files carry no font, size or position, because players style them. Changing the font, size or position remakes only the video.
 
 Subtitles need narration: with Audio off the section says "Turn Audio on to add subtitles." With Video off (an audio export), only subtitle files are offered.