@gentbajko/slopify 2.5.0 → 3.0.1

package/dist/tutorials/Install.md

@@ -0,0 +1,154 @@
+# Install
+
+Slopify is a local web app you start from a terminal. It runs on your own computer, opens in your browser at `http://127.0.0.1:6969`, and uses your own provider keys or the AI command-line tools you are already signed in to.
+
+**Where to find it:** a terminal on your computer (PowerShell or Windows Terminal on Windows, Terminal on macOS, any shell on Linux).
+
+## What you need
+
+| Requirement | Details |
+| --- | --- |
+| 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. |
+| 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
+
+There are three ways. All three give you the same app.
+
+| Way | Command | Good for |
+| --- | --- | --- |
+| Run with npx | `npx @gentbajko/slopify@latest` | Trying it, or always starting the newest version. Nothing is installed globally. |
+| Install with npm | `npm install -g @gentbajko/slopify`, then `slopify` | A permanent `slopify` command. |
+| Docker (Linux) | `npx @gentbajko/slopify@latest --docker` | Keeping Slopify running in the background, restarting with Docker. See [Docker](Docker). |
+
+## Start Slopify with npx
+
+1. Open a terminal.
+2. Run `npx @gentbajko/slopify@latest`.
+3. Wait while npm downloads the package the first time. Slopify then checks ffmpeg, starts, and prints where everything is:
+   - `Slopify is running at http://127.0.0.1:6969`
+   - `Slopify data directory:` the hidden data folder (normally `~/.slopify`)
+   - `Projects:` where your project folders are (on a new install, `Documents/Slopify/Projects`)
+   - `Database:` and `Logs:` inside the data folder
+4. Your browser opens at `http://127.0.0.1:6969`. If it doesn't, open that address yourself.
+5. On an interactive terminal Slopify asks once: `Start Slopify when you log in? (Y/n)`. Press Enter for yes, or type `n`. See [Start at Login](Start-at-Login).
+6. Keep the terminal open while you use Slopify. Press `Ctrl+C` in it to stop Slopify.
+
+Continue with [First Launch and Welcome](First-Launch-and-Welcome).
+
+## Install it with npm
+
+1. Run `npm install -g @gentbajko/slopify`.
+2. Start it any time with `slopify`. The same flags work: `slopify --port 7070`.
+
+In-app updates work for both npx and a global install: the new version is installed inside the data folder and later starts take it from there. See [Updating and Patch Notes](Updating-and-Patch-Notes).
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `npx @gentbajko/slopify@latest` | Starts Slopify. |
+| `npx @gentbajko/slopify@latest update` | Updates a running Slopify to the newest version, the same way the in-app update button does. It only works while Slopify is running. If you have a Docker install, it updates that one instead. |
+| `npx @gentbajko/slopify@latest --docker` | Installs Slopify in Docker, or re-applies changed Docker settings. Same as `install --docker`. |
+| `npx @gentbajko/slopify@latest update --docker` | Updates the Docker install. |
+
+Any other word after the package name is refused with a message listing these commands. Without `--docker` there is nothing to install: `install` on its own is refused.
+
+`update` for a normal install needs Slopify to be running. If it isn't, the command says so: start Slopify first, and add `--port <number>` if it runs on another port.
+
+## Options
+
+A flag beats the environment variable, and the variable beats the default.
+
+| Flag | Variable | Default | What it does |
+| --- | --- | --- | --- |
+| `--port` | `SLOPIFY_PORT` | `6969` | The port Slopify listens on. A whole number from 1 to 65535. |
+| `--host` | `SLOPIFY_HOST` | `127.0.0.1` | The address it binds to. |
+| `--data-dir` | `SLOPIFY_DATA_DIR` | `~/.slopify` | Where the database, settings, keys, logs and caption models live. A relative path is taken from the folder you run the command in. |
+| `--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. |
+
+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.
+
+### A second install or a test install
+
+Start Slopify with its own data folder, for example `npx @gentbajko/slopify@latest --data-dir ~/slopify-test --port 7070`. A new install with its own data folder keeps its project files inside that folder instead of in `Documents/Slopify`, so it never shares files with your main install. See [Where Your Files Live](Where-Your-Files-Live).
+
+Only one Slopify can use a data folder at a time. A second one on the same folder stops with `Slopify is already running on this data directory`.
+
+## Keep it on 127.0.0.1
+
+Slopify has no login. Whoever can reach its port controls the app and every provider key saved in it. The default `127.0.0.1` means only your own computer can reach it.
+
+If you start it with another `--host`, the terminal prints a warning: `WARNING: bound to <host> - anyone who reaches this port controls the app and its keys (no login).` Only do that on a network you trust completely.
+
+## ffmpeg
+
+Slopify makes its videos with ffmpeg, and you don't need to install it.
+
+- A normal install gets a tested ffmpeg for your system through npm when the package is installed. Slopify never uses an ffmpeg from your `PATH` on its own.
+- Before starting, Slopify checks that ffmpeg runs. If the install-time download is missing, it downloads the same build into `<data folder>/bin/`, with its licence and source notice, and reuses it on later starts.
+- The Docker image already contains ffmpeg.
+
+To use your own ffmpeg, set `SLOPIFY_FFMPEG` to its full path:
+
+```sh
+SLOPIFY_FFMPEG=/usr/bin/ffmpeg npx @gentbajko/slopify@latest
+```
+
+In Windows PowerShell:
+
+```powershell
+$env:SLOPIFY_FFMPEG = 'C:\tools\ffmpeg\bin\ffmpeg.exe'
+npx @gentbajko/slopify@latest
+```
+
+The bundled ffmpeg is a separate program under the GPL-3.0-or-later licence. Slopify runs it as a separate process and does not link to it.
+
+## 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.
+
+## Anonymous usage stats
+
+The first time you open Slopify it shows **Anonymous usage stats**, a notice listing exactly what is counted, with one button, **Got it**. These counts feed the live totals on slopify.stream.
+
+| Tracked | Never tracked |
+| --- | --- |
+| Tokens in and out per stage, with provider and model | API keys |
+| Audio seconds, images, thumbnails, videos rendered | Prompt bodies and keyword values |
+| PDF documents, YouTube descriptions and shorts made | Titles, article or research text |
+| Projects created, and that this machine installed Slopify | Files and file names |
+| The time each of those happened | OS, locale, hardware |
+
+Each report carries a random id of its own, a random id for this machine and the Slopify version. There is no setting to turn it off. Settings → **Usage** shows the same counters for your machine only.
+
+## If it doesn't start
+
+| Message | What to do |
+| --- | --- |
+| `Port 6969 is already in use by another program (maybe another Slopify)` | Stop the other program, or start on another port: `npx @gentbajko/slopify --port 7070`. |
+| `Slopify is not allowed to use port …` | Pick a port above 1024 with `--port`. |
+| `Slopify can't listen on … because that address doesn't belong to this machine` | Leave out `--host` and `SLOPIFY_HOST`. |
+| `Slopify can't write to its data folder …` | Make sure your user owns that folder, or choose another with `--data-dir <folder>`. |
+| `The disk is full` | Free some space and start again. |
+| `Slopify could not download and start ffmpeg` | Check your connection and whether antivirus quarantined it, or set `SLOPIFY_FFMPEG`. |
+| `Slopify is already running on this data directory` | Use the Slopify that is already running, or close it first. If none is running, delete the lock file the message names. |
+
+More in [Troubleshooting](Troubleshooting).
+
+## Related pages
+
+- [Docker](Docker)
+- [First Launch and Welcome](First-Launch-and-Welcome)
+- [Where Your Files Live](Where-Your-Files-Live)
+- [Start at Login](Start-at-Login)
+- [Updating and Patch Notes](Updating-and-Patch-Notes)
+- [Providers and Keys](Providers-and-Keys)
+- [AI CLIs](AI-CLIs)
+- [Troubleshooting](Troubleshooting)

package/dist/tutorials/Intros-and-Outros.md

@@ -0,0 +1,86 @@
+# Intros and Outros
+
+Intros and outros are short narrated passages read before and after the body of a video, in the same voice: a greeting, a series tagline, a sign-off, a call to subscribe. Write one as fixed text, or as an instruction the text model answers fresh for each video.
+
+**Where to find it:** **Library → Intros & Outros**. Pick them on Play in the **Intro** and **Outro** pickers (Narration row → **Audio Advanced**), in **Edit project**, or as a channel default in the channel's brand kit.
+
+## Text or LLM
+
+Each entry has a **Mode**:
+
+| Mode | What happens | Extra cost |
+|---|---|---|
+| **Text** (default) | "Text is narrated as written." Keywords are filled in, with no extra call. | Only the voice request |
+| **LLM** | "LLM is an instruction whose answer is narrated." The body goes to the project's text model with the title, the keyword values and the article, and the answer is narrated. The run then needs an LLM. | One text call per entry, plus the voice request |
+
+Either way the intro or outro is narrated as its own audio file with the run's voice: one voice request each.
+
+## Write an intro or outro
+
+1. Open **Library → Intros & Outros**.
+2. Choose **Intros** or **Outros** with **Entry category**.
+3. Press **New intro or outro**.
+4. Fill in the editor:
+   - **Name**: what Play and Edit project list it by. Up to 200 characters, unique within its category.
+   - **Category**: **Intro** (read before the body) or **Outro** (read after it). You can change it later.
+   - **Mode**: **Text** or **LLM**.
+   - **Body**: in Text mode, the words the narrator says; in LLM mode, the instruction whose answer is said. Each `{{keyword}}` becomes a field on Play, just like in prompts.
+5. Press **Save** (or `Ctrl+S`).
+
+### Examples
+
+A text intro:
+
+```
+Welcome back to the channel. Tonight: {{Topic}}. Get comfortable.
+```
+
+An LLM outro:
+
+```
+Write two sentences that close this video warmly. Mention one idea from the article
+the listener can think about tonight. Do not ask them to subscribe.
+```
+
+## Use one in a video
+
+**On Play:**
+
+1. Open the **Narration** row with **Change**, then open **Audio Advanced**.
+2. Pick an entry in **Intro** and, if you like, in **Outro**. **Off** reads none.
+3. Fill in any new keyword fields the entry added.
+
+**From the Library:** press **Use in Play** on the entry's row. It is picked in your open Play draft and Play opens on its field.
+
+**For a whole channel:** open **Channels** → the channel → **Brand** and set **Intro** and **Outro** under the brand kit. Every video of that channel whose template has no intro or outro of its own gets them. See [Channels](Channels).
+
+**In a finished project:** open **Edit project**, pick a different intro or outro, and save. Only the parts that change are remade. See [Editing a project](Editing-a-Project).
+
+## Edit, duplicate, delete and history
+
+Entries have the same row actions as prompts:
+
+| Action | What it does |
+|---|---|
+| **Edit** | Opens the editor. Change it and press **Save**. |
+| **Duplicate** | Opens the editor with a copy to rename and save. |
+| **Use in Play** | Picks the entry in the open Play draft. |
+| **History** | Versions, compare and **Used by**, exactly as for prompts. See [Prompts](Prompts#history-and-versions). |
+| **Delete** | Asks first, then moves it to **Settings → Trash** for 30 days. |
+
+Use **Search intros and outros** (`/`) to find one by name. The pencil beside a name renames the entry in its row, with **Undo** on the notice; see [Rename in the row](Library-Overview#rename-in-the-row).
+
+A project keeps its own copy of the intro and outro it started with, so editing an entry here changes only runs started later. Templates keep their own copies too.
+
+## Tips
+
+- Keep intros short. Viewers leave during long openings; two sentences is plenty.
+- An LLM outro that summarises the video costs one small text call and never repeats itself across videos.
+- Put the channel's standard intro and outro in the brand kit instead of every template.
+
+## Related pages
+
+- [Narration](Play-Narration)
+- [Prompts](Prompts)
+- [Channels](Channels)
+- [Library overview](Library-Overview)

package/dist/tutorials/Keyboard-Shortcuts-and-Command-Palette.md

@@ -0,0 +1,215 @@
+# Keyboard Shortcuts and Command Palette
+
+The command palette lets you reach every screen, every project and the frequent actions by typing, without hunting for buttons. Keyboard shortcuts cover the most common moves. This page lists both.
+
+**Where to find it:** press `Ctrl+K` (`Cmd+K` on a Mac) anywhere, or choose **Search or run a command** at the top of the sidebar. Press `?` for the list of keyboard shortcuts.
+
+## Use the command palette
+
+1. Press `Ctrl+K`.
+2. Type a few letters of what you want, such as `set` for **Open settings** or `back` for **Back up now**. Letters only need to appear in order, so `nwv` finds **New video**. Commands also match other words, for example `keys` finds **Open settings**. Several words match in any order across the command's name, the project it acts on and its other words: `cleopatra regenerate image 3` finds **Regenerate image 3 in Cleopatra**.
+3. Use `Up` and `Down` to move through the list, `Home` and `End` to jump to the first or last, and `Enter` to run the highlighted command. You can also click a command.
+4. Press `Esc` (or `Ctrl+K` again) to close the palette without running anything.
+
+The palette lists what you can do from where you are. Commands about the screen in front of you (the project you have open, for example) are listed first, with the project or item name beside them. Some commands are only found once you type: every project by name, and New schedule and Add to calendar from other screens (see [From anywhere](#from-anywhere)). If nothing matches, it says so; try fewer letters or another word.
+
+A command that has a shortcut shows its keys beside it.
+
+## Keyboard shortcuts
+
+Press `?` anywhere (outside a text field) to see **Keyboard shortcuts**: every key that works on the screen you are on. `Ctrl` works as `Cmd` on a Mac. Keys without `Ctrl` wait while you type in a field, so typing a `c` into a title never opens Play. Two keys like `G` then `H` are pressed one after the other.
+
+| Keys | Where | What it does |
+|---|---|---|
+| `Ctrl+K` / `Cmd+K` | Anywhere | Opens or closes the command palette. |
+| `?` | Anywhere | Shows the keyboard shortcuts. |
+| `C` | Anywhere | **New video** (opens Play). |
+| `G` then `H` | Anywhere | Go to Home. |
+| `G` then `P` | Anywhere | Go to Projects. |
+| `G` then `C` | Anywhere | Go to the Calendar. |
+| `G` then `S` | Anywhere | Go to Schedules. |
+| `G` then `L` | Anywhere | Go to the Library. |
+| `G` then `K` | Anywhere | Go to Channels. |
+| `G` then `,` | Anywhere | Go to Settings. |
+| `/` | Projects, Library → Prompts, Library → Intros & Outros | Puts the cursor in the list's search box. |
+| `Shift+N` | A project page | Runs the project's next action (Approve, Try again, Prepare upload…). |
+| `Shift+D` | A project page | Copies the YouTube description. |
+| `Ctrl+S` / `Cmd+S` | The Library editors (prompts, intros and outros, document themes) | Saves, even while you are typing in a field. |
+| `Up` / `Down`, `Home` / `End`, `Enter`, `Esc` | Command palette | Move, jump, run, close. |
+| `Ctrl+Enter` / `Cmd+Enter` | Play | Opens **Review the whole setup** without starting a run. |
+| `Space` or `K`, `J` / `L`, `Left` / `Right`, `M`, `F`, `C`, `0`–`9` | Inside a video or audio player | Play and pause, jump 10 seconds, jump 5 seconds, mute, full screen, captions, jump to a tenth of the way. See [Project Page](Project-Page#the-players). |
+| `Enter` / `Shift+Enter` | Search box in a reading view (research, article, narration text, patch notes) | Next match / previous match. |
+| `Left` / `Right` | Image viewer (an enlarged image or thumbnail on a project) | Previous / next image. |
+| `Esc` | Dialogs, side drawers, the image viewer | Closes them. |
+| `Esc` | Adding another title on Play | Cancels adding it. |
+| `Esc` | Guided tour | Closes an open picker first; press again to leave the tour. |
+| `Left` / `Right`, `Home` / `End` | Tabs (for example on a project page) | Move between the tabs. |
+| `Left` / `Right` | Segmented choices (for example **Appearance** in Settings) | Move between the options. |
+
+Everything else is in the palette.
+
+## Palette commands
+
+Commands are grouped under headings in the palette. Group names below are the headings you see.
+
+### Go to (everywhere)
+
+| Command | What it does |
+|---|---|
+| **Open home** | Goes to Home. |
+| **Open projects** | Goes to Projects. |
+| **Open channels** | Goes to Channels. |
+| **Open schedules** | Goes to Schedules. |
+| **Open calendar** | Goes to the Calendar. |
+| **Open library** | Goes to the Library (Prompts). |
+| **Open settings** | Goes to Settings. |
+| **Open usage and costs** | Goes to Settings → Usage. |
+| **Show patch notes** | Goes to Settings → Patch notes. |
+
+### Create and Channel (everywhere)
+
+| Command | What it does |
+|---|---|
+| **New video** (`C`) | Opens Play. |
+| **Show all channels** | Shows every channel's projects, schedules and costs. |
+| **Switch to <channel>** | Shows one channel only. There is one command per channel. |
+
+### From anywhere
+
+These are found once you type, from any screen:
+
+| Command | What it does |
+|---|---|
+| **Open <project>** | Opens any project by name, for example `hypatia` finds **Open Hypatia of Alexandria**. |
+| **Regenerate image N in <project>** | Type the project, the words and the number, for example `cleopatra regenerate image 3`. It opens that project on its Images and asks before redrawing, as the Regenerate button does. |
+| **New schedule** | Opens Schedules with a new schedule started. |
+| **Add to calendar** | Opens the Calendar with the Add to calendar form. |
+| **Show keyboard shortcuts** (`?`) | Lists every shortcut that works here. |
+
+### Open a tutorial page
+
+These tutorial pages are also inside Slopify, under **Help → Tutorials**. Type `tutorial` and a few words of a page's name, then pick **Open tutorial: <page>**, for example **Open tutorial: Install** or **Open tutorial: Shorts**. It opens that page at `/help/tutorials/<Page>`, where a search box finds any page. **Open tutorials** (under Go to) opens the tutorials' home page, and on the tutorials page `/` puts the cursor in that search box.
+
+### Play
+
+On the Play screen.
+
+| Command | What it does |
+|---|---|
+| **Start run** / **Queue N videos** | Starts the run, or queues every video on the page. If something is missing, it takes you to the field that needs it. |
+| **Add a topic for another video** | Adds another title to make a batch. |
+| **Save as template** | Saves the current setup as a template. |
+| **Review the whole setup** (`Ctrl+Enter`) | Opens the full review. |
+| **Pick a template** | Moves to the template picker. |
+| **Change title and keywords**, **Change article**, **Change narration**, **Change images**, **Change video and style**, **Change outputs**, **Change reviews**, **Change channel** | Opens that part of the setup and scrolls to it. |
+
+See [Play-Overview](Play-Overview).
+
+### This project
+
+On a project's page. The project's title shows beside each command.
+
+| Command | What it does |
+|---|---|
+| The next action (for example **Continue the run**, **Try images again**, **Prepare upload**) (`Shift+N`) | Runs what the project page suggests next. Shows **Show the project's next action** when there is none. |
+| **Pause the run** / **Continue the run** | Pauses or resumes the run. |
+| **Cancel the run** | Asks to cancel the run. |
+| **Prepare upload** | Opens the upload pack once the video has been made. |
+| **Edit project settings** | Opens Edit project. |
+| **Choose what to remake** | Opens the review of everything a change affects. |
+| The first outdated group / **Remake outdated outputs** | Remakes the first group of outdated outputs. Says so when nothing is outdated. |
+| **Remake everything outdated** | Remakes all outdated outputs. |
+| **Save as template** | Saves this project's setup as a template. |
+| **Make my own copy** | On a sample project, makes an editable copy. |
+| **Open the project folder** | Opens the project's folder on this computer. |
+| **Regenerate image N** / **Regenerate on-screen card N** | Redraws that image, including images behind **Show all**. Type the number, for example `regenerate image 12`. It asks first, as the Regenerate button does. |
+| **Regenerate the thumbnail** / **Regenerate thumbnail N** | Redraws a thumbnail. |
+| **Copy description** (`Shift+D`) | Copies the YouTube description, placeholders filled. |
+| **Copy tags** | Copies the YouTube tags. |
+
+See [Project-Page](Project-Page) and [Video-Editing](Video-Editing).
+
+### Needs you and Ready to upload
+
+On Home.
+
+| Command | What it does |
+|---|---|
+| **Approve the article and record**, **Approve and draw the images**, **Approve and render** | Approves a run held at a review. One per held project; **Open the held run** when there is nothing to approve here. |
+| **Mark uploaded** | Takes a finished video off the Ready to upload list. One per video. |
+
+See [Home-and-Projects](Home-and-Projects) and [Reviews-and-Checkpoints](Reviews-and-Checkpoints).
+
+### Projects
+
+On the Projects list.
+
+| Command | What it does |
+|---|---|
+| **Show projects that need you** | Filters to projects waiting for you. |
+| **Show videos ready to upload** | Filters to finished videos. |
+| **Show failed projects** | Filters to failed projects. |
+| **Search projects** (`/`) | Puts the cursor in the search box. |
+
+### Library
+
+On any Library tab.
+
+| Command | What it does |
+|---|---|
+| **New prompt** | Starts a new prompt (of the kind the tab shows). |
+| **New intro or outro** | Starts a new intro or outro. |
+| **New document theme** | Starts a new document theme. |
+| **Open prompts**, **Open intros and outros**, **Open templates**, **Open document themes** | Switches tab. |
+| **Save a setup as a template** | On the Templates tab: saves a Play setup as a template. |
+
+See [Library-Overview](Library-Overview).
+
+### Channels
+
+| Command | Where | What it does |
+|---|---|---|
+| **New channel** | Channels | Starts a new channel. |
+| **Add to cast** | A channel's page | Adds a character, creature, place or object to its cast. |
+
+See [Channels](Channels) and [Cast-Library](Cast-Library).
+
+### Schedules and Calendar
+
+| Command | Where | What it does |
+|---|---|---|
+| **New schedule** | Schedules (from anywhere once you type it) | Starts a new schedule. |
+| **Pause schedule** / **Resume schedule** | Schedules, with one open | Pauses or resumes it. |
+| **Add to calendar** | Calendar (from anywhere once you type it) | Adds topics to the calendar. |
+| **Show the calendar as weeks** / **Show the calendar as a list** | Calendar | Switches the view. |
+| **Queue all suggested topics** | Calendar | Accepts every topic a schedule suggested. One per schedule with suggestions. |
+
+See [Schedules](Schedules) and [Calendar](Calendar).
+
+### Settings
+
+In Settings.
+
+| Command | What it does |
+|---|---|
+| **Check all providers** | Opens Providers and runs Check all. |
+| **Back up now** | Opens Backups and starts a backup. |
+| **Download diagnostics** | Saves `slopify-diagnostics.json`. |
+| **Export everything** | In Backup & storage: downloads the full export. |
+| **Check for new models** | In Models: checks the catalogue now. |
+
+See [Settings-Reference](Settings-Reference).
+
+## Tips
+
+- The fastest way around: `Ctrl+K`, a few letters, `Enter`. For example `Ctrl+K`, `usage`, `Enter` opens your usage. For the main screens, `G` and a letter is faster still.
+- On a project, `Ctrl+K` lists that project's commands first, so the next action is a few letters away (try `next` or `continue`).
+- On Play, `Ctrl+Enter` is a safe way to check everything: it opens the review and never starts a run.
+
+## Related pages
+
+- [Play-Overview](Play-Overview)
+- [Project-Page](Project-Page)
+- [Home-and-Projects](Home-and-Projects)
+- [Settings-Reference](Settings-Reference)
+- [FAQ](FAQ)

package/dist/tutorials/Library-Overview.md

@@ -0,0 +1,75 @@
+# Library Overview
+
+The Library holds the reusable pieces your videos are made from: prompts, intros and outros, templates, PDF document themes and narration aliases. Write a piece once and pick it on Play for every video that needs it.
+
+**Where to find it:** **Library** in the sidebar. It opens on **Prompts**; the tabs across the top switch sections.
+
+## The five tabs
+
+| Tab | What it holds | Page |
+|---|---|---|
+| **Prompts** | The instructions for articles, images, thumbnails, narration cues, YouTube descriptions, shorts, reviews and multi-voice scripts, each with `{{keywords}}` where the subject goes | [Prompts](Prompts) |
+| **Intros & Outros** | Short narrated openings and closings, written as text or generated by the text model | [Intros and outros](Intros-and-Outros) |
+| **Templates** | Saved Play setups, and **Add pack** for the starter packs | [Templates](Templates) |
+| **Documents** | Document themes: the look of the PDF made from the article | [Document themes](Document-Themes) |
+| **Aliases** | Words the narrator says differently from how they are written, such as Dr. as Doctor | [Aliases and glossary](Narration-Aliases-and-Glossary) |
+
+## What every Library list has
+
+Prompts, Intros & Outros and Templates share the same row actions, in the same order:
+
+| Action | What it does |
+|---|---|
+| **Edit** | Opens the item in its editor. (A template has no editor: Edit picks it and shows its keywords beside the list.) |
+| **Duplicate** | Opens the editor with a copy, for you to rename and save. (A template is copied as `<name> copy` at once.) |
+| **Use in Play** | Picks the item in your open Play draft and opens Play on the field that shows it. An article prompt switches the article to Generate, an image prompt is ticked with one image, a thumbnail prompt switches the thumbnail to From prompt, and a Description or Shorts prompt turns that step on. The rest of the draft stays as it was. The button is off while Play is starting a run. |
+| **History** | Opens the item's versions, a side-by-side compare, and what uses it. See [Prompts](Prompts#history-and-versions). |
+| **Delete** | Asks first, then moves the item to **Settings → Trash** for 30 days. See [Trash](Trash). |
+
+Your document themes have Edit, Duplicate and Delete, but no Use in Play or History. Built-in themes can only be copied.
+
+A press anywhere on a row picks it; the row's own buttons still do their own thing. Beside each list, the selected item shows its text, its **Keywords**, what it is **Used by**, and its latest change.
+
+### Rename in the row
+
+In Prompts, Intros & Outros and Templates, the pencil beside a name (**Rename <name>**) turns the name into a field. Type the new name and press **Save name** or Enter; `Esc` or **Cancel** keeps the old one. Only the name changes, and the notice ("Renamed “A” to “B”.") has **Undo**. A prompt's or entry's rename is one History version; a template's is a new template version.
+
+### Save with Ctrl+S
+
+In the prompt, intro and outro and document theme editors, `Ctrl+S` (`Cmd+S`) saves, even while you are typing in a field.
+
+## Search and filter
+
+- **Prompts** has a **Prompt kind** picker (Article, Image, Thumbnail, Narration Preparation, YouTube Description, Shorts, Review, Script (speakers)) and **Search prompts**.
+- **Intros & Outros** has **Search intros and outros**.
+- **Templates** has **Show templates of** to filter by channel.
+- Press `/` on Prompts or Intros & Outros to jump to the search box.
+
+## Command palette shortcuts
+
+Press `Ctrl+K` anywhere and type to find **New prompt**, **New intro or outro**, **New document theme**, **Open prompts**, **Open intros and outros**, **Open templates** or **Open document themes**. See [Keyboard and Ctrl+K](Keyboard-Shortcuts-and-Command-Palette).
+
+## Starter packs
+
+**Library → Templates → Add pack** adds a ready-made set for one kind of channel: prompts, a suggested voice and a Play template. There are four packs: Sleep lore, True crime, History and Science explainers. Adding one twice changes nothing, and a pack never replaces a prompt or template of yours with the same name. See [Templates](Templates#starter-packs).
+
+## Fonts
+
+The Library has no separate font manager. Fonts live where they are used:
+
+- **Caption (subtitle) fonts:** upload your own in the subtitle font picker on Play's video style settings. Uploaded fonts then appear in a channel's brand kit too. See [Video and style](Play-Video-and-Style) and [Channels](Channels).
+- **PDF fonts:** each document theme picks its fonts from the bundled Cinzel and the fonts built into every PDF reader (Times, Helvetica, Courier). See [Document themes](Document-Themes).
+
+Uploaded fonts travel in backups, but templates leave them out.
+
+## How changes reach your videos
+
+A project copies the prompts, intros, outros, aliases and theme settings it uses when it starts. Editing the Library later changes only runs started afterwards. Templates also keep their own copies, so save a template again to pick up a changed prompt. In a project, **Edit project** shows the project's own copy of each prompt: pick the Library prompt again (or press **Use the Library version**) to bring in your latest edit, and press **Update from Library** under narration aliases to copy the current alias list. See [Editing a project](Editing-a-Project).
+
+## Related pages
+
+- [Prompts](Prompts)
+- [Intros and outros](Intros-and-Outros)
+- [Templates](Templates)
+- [Document themes](Document-Themes)
+- [Aliases and glossary](Narration-Aliases-and-Glossary)