@gentbajko/slopify 3.9.1 → 3.10.0

package/dist/tutorials/Settings-Reference.md

@@ -2,26 +2,25 @@
 
 Every section of Settings, what each control does and its default. Sections with a page of their own are summarised here and linked for the details.
 
-**Where to find it:** **Settings** in the sidebar, or press `Ctrl+K` and run **Open settings**. Settings opens on **Providers**. Pick a section in the rail on the left; on a phone the rail is a row of tabs you can scroll sideways.
+**Where to find it:** **Settings** in the sidebar, or press `Ctrl+K` and run **Open settings** (or **Open Settings: <section>** for one section). Settings opens on **Connections → Providers**. The rail on the left has seven groups; a group with more than one section shows them as tabs across the top. On a phone the rail is a row of tabs you can scroll sideways. An old link to a section (`?section=backups`, for example) still opens where it went.
 
 ## Sections at a glance
 
-| Section | What it holds | Details |
-|---|---|---|
-| [General](#general) | Starting Slopify when you log in | [Start-at-Login](Start-at-Login) |
-| [Providers](#providers) | API keys, command-line tools, the system voice, health check | [Providers-and-Keys](Providers-and-Keys), [AI-CLIs](AI-CLIs) |
-| [Voices](#voices) | Voice IDs for narration | [Providers-and-Keys](Providers-and-Keys#add-a-voice) |
-| [Models](#models) | Model catalogue, retired models | [Models](Models) |
-| [Playback & appearance](#playback--appearance) | Silence gap, light or dark, volume levelling | This page |
-| [Notifications](#notifications) | Browser and phone notifications | [Notifications](Notifications) |
-| [Channel links](#channel-links) | A pointer to each channel's own links | [Channels](Channels#channel-links) |
-| [YouTube Studio](#youtube-studio) | Playlists per channel, the Studio extension's download and pairing | [Studio-Extension](Studio-Extension) |
-| [Backup & storage](#backup--storage) | Your files folder, export and import, disk space, samples | [Where-Your-Files-Live](Where-Your-Files-Live) |
-| [Backups](#backups) | The daily automatic backup | [Backups](Backups) |
-| [Trash](#trash) | Deleted items, kept 30 days | [Trash](Trash) |
-| [Usage](#usage) | This install's counters | [Costs-and-Run-Cost](Costs-and-Run-Cost#your-usage-totals-settings--usage) |
-| [Patch notes](#patch-notes) | What changed in each version | [Updating-and-Patch-Notes](Updating-and-Patch-Notes) |
-| [About](#about) | Updates, what's new, links | [Updating-and-Patch-Notes](Updating-and-Patch-Notes) |
+| Group | Section | What it holds | Details |
+|---|---|---|---|
+| Connections | [Providers](#providers) | API keys, command-line tools, the system voice, health check | [Providers-and-Keys](Providers-and-Keys), [AI-CLIs](AI-CLIs) |
+| Connections | [Voices](#voices) | Voice IDs for narration | [Providers-and-Keys](Providers-and-Keys#add-a-voice) |
+| Connections | [Models](#models) | Model catalogue, retired models | [Models](Models) |
+| Production defaults | [Production defaults](#production-defaults) | Silence gap, volume levelling for new runs | This page |
+| Notifications | [Notifications](#notifications) | Browser and phone notifications | [Notifications](Notifications) |
+| Publishing | [Channel links](#channel-links) | A pointer to each channel's own links | [Channels](Channels#channel-links) |
+| Publishing | [YouTube Studio](#youtube-studio) | Playlists per channel, the Studio extension's download and pairing | [Studio-Extension](Studio-Extension) |
+| Backup & storage | [Backup & storage](#backup--storage) | Your files folder, daily backups, export and import, disk space, samples | [Where-Your-Files-Live](Where-Your-Files-Live), [Backups](Backups) |
+| Backup & storage | [Trash](#trash) | Deleted items, kept 30 days | [Trash](Trash) |
+| General | [General](#general) | Light or dark, and starting Slopify when you log in | [Start-at-Login](Start-at-Login) |
+| About | [About](#about) | Updates, what's new, links, the welcome screen | [Updating-and-Patch-Notes](Updating-and-Patch-Notes) |
+| About | [Usage](#usage) | This install's counters | [Costs-and-Run-Cost](Costs-and-Run-Cost#your-usage-totals-settings--usage) |
+| About | [Patch notes](#patch-notes) | What changed in each version | [Updating-and-Patch-Notes](Updating-and-Patch-Notes) |
 
 ## Download diagnostics
 
@@ -35,7 +34,15 @@ You can also press `Ctrl+K` and run **Download diagnostics** from anywhere in Se
 
 ## General
 
-"How Slopify starts on this computer."
+"How Slopify looks and how it starts on this computer."
+
+### Appearance
+
+| Control | What it does | Default |
+|---|---|---|
+| **Appearance** | **System**, **Dark** or **Light** colours for Slopify on this computer. System follows your operating system and changes with it. It changes at once and does not affect your videos. | System |
+
+### Start at login
 
 | Control | What it does | Default |
 |---|---|---|
@@ -92,9 +99,9 @@ See [Providers-and-Keys](Providers-and-Keys#add-a-voice).
 
 Templates and schedules that pick a retired model are also flagged on their own rows, with the same **Switch to <model>**. See [Models](Models).
 
-## Playback & appearance
+## Production defaults
 
-"How narration is paced and how Slopify looks."
+"How new runs pace the narration and level the volume."
 
 ### Silence between segments
 
@@ -104,12 +111,6 @@ Templates and schedules that pick a retired model are also flagged on their own
 
 Videos already started keep their own gap. A value that is not a whole number from 0 to 30 is refused with "The silence gap is a whole number of seconds between 0 and 30." See [Intros-and-Outros](Intros-and-Outros).
 
-### Appearance
-
-| Control | What it does | Default |
-|---|---|---|
-| **Appearance** | **System**, **Dark** or **Light** colours for Slopify on this computer. System follows your operating system and changes with it. It changes at once and does not affect your videos. | System |
-
 ### Level the volume for new runs
 
 | Control | What it does | Default / range |
@@ -154,7 +155,7 @@ See [Studio-Extension](Studio-Extension) and [Publishing-to-YouTube](Publishing-
 
 ## Backup & storage
 
-"Export everything, import a backup, and see what uses disk space."
+"Daily backups, export and import, and what uses disk space." Its second tab is [Trash](#trash).
 
 ### Your files
 
@@ -172,7 +173,7 @@ In Docker, this shows the command to run on the computer running Docker, with **
 |---|---|
 | **Export everything** | Downloads one `.tar` file with every project (files and history), your library, templates, schedules, Play drafts, fonts, settings and usage. Never provider keys. Your browser's downloads show its progress; keep Slopify running until it finishes. |
 | **Import a backup** | Adds a `.tar` from Export everything (or a `.zip` from an older version's Export backup, up to 100 MB) to this install. It replaces nothing: projects already here are skipped, taken names arrive as "(imported)" and schedules arrive paused. Running projects must finish or pause first. A summary lists what was added and skipped. |
-| **Clean orphan files** | Deletes files in the projects folder that no project records any more, and uploaded files nothing uses. Your projects, outputs and library are never touched. Slopify also does this at each start. |
+| **Clear leftover files** | Deletes files in the projects folder that no project records any more, and uploaded files nothing uses. Your projects, outputs and library are never touched. Slopify also does this at each start. |
 
 After importing, enter your keys again in Settings → Providers. You can also run **Export everything** from `Ctrl+K`. See [Backups](Backups).
 
@@ -191,9 +192,9 @@ After importing, enter your keys again in Settings → Providers. You can also r
 | **Sample projects** | Lists the three samples that come with Slopify (a narrated video, an audiobook and a podcast), with **Open** for each one in your projects. |
 | **Restore samples** | Adds back any that were deleted and puts the others back as they shipped. Your own copies of them are not touched. |
 
-## Backups
+### Daily backups
 
-"A daily copy of everything, in a folder you choose."
+"A daily copy of everything, in a folder you choose." On the Backup & storage tab.
 
 | Control | What it does | Default / range |
 |---|---|---|
@@ -208,12 +209,13 @@ Each backup is the same file Export everything makes and can be many gigabytes.
 
 ## Trash
 
-"Deleted projects, prompts, templates and schedules, kept for 30 days."
+"Deleted projects, prompts, templates and schedules, kept for 30 days." A tab of **Backup & storage**.
 
 | Control | What it does |
 |---|---|
 | **Restore** | Puts an item back. If its name was taken meanwhile it comes back renamed, and a schedule comes back paused. |
 | **Delete now** | Removes an item for good at once, freeing its space. You confirm first. |
+| Checkboxes and **Select all** | Pick several items; **Restore selected** and **Delete selected** above the list act on them. **Restore all** and **Empty trash** act on everything. |
 
 Deleted projects, prompts, intros and outros, templates and schedules stay 30 days, then are removed for good. See [Trash](Trash).
 
@@ -244,6 +246,8 @@ The notes ship with the app, so they work offline. After an update, the new vers
 | **What's new in this version** | Opens the patch notes for the version you are running. When this version has no notes of its own, it opens the newest ones. |
 | Links | GitHub (code, issues, releases), Patreon, Buy Me a Coffee, and "How I run a channel with it". |
 
+The welcome screen (what this computer can do, the samples, a first short) opens again from **Help → Tutorials → Welcome screen** or `Ctrl+K` → **Open the welcome screen**.
+
 Slopify is made by Gent Bajko under the Apache License 2.0. See [Updating-and-Patch-Notes](Updating-and-Patch-Notes).
 
 ## Related pages

package/dist/tutorials/Templates.md

@@ -112,7 +112,7 @@ Each template shows **Version N · updated** with the date. Schedules remember t
 1. Press the bin icon (**Delete <name>**) on the template's row.
 2. Confirm with **Delete template**.
 
-The template goes to **Settings → Trash** for 30 days, where you can restore it. A template that a schedule still runs can't be deleted: delete or change that schedule first. See [Trash](Trash).
+The template goes to **Settings → Backup & storage → Trash** for 30 days, where you can restore it. A template that a schedule still runs can't be deleted: delete or change that schedule first. See [Trash](Trash).
 
 ## Retired models
 

package/dist/tutorials/Trash.md

@@ -2,7 +2,7 @@
 
 Deleting something in Slopify does not remove it at once. Deleted projects, prompts, intros and outros, templates and schedules go to the trash for 30 days, where you can put them back or remove them for good.
 
-**Where to find it:** Settings → **Trash**.
+**Where to find it:** Settings → **Backup & storage** → **Trash**.
 
 ## What goes to the trash
 
@@ -10,7 +10,7 @@ Deleting something in Slopify does not remove it at once. Deleted projects, prom
 | --- | --- | --- |
 | Project | Project | Projects (the delete button on a project's row, then **Delete project**) |
 | Library prompt | Prompt · *type* (for example Prompt · article) | Library → Prompts |
-| Intro or outro | Intro or Outro | Library → Intros & Outros |
+| Intro or outro | Intro or Outro | Library → Intros & outros |
 | Template | Template | Templates |
 | Schedule | Schedule | Schedules |
 
@@ -20,7 +20,7 @@ Each row in the trash shows the item's name, its kind, when it was deleted and h
 
 ## Restore an item
 
-1. Open Settings → **Trash**.
+1. Open Settings → **Backup & storage** → **Trash**.
 2. Find the item under **Deleted items**.
 3. Press **Restore**.
 
@@ -36,7 +36,7 @@ It comes back as it was. A few kinds have their own rules:
 
 ## Delete an item for good
 
-1. Open Settings → **Trash**.
+1. Open Settings → **Backup & storage** → **Trash**.
 2. Press **Delete now** on the item.
 3. Confirm with **Delete for good**, or press **Keep it**.
 
@@ -52,7 +52,7 @@ There is no button to empty the whole trash at once; each item is deleted on its
 
 Anything in the trash for more than 30 days is removed for good by a daily clean-up, the same way as **Delete now**. Slopify checks hourly whether a day has passed since the last clean-up, so a computer that was asleep catches up. If one item cannot be removed (for example a project folder another program has open), it stays in the trash for the next pass and the rest still go.
 
-A project's disk space is freed only when it leaves the trash. Settings → **Storage** counts deleted projects still in the trash. See [Where Your Files Live](Where-Your-Files-Live).
+A project's disk space is freed only when it leaves the trash. Settings → **Backup & storage** counts deleted projects still in the trash. See [Where Your Files Live](Where-Your-Files-Live).
 
 ## What cannot be deleted
 

package/dist/tutorials/Troubleshooting.md

@@ -95,7 +95,7 @@ See [Install](Install) for the command-line options.
 | "Slopify hit an unexpected error (*code*). Reload the page and try again." | Reload. If it keeps happening, download diagnostics and report it. |
 | "The project could not be loaded." | Reload, or go back to Projects. |
 | "The upload stopped before the file finished copying. Choose the file again." | Pick the file again and wait for "Waiting for uploads to finish…" to clear before saving. |
-| "A newer revision is available. Your unsaved changes are kept below." | The project was saved elsewhere (another tab, a remake). Press **Reload current revision and discard my draft**, or keep your draft and save it. |
+| "A newer revision is available. Your unsaved changes are kept below and in this browser." | The project was saved elsewhere (another tab, a remake). Press **Reload latest and re-apply my edit** to lay your changes over the newer revision, check them and press **Save changes**; **Copy my edit** puts your changes on the clipboard first. |
 
 ## Disk space
 
@@ -112,7 +112,7 @@ See [Where Your Files Live](Where-Your-Files-Live).
 | Topic | Native install | Docker |
 | --- | --- | --- |
 | Where it runs | Any system with Node 26 or newer | The installer is Linux only; Docker Desktop and remote Docker daemons are refused, and the installer must not be run with sudo |
-| Project files | `Documents/Slopify` for new installs (Settings → **Your files**); the database, settings and keys stay in the hidden data folder (`~/.slopify` by default, `--data-dir`) | `<Documents>/Slopify/Projects` on the host for new installs (`~/Slopify/Projects` on one from before 3.0); the database and keys stay in the `slopify-data` volume |
+| Project files | `Documents/Slopify` for new installs (Settings → **Backup & storage** → **Your files**); the database, settings and keys stay in the hidden data folder (`~/.slopify` by default, `--data-dir`) | `<Documents>/Slopify/Projects` on the host for new installs (`~/Slopify/Projects` on one from before 3.0); the database and keys stay in the `slopify-data` volume |
 | AI CLIs | Run directly with your logins | Run on the host through a small helper, `slopify-cli-bridge.service`, with your existing logins. Check it with `systemctl --user status slopify-cli-bridge.service`. Without it, Settings shows the CLIs as unavailable. |
 | **Open folder** | Opens your file manager | Opens it through the host helper; without the helper you get the path to copy, and "run the Docker launcher again ... so it sets up the host helper" |
 | Start at login | Settings → General → **Start Slopify when I log in** | Slopify starts whenever Docker does; Settings only shows Docker's own setting (with Docker Desktop, its **Start Docker Desktop when you sign in**) |

package/dist/tutorials/Where-Your-Files-Live.md

@@ -100,7 +100,7 @@ Use `--projects-dir <folder>` for another folder. The installer waits for runnin
 | --- | --- |
 | **Export everything** | Downloads one `.tar` file with every project and its files and history, your library, templates, schedules, Play drafts, fonts, settings and usage. Never provider keys. Keep Slopify running until your browser's download finishes. |
 | **Import a backup** | Adds a `.tar` (or `.zip`) backup to this install and replaces nothing. Projects already here are skipped, taken names arrive as "(imported)" and schedules arrive paused. Running projects must finish or pause first. Afterwards a summary lists what was added and skipped. |
-| **Clean orphan files** | See below. |
+| **Clear leftover files** | See below. |
 
 After an import, enter your provider keys again in Settings → **Providers**. For daily automatic copies, see [Backups](Backups).
 
@@ -110,7 +110,7 @@ After an import, enter your provider keys again in Settings → **Providers**. F
 
 **Disk space** shows what Slopify stores on this computer: the total, project files (outputs plus the working files they were made from), staged uploads, and deleted projects still in the trash, for example "· 2.1 GB in the trash (3 deleted projects), freed when removed for good". Below it, every project is listed by size with its outputs and working files.
 
-Deleted projects free their space when the trash removes them after 30 days, or when you choose **Delete now** in Settings → **Trash**. See [Trash](Trash).
+Deleted projects free their space when the trash removes them after 30 days, or when you choose **Delete now** in Settings → **Backup & storage** → **Trash**. See [Trash](Trash).
 
 ### Keep outputs only
 
@@ -124,9 +124,9 @@ If you change that project later (edit an image, a caption style or the narratio
 
 A finished project's own page offers the same in its right rail: **Free space** with **Free 1.2 GB: keep the outputs, drop the working files** (see [Project Page](Project-Page#free-space)).
 
-### Clean orphan files
+### Clear leftover files
 
-**Clean orphan files** deletes files in the projects folder that no project records any more, and uploaded files that no draft, template or project uses. Your projects, outputs and library are never touched. Slopify also does this each time it starts; use it after a crash or to free space now.
+**Clear leftover files** deletes files in the projects folder that no project records any more, and uploaded files that no draft, template or project uses. Your projects, outputs and library are never touched. Slopify also does this each time it starts; use it after a crash or to free space now.
 
 Cleanup only looks inside `Projects`. It leaves `Backups` alone (only Slopify's own `slopify-backup-*.tar` files there are ever pruned, by the backup rules), leaves hidden files such as `.DS_Store` and `desktop.ini`, never removes loose files in a `Projects` folder outside the data folder, and never touches `Exports` or anything else in your files folder.