@gentbajko/slopify 2.5.0 → 3.0.1

package/dist/tutorials/FAQ.md

@@ -0,0 +1,134 @@
+# FAQ
+
+Short answers to the questions people ask most, with links to the pages that go deeper.
+
+**Where to find it:** this page. For error messages, see [Troubleshooting](Troubleshooting).
+
+## Cost and accounts
+
+### Is Slopify free?
+
+Yes. Slopify is free and open source. You pay the AI providers you choose (for text, narration and images) directly, on your own accounts. Rendering, captions, loudness, the Look, ambient sound, chapter cards and the style preview run on your computer and cost nothing.
+
+### How much does one video cost?
+
+It depends on the providers, models, length and number of images. Play shows an estimate before you start, with **Cost by stage** under it. After a run, the project's **Cost** section shows what each stage and model actually cost, retries and remakes included. See [Costs and Run Cost](Costs-and-Run-Cost).
+
+### Can I use my Claude, ChatGPT (Codex) or Gemini subscription instead of API keys?
+
+Yes, through the command-line tools you are already signed in to: Claude Code, Codex or Gemini CLI. Calls through them cost $0 on your plan; Slopify shows what the same work would cost through the API, for comparison only. When a plan's limit is used up, the run waits for the reset and carries on by itself. See [AI CLIs](AI-CLIs).
+
+### Can I make a video without any API key?
+
+Yes. Sign in to Claude Code, Codex or Gemini CLI for the text (Codex also draws the images), and the narration can use your computer's own voice, the **System voice**, for free. That is what the first 60-second short uses when no voice key is saved. It sounds robotic, so add a voice key when you want a better one. See [Your First Short](Your-First-Short) and [Providers and Keys](Providers-and-Keys#the-system-voice).
+
+### How do I know a key works before I save it?
+
+Paste it in Settings → **Providers** and press **Test**. Slopify checks the pasted key with the provider without storing it; press **Save** to keep it. See [Providers and Keys](Providers-and-Keys#test-a-key).
+
+### Do I need an account or a login for Slopify?
+
+No. There is no Slopify account and no login. That is also why Slopify listens only on `127.0.0.1` by default: anyone who can reach its port controls the app and its keys. Keep it that way.
+
+## Privacy and your data
+
+### Where are my API keys stored?
+
+On your computer, in Slopify's hidden data folder (`~/.slopify` by default; in Docker, the `slopify-data` volume). Each key is sent only to its own provider, and keys are never put in a backup or an export. Diagnostics files never contain them either. See [Providers and Keys](Providers-and-Keys).
+
+### Where are my projects?
+
+In your files folder, `Documents/Slopify` for new installs, Docker included (Settings → **Backup & storage** → **Your files** shows it). An install from before 3.0 keeps its files where they were until you move them. See [Where Your Files Live](Where-Your-Files-Live).
+
+### Does Slopify send anything about me?
+
+Slopify sends anonymous counts to show the live totals on slopify.stream: tokens per stage with provider and model, audio seconds, images, thumbnails, videos, PDFs, YouTube descriptions, shorts, projects created, that the machine installed Slopify, and when each happened. Each event carries a random ID and a random machine ID. It never sends your API keys, prompts, keyword values, titles, article or research text, files or file names, or your operating system, locale or hardware. A notice explains this the first time you open Slopify.
+
+What you write is sent only to the AI providers you pick, because they make the article, narration and images.
+
+### 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.
+
+## Making and editing videos
+
+### Can I change a video after it is made?
+
+Yes. Open the project, press **Edit settings**, change what you want and press **Save changes**. Only the outputs the change affects turn outdated, and you remake them when you choose, after seeing the cost. See [Editing a Project](Editing-a-Project).
+
+### Can I fix one image or one sentence without redoing everything?
+
+Yes. In **Edit project → Images** you can edit one image's prompt, replace it with your own file or regenerate it; in **Edit project → Narration** you can edit or respeak one chunk. Only that piece and the video are made again.
+
+### Where do I see what a run cost?
+
+At the top of a finished project's page, one line sums it up ("This run cost …"), with **See cost by stage**. See [Costs and Run Cost](Costs-and-Run-Cost).
+
+### Can I go back to an earlier version?
+
+Yes. **History** on the project page lists every saved revision with its files. **Restore this revision** makes an old one current again, without losing anything saved after it.
+
+### Can I use my own images, audio or video clips?
+
+Yes. Stages can use a file you provide instead of generating one, and in Edit project you can replace any image, add your own picture or add a video clip that plays in an image's place. See [Editing a Project](Editing-a-Project#edit-images).
+
+### What happens if I close the browser while a video is being made?
+
+The run keeps going; it runs in Slopify on your computer, not in the browser tab. Open the project again to see where it is. You can also get a notification when it finishes; see [Notifications](Notifications).
+
+### What happens if my computer restarts in the middle of a run?
+
+Everything already made is kept. A step that was running shows as failed with "interrupted"; press **Try ... again**. Steps that were waiting for a rate limit or a CLI plan limit carry on by themselves. See [Recovery and Retries](Recovery-and-Retries).
+
+### Why is my project "Done with problems"?
+
+The main output was made, but another step failed, for example the thumbnail. The failed step shows its error and a button to fix it. See [Recovery and Retries](Recovery-and-Retries#done-with-problems).
+
+### I deleted a project by mistake. Can I get it back?
+
+Yes, within 30 days. Open Settings → **Trash** and press **Restore**. See [Trash](Trash).
+
+### Are captions free?
+
+Yes. Captions are timed from your narration on your computer, with no paid API. See [Video Editing](Video-Editing#subtitles).
+
+### Can Slopify make videos in other languages?
+
+Yes, with some differences in captions and cuts for languages without word timing. See [Other Languages](Other-Languages).
+
+## Publishing
+
+### Does Slopify upload to YouTube for me?
+
+No. Slopify never uploads or publishes anything. **Prepare upload** lays out the file, title, description, thumbnail, playlist, audience, AI use and tags in the order YouTube Studio asks for them, each with a copy button. The optional Studio browser extension fills in the Studio form for you; you check it and press Publish yourself. **Mark uploaded** records that you did. See [Publishing to YouTube](Publishing-to-YouTube) and [Studio Extension](Studio-Extension).
+
+### Does it make Shorts too?
+
+Yes. It can pick moments from the long video (60 to 120 seconds by default, anywhere from 15 to 180) and make vertical shorts with new images, word-by-word captions and their own title and hashtags. See [Shorts](Shorts).
+
+## Running Slopify
+
+### What do I need to run it?
+
+Node 26 or newer, then `npx @gentbajko/slopify@latest`. It opens at `http://127.0.0.1:6969`. On Linux you can run it in Docker instead. You do not need to install ffmpeg; Slopify ships its own. See [Install](Install) and [Docker](Docker).
+
+### Can I use it from my phone or another computer?
+
+Slopify is meant to be used on the computer it runs on. You can change the address with `--host`, but there is no login, so whoever reaches the port controls the app and its keys. Notifications can reach your phone. See [Notifications](Notifications).
+
+### How do I update?
+
+Press the circular-arrows button at the foot of the sidebar, or run `npx @gentbajko/slopify@latest update` while Slopify is running. It waits for running work, keeps a copy to go back to, and puts the previous version back if the new one does not start. See [Updating and Patch Notes](Updating-and-Patch-Notes).
+
+### Something is broken. What should I send?
+
+Open Settings and press **Download diagnostics**. The file lists your Slopify, system and Node versions and which providers are set up, never your keys, prompts or project content. Attach it to your bug report. See [Troubleshooting](Troubleshooting).
+
+## Related pages
+
+- [Troubleshooting](Troubleshooting)
+- [Recovery and Retries](Recovery-and-Retries)
+- [Providers and Keys](Providers-and-Keys)
+- [Costs and Run Cost](Costs-and-Run-Cost)
+- [Where Your Files Live](Where-Your-Files-Live)
+- [Publishing to YouTube](Publishing-to-YouTube)

package/dist/tutorials/First-Launch-and-Welcome.md

@@ -0,0 +1,153 @@
+# First Launch and Welcome
+
+The first time you open Slopify it walks you through three steps: what your computer already has, a style, and your first 60-second short. The short is being made by the time you finish, and three finished sample projects are there to explore while you wait, without spending anything.
+
+**Where to find it:** it opens by itself on a fresh install. Its address is `http://127.0.0.1:6969/welcome`.
+
+## What happens the first time
+
+1. **Anonymous usage stats.** A notice lists exactly what is counted and what never is. Press **Got it** to continue. It shows once per machine. See [Install](Install#anonymous-usage-stats).
+2. **Welcome to Slopify.** Home sends you to the first-run screen once. It has three steps, shown as tabs: **1 · What you have**, **2 · Pick a style** and **3 · Make your first short**. **Next** and **Back** at the bottom move between them, and you can click a tab directly.
+3. **Start at login.** The last step offers **Start when I log in** once, unless you already answered in the terminal.
+
+The first-run screen stops appearing for good when you press **Skip** (it reads **Done** once your short is on its way), or when your first real project exists (anything except the samples), even if you delete that project later.
+
+## Step 1: What you have
+
+### Found on this computer
+
+Slopify looks for Claude Code, Codex and Gemini CLI and shows one row for each:
+
+| Row says | Meaning |
+| --- | --- |
+| **Ready · 1.2.3 · writes** | Installed, a supported version and signed in, as far as Slopify can tell. It can write the text. |
+| **Ready · … · writes and draws** | Codex: it writes the text and draws the images. |
+| **Installed, not usable yet** or a reason | Found, but something is missing, such as a sign-in. The reason is shown. |
+| **Not found** | Not installed, or not on the `PATH` Slopify sees. |
+
+When at least one is ready, the step says which parts need no API key, for example "You can make a video now: no API keys are needed for the text, the images or the narration." When none is ready, it says "Nothing on this computer can write the script yet." with **Open Settings → Providers**: install and sign in to a CLI, or add an OpenRouter key.
+
+### Narration voice
+
+The second part says who will read the script aloud:
+
+| It says | Meaning |
+| --- | --- |
+| "Narration uses your *provider* voice key." | A voice key (OpenAI, ElevenLabs, Cartesia or Inworld) is saved, so that provider narrates. |
+| "Narration uses your computer's built-in voice (*engine*); add an ElevenLabs or OpenAI key later for a better one." | No voice key, so the computer's own speech narrates, for free. See [the system voice](Providers-and-Keys#the-system-voice). |
+| "No voice can narrate the short yet." | Neither a key nor a speech program was found. Press **Add a voice key**, or install a speech program (on Linux, `espeak-ng`) and press **Check again**. |
+
+**Add a voice key** opens Settings → **Providers**. See [AI CLIs](AI-CLIs) and [Providers and Keys](Providers-and-Keys).
+
+## Step 2: Pick a style
+
+Each row is a style for the short. **General** is a neutral explainer style; the others are the starter packs (Sleep lore, True crime, History, Science explainers). Press **Use this style** on a row; it then reads **Picked**.
+
+Making the short with a pack adds that pack's script and scene prompts to your Library and its suggested voice to Settings → **Voices**. **Add to library** on a pack's row also adds its Play template, for later long videos; it then reads **In your library**. See [Starter packs](#starter-packs).
+
+## Step 3: Make a 60-second short
+
+A topic in, a captioned vertical short out, usually in about five minutes with the command-line tools. It has its own page: [Your First Short](Your-First-Short).
+
+The step repeats the style and the voice line from step 1. If no voice can narrate yet, it shows the same **Add a voice key** and **Check again** buttons.
+
+| Field | What it does | Limits |
+| --- | --- | --- |
+| **Topic** | What the short is about, in a few words or a question. A specific topic gives a sharper short than a broad one. | Up to 200 characters |
+
+Press **Make a 60-second short**. The status line says **Starting your short…**, then the step says "Your short is being made." with **Watch it being made**, which opens the project's page and its live view. While it runs, the samples and the start-at-login offer are right below.
+
+## Explore the samples
+
+Three finished projects come with Slopify, marked **Sample** in Projects. Step 3 of the first-run screen lists them under **While you wait: the samples**. They are read-only, so nothing you do on them reaches a paid provider.
+
+| Sample | What it shows | Button |
+| --- | --- | --- |
+| **The Library of Alexandria** | A 3-minute narrated 16:9 video with burned-in captions, chapter cards and a warm Look, plus its two shorts, the article, the PDF, a YouTube description with chapters, four images and a thumbnail. | **Explore the sample** |
+| **The Wind in the Willows** | An audiobook of an abridged excerpt: a narrator and two character voices, captions tagged with who speaks, and an MP3 and M4B with chapters. | **See an audiobook** |
+| **The Antikythera Mechanism** | A two-host podcast with the speaker panel, name tags and portraits, and its MP3 and M4B. | **Hear a podcast** |
+
+If a sample was deleted, its row shows **Restore samples in Settings** instead.
+
+### Make your own copy of a sample
+
+A sample's project page says "This is the sample project, finished and free to explore." with the button **Make my own copy**.
+
+1. Open a sample.
+2. Press **Make my own copy** (also in the command palette, `Ctrl+K` → **Make my own copy**).
+3. Slopify copies every file and setting of that sample into a new, normal project. Nothing needs to be made again: the copy is finished too.
+4. Edit the copy like any project. Changes to it use your providers and cost what they cost. See [Editing a Project](Editing-a-Project).
+
+### Restore the samples
+
+1. Open Settings → **Backup & storage** and scroll to **Sample projects**.
+2. Each sample shows whether it is **in your projects** or **not in your projects**, with **Open**.
+3. Press **Restore samples**. It puts all three back as they shipped: it adds back any that were deleted and replaces the others with the originals. Your own copies are not touched.
+
+## Starter packs
+
+A starter pack sets you up for one kind of channel. Each one adds, in one go:
+
+- prompts to your Library: an article prompt, a 60-second script, an image (scene) prompt, a thumbnail prompt, a description prompt and a shorts prompt, each asking only for `{{topic}}`;
+- a suggested OpenAI voice, saved under Settings → **Voices**;
+- a Play template that uses them, named `<pack> starter`, with its captions, motion and Look.
+
+Then you pick the template on Play, type a topic and start. See [Templates](Templates) and [Play Overview](Play-Overview).
+
+| Pack | What it is for | Suggested voice |
+| --- | --- | --- |
+| **Sleep lore** | Slow, gentle myths and legends told to fall asleep to. | OpenAI `sage` |
+| **True crime** | Measured, factual retellings of real cases and their investigations. | OpenAI `onyx` |
+| **History** | Narrative history of people, places and events, told like a documentary. | OpenAI `fable` |
+| **Science explainers** | Clear, friendly explanations of how the world works, one idea at a time. | OpenAI `nova` |
+
+On the first-run screen, **Add to library** on a pack's row adds all of this; it then reads **In your library**. Making a short with a pack adds its prompts and voice only, not the template.
+
+- Adding a pack twice changes nothing.
+- It never replaces a prompt or template of yours with the same name: the pack's copy comes in as `<name> (2)`.
+- An item the pack added before and you edited is kept as you left it. One you deleted comes back.
+
+You can add packs later too, from Library → **Templates** → **Add pack**.
+
+## Start when I log in
+
+Step 3 of the first-run screen asks once: **Start when I log in** or **No thanks**. Either answer, here, in Settings → **General** or in the terminal, ends the question. See [Start at Login](Start-at-Login).
+
+## Set up a long video instead
+
+At the bottom of every step, **Set up a long video instead** takes you to Play, where you choose prompts, keywords and outputs yourself. See [Play Overview](Play-Overview).
+
+## The interactive tutorial
+
+The question-mark button at the foot of the sidebar (**Start interactive tutorial**) walks you through a first project in 25 steps ("3 of 25 · First project"):
+
+1. **Settings:** connect a text, a voice and an image provider, and add a narration voice.
+2. **Library:** write and save an article prompt with keywords, then an image prompt.
+3. **Play:** name the project, choose the article, keywords, narration, images, video and subtitles, then review and start the run.
+4. **The project:** follow and control the run, download the results, see what the run cost and prepare the YouTube upload.
+5. **The rest of the app:** check Home each day, set up a channel, and plan uploads on the calendar.
+
+Each step highlights the real control you will use and opens its screen for you. Your place is saved, so it survives a page reload. On the review-and-start step, **Skip generating** leaves the run unstarted and goes on to Home, Channels and the Calendar instead of ending the tutorial. Other steps have **Skip this step** (or **Skip without saving**).
+
+When Projects has no projects at all, it also shows **Make your first video** with **Start tutorial**.
+
+## The provider welcome in Settings
+
+Settings → **Providers** shows a short welcome on a fresh install that names the command-line tools it found and says a video can be made without an API key. Press **Got it** to hide it.
+
+## Tips
+
+- Try a sample before you add any keys: every screen works on it, and nothing costs anything.
+- You can come back to the first-run screen at `/welcome` until you skip it or make a real project.
+- After an update to a new major version, a **What's new** tour opens instead. See [Updating and Patch Notes](Updating-and-Patch-Notes).
+
+## Related pages
+
+- [Your First Short](Your-First-Short)
+- [Home and Projects](Home-and-Projects)
+- [Providers and Keys](Providers-and-Keys)
+- [AI CLIs](AI-CLIs)
+- [Templates](Templates)
+- [Prompts](Prompts)
+- [Multiple Voices](Multiple-Voices)
+- [Start at Login](Start-at-Login)

package/dist/tutorials/Home-and-Projects.md

@@ -0,0 +1,174 @@
+# Home and Projects
+
+Home is Slopify's front page: what needs you, what is running, what is coming up, what is ready to upload and what this week cost, on one screen. Projects is the full list of every run you ever started, with search and filters.
+
+**Where to find it:** the sidebar → **Home** (the Slopify logo also goes there) and **Projects**. On a phone, the bottom bar.
+
+## Finding your way around
+
+Every page shares the same frame: the sidebar on the left and the page beside it. On a computer there is no top bar; everything lives in the sidebar.
+
+### The sidebar
+
+From top to bottom:
+
+| Part | What it has |
+| --- | --- |
+| Logo | The Slopify play logo and name, with the version you are running beside it (for example `v3.0.0`). Click it to go Home. |
+| **Search or run a command** | Opens the command palette (`Ctrl+K`). |
+| Destinations | **Home**, **Projects**, **Calendar** (also lit on Schedules), **Channels**, **Library** (Prompts, Intros & Outros, Templates, Document themes, Narration aliases), **Settings** (also lit on Usage). |
+| **N running** | Shown while runs are going. It links to Running now on Home. |
+| **Channel** | The channel picker (see below). |
+| **New video** | Opens Play (`C` from anywhere). |
+| Links | **GitHub**, **Patreon** and **Buy Me a Coffee**, each opening in a new tab. |
+| Foot | "Free. Your keys, your machine.", the updates button (circular arrows, see [Updating and Patch Notes](Updating-and-Patch-Notes)) and the tutorial button (question mark, **Start interactive tutorial**). |
+
+### On a phone
+
+Below 768 pixels wide the sidebar is hidden. A slim bar at the top holds the logo, the search button, the running count, the GitHub, Patreon and Buy Me a Coffee icons, the updates button and the tutorial button. A bottom bar has five destinations: Home, Projects, Calendar, Library and Settings. Channels is reachable from the command palette, and the Channel picker sits at the top of Home.
+
+### Rows open with one press
+
+In every list, a press anywhere on a row or tile opens or picks it, not only on its name: projects, Home items, calendar entries, channels, schedules, Library lists, samples, saved drafts and media tiles. The buttons on a row still do their own thing.
+
+### The command palette
+
+Press `Ctrl+K`, or click **Search or run a command**, to jump anywhere or run an action by typing. The **Go to** group has **Open home**, **Open projects**, **Open calendar**, **Open schedules**, **Open channels**, **Open library**, **Open settings**, **Open usage and costs** and **Show patch notes**. **New video** opens Play. The **Channel** group has **Show all channels** and **Switch to <channel>**. See [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette).
+
+### The Channel picker
+
+The **Channel** picker near the foot of the sidebar (at the top of Home on a phone) shows Home and the other screens for one channel, or for **All channels**. It only filters what you see: projects, schedules and costs of other channels keep running. Slopify remembers your choice in this browser. See [Channels](Channels).
+
+## Home
+
+**Where to find it:** the sidebar → **Home**.
+
+The page title is the channel you picked (or **Home**), under today's date. At the top right are **Open calendar** and **New video**.
+
+On a fresh install, Home sends you to the first-run screen once. See [First Launch and Welcome](First-Launch-and-Welcome).
+
+### Needs you
+
+Things that don't move on until you act:
+
+| Item | Status | Button |
+| --- | --- | --- |
+| A run held at a review before a step | **Waiting for you · review before the narration** (or the images, or the video) | **Approve the article and record**, **Approve and draw the images** or **Approve and render**. Approving here lets the run continue. Open the project to look first. |
+| A run whose next step is held another way | **Waiting for you** | **Open to continue** |
+| A run you paused | **Paused** | **Open to continue** |
+| Topics a schedule suggested | **N new topics** | **Review topics**, on the calendar: queue the ones you want and reject the rest. |
+| A failed run | **Failed · <step>**, with a short reason | The fix to try: a button to Settings → Providers or Storage when that is the fix, otherwise **Open to retry**. |
+| A run that failed because a CLI is signed out | **Failed · <step>** | **Copy sign-in command** copies the command (`claude auth login`, `codex login` or `gemini`). Run it in a terminal on the computer running Slopify, then **Open to retry** and press **Check again** on the project. |
+
+Up to 4 failed runs show here. Only the first item's button is lime; the rest are plain buttons. The heading says how many things are waiting, or **Nothing is waiting for a decision**. See [Reviews and Checkpoints](Reviews-and-Checkpoints), [Schedules](Schedules) and [Recovery and Retries](Recovery-and-Retries).
+
+### Running now
+
+Videos being made or paused, up to 3. Each shows the step it is on, how long each step has taken, the running step's time left (for example `2 of 8 · about 4 min left`), the last few images as they land (with a tile for the one being drawn) and **Images N of M** while drawing. A run waiting for a CLI plan says so instead of the step, for example **Waiting for Codex limits (resets at 14:00)**. Open one to follow it live, pause it or cancel it. With nothing running it says **Start the next video**.
+
+- With more than three running, **See all N running** opens Projects filtered to running.
+- Queued runs show as one line under them, for example "Queued, waiting to start (2): Hypatia, Cleopatra", with **See queued** (Projects filtered to queued).
+
+Time left comes from the step's own pace once it has counted something, otherwise from how long the same kind of step took in your finished runs. Past that it says **taking longer than usual**, and with nothing to go by **time left unknown**.
+
+### Coming up
+
+The schedule runs due in the next 7 days, with the template and topic each will use, up to 6. Paused schedules show too. **Calendar** opens the calendar to plan or move runs. With none it says **No scheduled runs this week. Plan some on the calendar.** See [Calendar](Calendar).
+
+### Ready to upload
+
+Finished videos you have not marked uploaded, up to 4. The bundled samples never show here.
+
+- **Prepare upload** lists everything YouTube Studio asks for, with Copy buttons. Slopify never uploads for you. See [Publishing to YouTube](Publishing-to-YouTube).
+- **Mark uploaded** takes the video off this list. Projects still has it.
+
+### This week
+
+Since Monday, for the picked channel:
+
+| Figure | Meaning |
+| --- | --- |
+| **videos made** | Videos finished since Monday. |
+| **spent** | What their provider calls cost. Calls billed to a command-line plan cost nothing per call; **~$X via API** says what they would have cost with API keys. Calls with no known price are counted separately (**N calls without a price**). |
+| **weekly <plan> limit** | How much of each command-line plan's weekly limit is used, from the tool's last reading. The bar turns amber at 80%. |
+
+See [Costs and Run Cost](Costs-and-Run-Cost).
+
+## Projects
+
+**Where to find it:** the sidebar → **Projects**.
+
+Every run ever started, newest first, for the channel picked in the sidebar. The heading says how many projects there are and for which channel. **New video** opens Play.
+
+### Search and filter
+
+1. Type in **Search projects** to match titles.
+2. Pick a filter under **Show**:
+
+| Filter | Shows |
+| --- | --- |
+| **All** | Everything. |
+| **Running** | Running and paused projects. |
+| **Queued** | Projects waiting for their turn in the video queue. |
+| **Needs you** | Projects waiting at a review or held step. |
+| **Ready to upload** | Finished videos not marked uploaded. |
+| **Failed** | Failed projects and those **Done with problems**. |
+
+The filter is part of the address, so a link can open Projects on it: `/projects?show=running`, `queued`, `waiting` (Needs you), `ready` or `failed`. Press `/` to jump to the search box. The command palette has shortcuts: **Show projects that need you**, **Show videos ready to upload** and **Show failed projects**.
+
+On a wide screen, **At a glance** beside the list counts the projects under each filter.
+
+If nothing matches, the list says **No project matches. Clear the search or pick All.** If the picked channel has no projects, pick **All channels** in the sidebar.
+
+### What each row shows
+
+- The title, with a **Sample** badge on the bundled samples. A press anywhere on the row opens the project.
+- For an audiobook that is a chapter of a book, **Book · Chapter N**.
+- What it was made of and when: the article prompt and format, for example `Documentary dossier · 16:9 · started …`.
+- A progress bar with **N% done** while it runs.
+- Its state:
+
+| State | Meaning |
+| --- | --- |
+| **Running** | A step is being made. A run waiting for a CLI plan says **Waiting for Codex limits (resets at 14:00)** instead. |
+| **Paused** | Paused by you; nothing runs until you resume. |
+| **Queued** | Waiting for its turn in the video queue. |
+| **Waiting for you** | Held at a review or checkpoint. |
+| **Done** | Finished. |
+| **Done with problems** | Finished, but part of it failed. |
+| **Failed** | Stopped with an error. |
+| **Canceled** | You cancelled it. |
+
+- **Mark uploaded** on a finished video; once marked, an **Uploaded** badge with **Undo**.
+- The delete button (bin icon).
+
+### Delete a project
+
+1. Press the bin icon on its row. While the project is running it is disabled: cancel the run first.
+2. Confirm with **Delete project** (or **Keep it** to back out).
+3. The project goes to the trash for 30 days. Restore it or delete it for good in Settings → **Trash**. See [Trash](Trash).
+
+### The video queue
+
+Videos started together (a batch from Play, for example) run one at a time. The queue itself is on the Calendar, under **Batch queue**, numbered in the order they run (see [Calendar](Calendar#the-batch-queue)); Projects only links to it (**Video queue** → **Open calendar**) and has the **Queued** filter. Pausing a project holds the queue; when one fails or is cancelled, the next one starts. The project page has the same list behind a **Queue · N** button in its right rail. See [Templates](Templates) and [Schedules](Schedules) for batches.
+
+### When there are no projects
+
+Projects shows **No projects yet** with **Make your first video** (opens Play), and an invitation to the interactive tutorial with **Start tutorial**.
+
+## Tips
+
+- The sidebar's **N running** link jumps straight to Running now on Home.
+- Home and Projects follow the Channel picker. If a project seems missing, switch to **All channels**.
+- Updates wait for running work. See [Updating and Patch Notes](Updating-and-Patch-Notes).
+
+## Related pages
+
+- [Project Page](Project-Page)
+- [Play Overview](Play-Overview)
+- [Channels](Channels)
+- [Calendar](Calendar)
+- [Schedules](Schedules)
+- [Reviews and Checkpoints](Reviews-and-Checkpoints)
+- [Publishing to YouTube](Publishing-to-YouTube)
+- [Keyboard Shortcuts and Command Palette](Keyboard-Shortcuts-and-Command-Palette)

package/dist/tutorials/Home.md

@@ -0,0 +1,119 @@
+# Slopify Wiki
+
+Slopify turns a prompt and a few keywords into a narrated, captioned video. It writes the article, narrates it, makes the images and cuts the video, and can also give you shorts, a PDF of the article and a ready-to-paste YouTube description. It runs as a local web app on your own machine, with your own provider keys or the Claude Code, Codex or Gemini CLI you already use. It is free.
+
+These pages cover Slopify 3.0: every screen, every setting and every workflow, step by step.
+
+**Read them inside Slopify too:** the same pages are under **Help → Tutorials** in the app (the address is `/help/tutorials/<Page>`, for example `/help/tutorials/Install`), with a search box over all of them. From the command palette (`Ctrl+K`), **Open tutorial: <page>** jumps straight to one. See [Keyboard and Ctrl+K](Keyboard-Shortcuts-and-Command-Palette#open-a-tutorial-page).
+
+## Start here
+
+1. [Install](Install) Slopify (Node 26 or newer) or run it in [Docker](Docker).
+2. Open it at `http://127.0.0.1:6969` and follow [First launch and welcome](First-Launch-and-Welcome).
+3. Make [your first 60-second short](Your-First-Short). With a signed-in CLI and your computer's own voice it needs no keys at all.
+4. Add the keys you want in [Providers and keys](Providers-and-Keys) (press **Test** to check a key before you save it), or sign in to an [AI CLI](AI-CLIs).
+5. Make a full video from [Play](Play-Overview).
+
+## How a video gets made
+
+1. **Settings:** add provider keys and voices, or use a signed-in CLI.
+2. **Library → Prompts:** write article, image and thumbnail prompts once, with `{{keywords}}` where the subject goes.
+3. **Play:** pick a template or prompts, type the topic, choose your outputs, check the cost estimate, press **Start run** (or **Queue 3 videos** for several topics).
+4. **The project page** shows each stage as it runs. Download the video, captions, PDF and description when it is done.
+5. **Edit settings** on the project (the Edit project form) to change anything. Slopify remakes only what the change affects.
+
+## Contents
+
+### Getting started
+| Page | What it covers |
+|---|---|
+| [Install](Install) | Installing with npx or npm, command-line options, ffmpeg, telemetry |
+| [Docker](Docker) | Running Slopify in Docker with the compose file and the CLI helper |
+| [First launch and welcome](First-Launch-and-Welcome) | The three-step first run, the three samples, Make my own copy, starter packs |
+| [Your first short](Your-First-Short) | A 60-second short from topic to finished video |
+| [Home and Projects](Home-and-Projects) | The sidebar, the Home dashboard and the Projects list |
+| [Where your files live](Where-Your-Files-Live) | Documents/Slopify, the data folder and moving your files |
+| [Start at login](Start-at-Login) | Starting Slopify when you log in |
+| [Updating and patch notes](Updating-and-Patch-Notes) | Updating, going back, and reading patch notes |
+| [Uninstalling and moving](Uninstalling-and-Moving) | Removing Slopify and moving between Docker and a native install |
+
+### Providers
+| Page | What it covers |
+|---|---|
+| [Providers and keys](Providers-and-Keys) | Every API provider, testing and saving keys, the system voice, Settings → Voices |
+| [AI CLIs](AI-CLIs) | Claude Code, Codex and Gemini CLI: sign-in, use and plan limits |
+| [Models](Models) | The model catalogue, retired models and switching |
+| [Costs and run cost](Costs-and-Run-Cost) | Cost estimates, the run cost line, the Run cost tab and usage |
+
+### Making a video
+| Page | What it covers |
+|---|---|
+| [Play overview](Play-Overview) | Templates, topics, batches, drafts, the estimate, Start and Queue |
+| [Title and article](Play-Title-and-Article) | Title patterns, article prompts, research and your own text |
+| [Narration](Play-Narration) | Voices, pauses, volume, glossary, aliases, described tables |
+| [Images](Play-Images) | Image prompts, the establishing image, cast, image pacing, Codex |
+| [Video and style](Play-Video-and-Style) | Cuts, the Look, transitions, chapter cards, motion, captions, ambient sound |
+| [Outputs](Play-Outputs) | Video, shorts, description, PDF, thumbnails and audio exports |
+| [Reviews and checkpoints](Reviews-and-Checkpoints) | Automatic reviews and pausing a run for you to check |
+
+### Formats and outputs
+| Page | What it covers |
+|---|---|
+| [Multiple voices](Multiple-Voices) | Audiobook, podcast, radio drama and interview formats |
+| [Other languages](Other-Languages) | Making videos in languages other than English |
+| [Shorts](Shorts) | Vertical shorts cut from the long video |
+| [YouTube description](YouTube-Description) | Description, chapters, hashtags and tags |
+| [PDF documents](PDF-Documents) | The article as a PDF with contents, sources and a cover |
+
+### The project page
+| Page | What it covers |
+|---|---|
+| [Project page](Project-Page) | The next action, the run cost line, time left, downloads, the players, freeing space |
+| [Editing a project](Editing-a-Project) | Edit project, remaking outdated work, the rebuild review, history |
+| [Video editing](Video-Editing) | Video, caption, subtitle and ambient sound controls on a project |
+| [Recovery and retries](Recovery-and-Retries) | Fix-it buttons, retries and waiting for plan limits |
+| [Trash](Trash) | Deleted projects and how to get them back |
+
+### Publishing
+| Page | What it covers |
+|---|---|
+| [Publishing to YouTube](Publishing-to-YouTube) | Prepare upload, AI use disclosure, chapters and links |
+| [Studio extension](Studio-Extension) | The browser extension that fills YouTube Studio's upload dialog |
+
+### Automation
+| Page | What it covers |
+|---|---|
+| [Templates](Templates) | Saving and reusing a setup |
+| [Schedules](Schedules) | Videos on a cadence, topic lists and self-filling topics |
+| [Calendar](Calendar) | What needs you, what is coming up, the video queue |
+| [Notifications](Notifications) | Browser and phone (ntfy) notifications |
+| [Backups](Backups) | Automatic backups, export and import |
+
+### Channels
+| Page | What it covers |
+|---|---|
+| [Channels](Channels) | Brand kit, episode memory, existing videos and channel links |
+| [Cast library](Cast-Library) | Recurring characters with pictures and voices |
+
+### Library
+| Page | What it covers |
+|---|---|
+| [Library overview](Library-Overview) | What the Library holds |
+| [Prompts](Prompts) | Writing prompts, keyword slots, history and restore |
+| [Intros and outros](Intros-and-Outros) | Reusable openings and closings |
+| [Aliases and glossary](Narration-Aliases-and-Glossary) | How the narrator says words |
+| [Document themes](Document-Themes) | The look of the PDF |
+
+### Reference
+| Page | What it covers |
+|---|---|
+| [Settings reference](Settings-Reference) | Every Settings section and control |
+| [Keyboard and Ctrl+K](Keyboard-Shortcuts-and-Command-Palette) | Shortcuts and the command palette |
+| [Troubleshooting](Troubleshooting) | Common errors and how to fix them |
+| [FAQ](FAQ) | Short answers to common questions |
+
+## Getting help inside the app
+
+Every setting in Slopify has an info button beside it that explains what it does. If something goes wrong, the project page shows a button that names the fix. The question-mark button at the foot of the sidebar starts the interactive tutorial.
+
+These pages ship inside Slopify too, so they work offline and match the version you run: the book button beside the question mark opens **Help → Tutorials**, with the same groups as this wiki's sidebar and a search across every page. Many info buttons end in **Learn more**, which opens the matching section there, and `Ctrl+K` → **Open tutorial: <page>** opens any page. See [Troubleshooting](Troubleshooting) for the rest.