scenri 0.21.1 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.22.0](https://github.com/tonygorb/Scenri/compare/v0.21.2...v0.22.0) (2026-10-07)
+
+
+### Features
+
+* People and Places replace Presenters and Scenes ([6423c40](https://github.com/tonygorb/Scenri/commit/6423c40f3b19ff5e02b2fc780edbba13a0f17f92))
+* People and Places replace Presenters and Scenes in the studio ([593071a](https://github.com/tonygorb/Scenri/commit/593071a909ea4b8210e5ae9de426452454d24711))
+* Scenri points to scenri.co and its docs ([7ad12c5](https://github.com/tonygorb/Scenri/commit/7ad12c5379906adef0223fb8f0dfe8ccda76d1e0))
+* Scenri points to scenri.co and its docs ([a8b2e61](https://github.com/tonygorb/Scenri/commit/a8b2e6130905ad3c9f5316e63d6d43e802dc34f1))
+
+## [0.21.2](https://github.com/tonygorb/Scenri/compare/v0.21.1...v0.21.2) (2026-10-05)
+
+
+### Bug Fixes
+
+* declare the docs-impact script's types so its test typechecks ([f484a2d](https://github.com/tonygorb/Scenri/commit/f484a2daaca5e1d1fae65112d5066c6402a270a4))
+* **library:** replace the Halvard 12 product photo ([2a2172d](https://github.com/tonygorb/Scenri/commit/2a2172da4358935c2faf43f646a163d976fa4db1))
+* **library:** replace the Halvard 12 product photo ([1d06193](https://github.com/tonygorb/Scenri/commit/1d0619397bbf5a39c4b982db5cde1c7d9b8bbf3b))
+
 ## [0.21.1](https://github.com/tonygorb/Scenri/compare/v0.21.0...v0.21.1) (2026-10-04)
 
 

package/README.md

@@ -1,31 +1,35 @@
 <div align="center">
 
+<a href="https://scenri.co">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/logo-on-dark.svg">
   <img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/logo-on-light.svg" alt="Scenri" width="200">
 </picture>
+</a>
 <br><br>
 
 **The open-source AI photo studio that remembers your products, people and places.**<br>
 Save a brand's products from real photos, the people in its shots and its places once. Then each shot is one line, and every shot keeps its recipe, so you can refine it or make the next one match. It runs on your own computer and sends your pictures to the image model you already use.
 
+**[scenri.co](https://scenri.co)** · [Docs](https://scenri.co/docs)
+
 [![CI](https://github.com/tonygorb/scenri/actions/workflows/ci.yml/badge.svg)](https://github.com/tonygorb/scenri/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/scenri)](https://www.npmjs.com/package/scenri)
 [![License: AGPL v3](https://img.shields.io/badge/license-AGPL--3.0-blue)](https://github.com/tonygorb/scenri/blob/main/LICENSE)
 
 **Get started.** You need [Node.js](https://nodejs.org) 22 or newer, and a paid ChatGPT plan (used through Codex CLI, which Scenri sets up for you) or an [OpenRouter](https://openrouter.ai) API key to make pictures. Scenri itself has no account and no fees.
 
-<sub>If `npm --version` prints 12, run `npm config set allow-scripts=better-sqlite3 --location=user` once first ([why](https://github.com/tonygorb/scenri/blob/main/docs/INSTALL.md#troubleshooting)). Then:</sub>
+<sub>If `npm --version` prints 12, run `npm config set allow-scripts=better-sqlite3 --location=user` once first ([why](https://scenri.co/docs/troubleshooting/)). Then:</sub>
 
 ```bash
 npx scenri
 ```
 
-<sub>The first start downloads the Scenri library of example imagery, about 155 MB. New to any of this? The [install guide](https://github.com/tonygorb/scenri/blob/main/docs/INSTALL.md) walks through every step.</sub>
+<sub>The first start downloads the Scenri library of example imagery, about 155 MB. New to any of this? The [install guide](https://scenri.co/docs/install/) walks through every step.</sub>
 
-<img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/demo.gif" alt="Scenri's Create page: in the composer a dollar sign picks the product Cropped Puffer, an at sign picks the presenter Kwame, a slash picks the Container Blue scene, and a line of written direction follows the three chips. Generate turns a new card into a dithered swirl where the picture is being made, the swirl develops into a man in an orange puffer jacket leaning on a cobalt shipping container, and the shot opens beside the prompt that made it" width="820">
+<img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/demo.gif" alt="Scenri's Create page: in the composer a dollar sign picks the product Cropped Puffer, an at sign picks the person Kwame, a slash picks the place Container Blue, and a line of written direction follows the three chips. Generate turns a new card into a dithered swirl where the picture is being made, the swirl develops into a man in an orange puffer jacket leaning on a cobalt shipping container, and the shot opens beside the prompt that made it" width="820">
 
-<sub>Pick a product, pick a presenter, pick a scene, then write the direction. That is the prompt.</sub>
+<sub>Pick a product, pick a person, pick a place, then write the direction. That is the prompt.</sub>
 
 </div>
 
@@ -35,7 +39,7 @@ npx scenri
 
 Most AI image tools give you a prompt box and a slot machine. Scenri gives you the part that actually takes the time: **art direction**.
 
-You save a brand's ingredients once: its products from real photos, the people who appear in its shots (Scenri calls them Presenters), its places (Scenes) and its brand kit. Then a shot is one line. In the composer, `$` picks a product (what), `@` a person (who) and `/` a scene (where), and you write the direction in the same line. Open the shot, say what to change, and **Refine** keeps every step on a trail under the picture, so the original and every step stay one click apart.
+You save a brand's ingredients once: its products from real photos, the people who appear in its shots, its places and its brand kit. Then a shot is one line. In the composer, `$` picks a product (what), `@` a person (who) and `/` a place (where), and you write the direction in the same line. Open the shot, say what to change, and **Refine** keeps every step on a trail under the picture, so the original and every step stay one click apart.
 
 Every shot also keeps its recipe: the prompt, the chips and the settings that made it. Refine any step again, or use **Reuse setup** to start a new shot from the same prompt and chips, so the next one matches.
 
@@ -43,11 +47,11 @@ Scenri trains nothing. It sends your saved photos with each shot as reference im
 
 It runs as a local server on your own computer. Your brands, your images, and your keys stay on your disk. To use it from a phone or tablet on the same Wi-Fi, open Settings, Local access, and scan the QR code.
 
-The words Scenri uses are defined once in [Concepts](https://github.com/tonygorb/scenri/blob/main/docs/CONCEPTS.md), and the questions people ask first, from LoRAs to cost, are answered in the [FAQ](https://github.com/tonygorb/scenri/blob/main/docs/FAQ.md).
+The words Scenri uses are defined once in [Concepts](https://scenri.co/docs/concepts/), and the questions people ask first, from LoRAs to cost, are answered in the [FAQ](https://scenri.co/docs/faq/).
 
 ## What a prompt produces
 
-The film above ends on one of the examples from the Home wall: the Cropped Puffer product, the presenter Kwame, the Container Blue scene, and a short paragraph of written direction, of which the film types the first line. The chips carry the identity; the words do the art direction. Here are eight more shots from the Home wall, each built the same way from chips and written direction:
+The film above ends on one of the examples from the Home wall: the Cropped Puffer product, the person Kwame, the place Container Blue, and a short paragraph of written direction, of which the film types the first line. The chips carry the identity; the words do the art direction. Here are eight more shots from the Home wall, each built the same way from chips and written direction:
 
 <!-- One paragraph, no whitespace between the tags: a newline here renders as
 a fixed word-space, and 4 x 24.5% plus three spaces overflows a phone screen
@@ -57,29 +61,21 @@ All 110 examples on the Home wall work the same way. Open one and it loads back
 
 ## What you get out of the box
 
-<img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/library.gif" alt="Scenri's Home for a new brand: the four ways to start and the example tabs over the wall of finished shots, a slow scroll down the wall, then the Presenters library and the Scenes library, each opening with its offer to make your own above the catalog" width="820">
+<img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/library.gif" alt="Scenri's Home for a new brand: the four ways to start and the example tabs over the wall of finished shots, a slow scroll down the wall, then the People library and the Places library, each opening with its offer to make your own above the catalog" width="820">
 
-A library of 42 scenes, 19 presenters and 30 demo products, so the app is useful before you have uploaded anything of your own. Filter by category and star what fits the brand. Add your own products from their photos, and make your own presenters and scenes in a short conversation: describe a person or a place, or start from photos, and approve what Scenri draws before it is saved.
+A library of 42 places, 19 people and 30 demo products, so the app is useful before you have uploaded anything of your own. Filter by category and star what fits the brand. Add your own products from their photos, and make your own people and places in a short conversation: describe a person or a place, or start from photos, and approve what Scenri draws before it is saved.
 
 The brand kit lives in Settings and is the part that keeps output consistent. Name, mark, palette and rules, set once and carried into every shot that asks for them.
 
 ## Run it
 
-Scenri runs on [Node.js](https://nodejs.org), version 22 or newer. If you are not sure you have it, or terminals are not part of your day, the **[install guide](https://github.com/tonygorb/scenri/blob/main/docs/INSTALL.md)** covers every step for macOS, Windows and Linux. With Node in place:
+Node.js 22 or newer, then:
 
 ```bash
 npx scenri
 ```
 
-That is the whole install. npm asks once whether to proceed, downloads the current release, and opens `http://127.0.0.1:4747`. Keep the terminal window open while you work; closing it stops Scenri. Tomorrow the same command opens it again, with everything where you left it. Nothing here needs an administrator.
-
-On Windows, if PowerShell answers `npx.ps1 cannot be loaded because running scripts is disabled on this system`, that is a stock Windows setting, not a fault: type `npx.cmd scenri` instead, or use Command Prompt. Still no administrator required.
-
-On macOS and Windows, Scenri then asks once whether to put a **Scenri icon on your desktop**. Say yes and from then on a double-click starts Scenri and opens it in your browser, no terminal needed; the icon works offline and keeps working across updates. Said no? Settings, then Local access, then **Add to desktop**, or `npx scenri desktop` in a terminal. Scenri stays what it is, a local server and your browser: the icon is a launcher, not an app.
-
-Generation runs on **Codex CLI**, an official helper from OpenAI that draws on your own paid ChatGPT plan (Codex image generation is not part of the Free plan). No API key to paste, and Scenri never charges you. Each image spends some of your plan's Codex usage. You do not have to set it up by hand: if it is missing, Scenri offers to install it and to sign you in, both from the app. No ChatGPT plan? Add your own key from an image provider in Settings instead, see [Engines](#engines).
-
-One dependency, `better-sqlite3`, runs an install script that fetches its native binary. The npm that ships with current Node releases (npm 11) runs it without asking. npm 12 blocks dependency install scripts by default, so if `npm --version` prints 12, allow this one once with `npm config set allow-scripts=better-sqlite3 --location=user` before you run `npx scenri`. Something not starting? See [troubleshooting](https://github.com/tonygorb/scenri/blob/main/docs/INSTALL.md#troubleshooting).
+The [install guide](https://scenri.co/docs/install/) covers macOS, Windows, and Linux, including the desktop icon and the PowerShell case. The [quick start](https://scenri.co/docs/quick-start/) is the shortest path to one Shot. Generation is a separate step: [connect Codex or a provider key](https://scenri.co/docs/connect/). If `npm --version` prints 12, see [troubleshooting](https://scenri.co/docs/troubleshooting/) before the first run.
 
 <details>
 <summary>Run from source</summary>
@@ -94,41 +90,14 @@ pnpm dev          # starts the server on 127.0.0.1:4747
 
 </details>
 
-## First five minutes
-
-Scenri offers to walk you through your first shot, one step at a time, and Learn holds the rest. The short version:
-
-1. **Paste a website URL.** Scenri reads the public pages and drafts the kit: name, logo, palette. If the site sells things, it offers to add the products too.
-2. **Describe a shot.** In the composer, `$` reaches for a product, `@` for a presenter, `/` for a scene, and `#` for a colour. Everything between them is your own words.
-3. **Generate on Codex CLI.** Runs on your own paid ChatGPT plan, so there is no key and no per-image charge from us.
-4. **Refine it.** Open the shot and say what to change. Each refinement joins the trail under the picture.
-5. **Add your own key** in Settings, Providers to run on OpenRouter, Replicate or fal instead.
-
 ## Why it is built this way
 
-- **Iteration is the product.** Not a prompt box: every shot keeps its trail of refinements, and the ones you star collect in Keepers.
+- **Iteration is the product.** Not a prompt box: every shot keeps its trail of refinements, and the ones you mark collect in Keepers.
 - **Your brands are files, not hostages.** `.brand` is an open, documented format under a permissive license. Email one to a client. Any tool can adopt it.
 - **Your AI, your cost.** Bring your own ChatGPT plan through Codex CLI, or an API key. You pay the provider directly, at its own price. Scenri sells no credits and adds no markup.
 - **Local first, and it means it.** No account, no telemetry, nothing uploaded to us. Scenri runs on this computer, and answers other devices on your own network only when they bring its six-digit code (Settings, Local access). It makes exactly two requests on its own behalf: a version-number check against npm every six hours so updates can announce themselves (and, when one is found, the download of that release from npm, staged locally until you choose to restart), and the download of the library imagery archive from GitHub, once for each library version a release pins. Nothing about you or your work is sent in either, and both turn off: in Settings or `SCENRI_NO_UPDATE_CHECK=1` for the first, `SCENRI_NO_CONTENT_FETCH=1` for the second ([how updates work](https://github.com/tonygorb/scenri/blob/main/docs/updates.md), [what goes where](https://github.com/tonygorb/scenri/blob/main/PRIVACY.md)).
 
-## Engines
-
-| Engine | What it costs you | Needs | Carries a Product or Presenter |
-|---|---|---|---|
-| **Codex CLI** | your ChatGPT plan's Codex usage | a paid ChatGPT plan; the app installs Codex and signs you in | yes, up to 5 references |
-| OpenRouter | about $0.04 an image | API key | yes, up to 4 references |
-| Replicate | about $0.003 an image | API token | no |
-| fal | about $0.006 an image (fal bills per megapixel) | API key | no |
-
-Codex CLI is the default because it needs no key and because it carries the most reference images: a shot that has to keep both a product and a person accurate needs the room.
-
-It is not free. Paid ChatGPT plans include Codex usage, and each image spends some of it: OpenAI says image generation uses it three to five times faster than a plain turn. OpenAI meters that, not Scenri, so spend caps do not apply to this engine.
-
-**Without a paid ChatGPT plan**, use your own provider key. OpenRouter is the one to pick if your shots name a Product or a Presenter. Replicate and fal take no reference images, so Scenri refuses those shots on them rather than generating something that only looks right. Edits on Replicate and fal cost more than a new image.
-
-Keys are stored in your local library folder, sent only to that provider, and never returned by the API. Set a monthly spend cap per engine in Settings, Providers.
-
-Your Codex session is yours: Scenri runs the official `codex` commands on your machine and never reads, copies or stores the credential. That is also why Scenri never pools user plans: a plan is licensed to the person who pays for it, not to a service reselling it to other people. Any hosted version of Scenri, if one ever exists, would run API-priced engines only.
+Providers, costs, and what each one can carry are in [Connect image generation](https://scenri.co/docs/connect/).
 
 ## Configuration
 

package/dist/index.js

@@ -50,6 +50,8 @@ Usage
 Configuration is via environment variables: SCENRI_PORT, SCENRI_HOST,
 SCENRI_HOME, SCENRI_NO_OPEN, SCENRI_NO_UPDATE_CHECK, SCENRI_NO_CONTENT_FETCH,
 SCENRI_CONTENT_URL, SCENRI_CONTENT_PIN, SCENRI_NO_DESKTOP.
+
+Docs: https://scenri.co/docs
 `;
 }
 

package/dist/serve.js

@@ -4761,10 +4761,10 @@ var SCENE_INSTRUCTION_MAX = COMPOSED_TEXT_MAX;
 function sceneRecordFrom(input, base) {
   const has = (k) => input[k] !== void 0;
   const prompt = has("prompt") ? phrase(input.prompt, 2e3) : base?.prompt ?? "";
-  if (!prompt) return { ok: false, error: "a scene needs a prompt describing the place" };
-  if (/\{[^}]*\}/.test(prompt)) return { ok: false, error: "a scene prompt cannot contain a {placeholder}" };
+  if (!prompt) return { ok: false, error: "a place needs a prompt describing it" };
+  if (/\{[^}]*\}/.test(prompt)) return { ok: false, error: "a place prompt cannot contain a {placeholder}" };
   const name = has("name") ? str3(input.name, 60) : base?.name ?? "";
-  if (!name) return { ok: false, error: "a scene needs a name" };
+  if (!name) return { ok: false, error: "a place needs a name" };
   const subjectRaw = has("subject") ? str3(input.subject, 20).toLowerCase() : base?.subject ?? "either";
   if (!SUBJECTS2.has(subjectRaw)) {
     return { ok: false, error: "subject must be product, person or either" };
@@ -4834,14 +4834,14 @@ function sceneRecordFrom(input, base) {
 function presenterRecordFrom(input, base) {
   const has = (k) => input[k] !== void 0;
   const name = has("name") ? str3(input.name, 60) : base?.name ?? "";
-  if (!name) return { ok: false, error: "a presenter needs a name" };
+  if (!name) return { ok: false, error: "a person needs a name" };
   const angles = has("shotAngles") ? strList(input.shotAngles, 8, 32) : [];
   const knownAngle = (file) => base?.shots?.find((s) => s.file === file)?.angle;
   const shots = has("shotHashes") ? strList(input.shotHashes, 8, 64).map((h) => assetRef(h)).filter((f) => !!f).map((file, i) => {
     const angle = angles[i] ?? knownAngle(file);
     return angle ? { file, angle, locked: true } : { file, locked: true };
   }) : base?.shots ?? [];
-  if (!shots.length) return { ok: false, error: "a presenter needs at least one photo" };
+  if (!shots.length) return { ok: false, error: "a person needs at least one photo" };
   const sources = has("sourceHashes") ? strList(input.sourceHashes, 8, 64).map((h) => assetRef(h)).filter((f) => !!f).map((file) => ({ file })) : base?.sourceRefs;
   const presenter = {
     id: base?.id ?? mintId(PRESENTER_ID_PREFIX),
@@ -4927,8 +4927,8 @@ function duplicatePresenter(core, brandId, presenterId, name) {
   if (!brand) return { ok: false, error: "brand not found", status: 404 };
   const id = headOf(brand.json, presenterId);
   const source = brandCharacters(brand.json).find((c) => c?.id === id);
-  if (!source) return { ok: false, error: "presenter not found", status: 404 };
-  if (!isCustomPresenter(source)) return { ok: false, error: "this presenter is not editable", status: 400 };
+  if (!source) return { ok: false, error: "person not found", status: 404 };
+  if (!isCustomPresenter(source)) return { ok: false, error: "this person is not editable", status: 400 };
   const built = duplicatePresenterRecord(source, name);
   if (!built.ok) return { ok: false, error: built.error, status: 400 };
   commit(core, brand.id, (json) => {
@@ -4955,7 +4955,7 @@ function lintSceneProse(brandJson, scene) {
   for (const p of brandJson?.products ?? []) consider(p?.name);
   for (const c of brandCharacters(brandJson)) consider(c?.name);
   return named.size ? [
-    `This scene names ${[...named].join(", ")}. A scene is a place, so whatever you stage in it later has to argue with that.`
+    `This place names ${[...named].join(", ")}. A place is a setting, so whatever you stage in it later has to argue with that.`
   ] : [];
 }
 function commit(core, brandId, mutate2, dropDraftId) {
@@ -5872,7 +5872,7 @@ function compileBrief(input, ctx) {
       case "character": {
         const c = characters.find((x) => x.id === tok.id);
         if (!c) {
-          warnings.push("A presenter in this brief is no longer in your roster.");
+          warnings.push("A person in this brief is no longer in your roster.");
           break;
         }
         hasPerson = true;
@@ -5990,11 +5990,13 @@ function compileBrief(input, ctx) {
       case "template": {
         const t = ctx.templateById?.(tok.id);
         if (!t) {
-          warnings.push("A template in this brief is no longer installed.");
+          warnings.push("A place in this brief is no longer installed.");
           break;
         }
         if (inlineTemplates.length) {
-          warnings.push(`${t.name} was ignored: a brief runs one template, and ${inlineTemplates[0].name} came first.`);
+          warnings.push(
+            `${t.name} was ignored: a shot is made in one place, and ${inlineTemplates[0].name} came first.`
+          );
           break;
         }
         inlineTemplates.push(t);
@@ -9891,7 +9893,7 @@ function startAssetBuild(deps, input) {
   const brand = core.store.getBrand(input.brandId);
   if (!brand) throw Object.assign(new Error("brand not found"), { statusCode: 404 });
   const prior = input.sceneId ? brandSceneById(brand.json, input.sceneId) : void 0;
-  if (input.sceneId && !prior) throw Object.assign(new Error("scene not found"), { statusCode: 404 });
+  if (input.sceneId && !prior) throw Object.assign(new Error("place not found"), { statusCode: 404 });
   const supplied = input.imageHashes.length ? input.imageHashes : (prior?.refs ?? []).map((r) => String(r?.file ?? "").replace(/^asset:/, ""));
   const hashes = [...new Set(supplied)].filter((h) => /^[a-f0-9]{32}$/.test(h) && core.images.has(h)).slice(0, 8);
   if (!hashes.length && !input.instruction?.trim()) {
@@ -9901,7 +9903,7 @@ function startAssetBuild(deps, input) {
     id: `ab-${randomUUID().slice(0, 8)}`,
     brandId: brand.id,
     kind: input.kind,
-    name: str3(input.name, 60) || "New scene",
+    name: str3(input.name, 60) || "New place",
     stage: "queued",
     step: 0,
     steps: 1,
@@ -10206,7 +10208,7 @@ async function runSceneBuild(deps, job, hashes, instruction, signal) {
   if (signal.aborted) throw new Error("cancelled");
   const built = sceneRecordFrom(
     {
-      name: job.name || draft?.name || "New scene",
+      name: job.name || draft?.name || "New place",
       promptName: draft?.promptName,
       lighting: draft?.lighting,
       description: draft?.description ?? instruction,
@@ -10240,7 +10242,7 @@ async function runSceneBuild(deps, job, hashes, instruction, signal) {
       patch(job, { step: 1, previewHash });
     } catch (err) {
       if (signal.aborted) throw err;
-      patch(job, { warnings: [...job.warnings, "The preview could not be drawn. The scene is still usable."] });
+      patch(job, { warnings: [...job.warnings, "The preview could not be drawn. The place is still usable."] });
     }
   }
   if (signal.aborted) throw new Error("cancelled");
@@ -10250,7 +10252,7 @@ async function runSceneBuild(deps, job, hashes, instruction, signal) {
   commit(core, job.brandId, (json) => {
     const rows = brandScenes(json);
     const at = rows.findIndex((s) => s?.id === scene.id);
-    if (at < 0 && job.sceneId) throw new Error("This scene was deleted while it was being read again.");
+    if (at < 0 && job.sceneId) throw new Error("This place was deleted while it was being read again.");
     json.scenes = at >= 0 ? rows.map((s, i) => i === at ? scene : s) : [...rows, scene];
   });
   patch(job, {
@@ -12856,9 +12858,9 @@ function registerSceneRoutes(app, deps) {
     const id = /^[a-z0-9-]+$/.exec(String(p.id))?.[0];
     const view = isSceneView(p.view) ? p.view : null;
     const slot = view ? slotOfView(view) : null;
-    if (!id || !scenes.some((s) => s.id === id)) return reply.status(404).send({ error: "scene not found" });
+    if (!id || !scenes.some((s) => s.id === id)) return reply.status(404).send({ error: "place not found" });
     if (!slot || !existsSync(refPath(id, slot)))
-      return reply.status(404).send({ error: "this scene has no such view" });
+      return reply.status(404).send({ error: "this place has no such view" });
     const hash = core.images.save(
       await sharp22(readFileSync(refPath(id, slot))).png().toBuffer()
     );
@@ -13335,8 +13337,8 @@ function openPresenterEdit(core, brandId, presenterId) {
   if (!brand) throw fail("brand not found", 404);
   const rows = brandCharacters(brand.json);
   const asked = rows.find((c) => c?.id === presenterId);
-  if (!asked) throw fail("presenter not found", 404);
-  if (!isCustomPresenter(asked)) throw fail("this presenter is not editable", 400);
+  if (!asked) throw fail("person not found", 404);
+  if (!isCustomPresenter(asked)) throw fail("this person is not editable", 400);
   const headId = headOf(brand.json, presenterId);
   const head = rows.find((c) => c?.id === headId);
   return listPresenterDrafts(core, brandId).find((d) => d.presenterId === headId) ?? seedDraftFromPresenter(core, brandId, head);
@@ -13436,7 +13438,7 @@ async function filePhotos(deps, id, signal) {
         {
           kind: "presenter",
           imagePaths: rec.sources.map((h) => core.images.pathFor(h)),
-          name: rec.name || "New presenter",
+          name: rec.name || "New person",
           instruction: rec.direction || void 0,
           vocabulary: deps.vocabulary,
           classifyPhotos: true
@@ -13554,7 +13556,7 @@ async function drawView(deps, id, view, before, adjustment, decide, signal) {
           {
             kind: "presenter",
             imagePaths: [core.images.pathFor(face)],
-            name: rec.name || "New presenter",
+            name: rec.name || "New person",
             instruction: rec.direction || void 0,
             vocabulary: deps.vocabulary
           },
@@ -13957,8 +13959,8 @@ async function saveEdit(deps, rec, hooks) {
   const brand = core.store.getBrand(rec.brandId);
   if (!brand) throw fail("brand not found", 404);
   const base = brandCharacters(brand.json).find((c) => c?.id === rec.presenterId);
-  if (!base) throw fail("this presenter no longer exists", 404);
-  const moved = () => fail("this presenter changed elsewhere; reload to continue", 409);
+  if (!base) throw fail("this person no longer exists", 404);
+  const moved = () => fail("this person changed elsewhere; reload to continue", 409);
   const baseId = rec.baseId ?? "";
   if (!baseId || headOf(brand.json, baseId) !== baseId) throw moved();
   if (!rec.name.trim()) throw fail("give them a name", 400);
@@ -14364,7 +14366,7 @@ function createSceneExamples(deps) {
     );
     const who = (json?.characters ?? []).find((c) => c?.id === presenterId);
     const refs = (who?.shots ?? []).map((s) => hashOf2(s.file)).filter((h) => !!h && deps.core.images.has(h)).slice(0, 3);
-    if (!refs.length) throw new Error("Scenri's library of demo presenters has not downloaded yet.");
+    if (!refs.length) throw new Error("Scenri's library of demo people has not downloaded yet.");
     return {
       refs,
       name: String(who?.promptName ?? who?.name ?? "the person"),
@@ -14584,12 +14586,12 @@ function createSceneExamples(deps) {
     placeChanged,
     start(brandId, sceneId, roles, named = false) {
       const scene = sceneOf(brandId, sceneId);
-      if (!scene) throw Object.assign(new Error("scene not found"), { statusCode: 404 });
+      if (!scene) throw Object.assign(new Error("place not found"), { statusCode: 404 });
       if (!scene.preview)
-        throw Object.assign(new Error("this scene has no picture to draw from yet"), { statusCode: 409 });
+        throw Object.assign(new Error("this place has no picture to draw from yet"), { statusCode: 409 });
       const job = begin(brandId, sceneId, [...new Set(roles)], scene, named);
       if (!job) {
-        const why = standInsOf(scene, deps.demoProducts, deps.presenters) ? "Scenri's library has not downloaded yet, so it cannot be shown in use for now." : "Nothing in Scenri's library fits this scene yet.";
+        const why = standInsOf(scene, deps.demoProducts, deps.presenters) ? "Scenri's library has not downloaded yet, so it cannot be shown in use for now." : "Nothing in Scenri's library fits this place yet.";
         throw Object.assign(new Error(why), { statusCode: 409 });
       }
       return job;
@@ -14696,13 +14698,13 @@ var fail2 = (message, statusCode = 400) => Object.assign(new Error(message), { s
 var oneLine2 = (v, max) => String(v ?? "").replace(/\s+/g, " ").trim().slice(0, max);
 function nameFromWords(words) {
   const cut = oneLine2(words, 200).split(/[.,;:!?\n]/)[0].split(" ").filter(Boolean).slice(0, 4).join(" ");
-  if (!cut) return "New scene";
+  if (!cut) return "New place";
   return (cut.charAt(0).toUpperCase() + cut.slice(1)).slice(0, 60);
 }
 function readingFrom(raw) {
   const r = raw ?? {};
   const built = sceneRecordFrom({
-    name: oneLine2(r.name, 60) || "New scene",
+    name: oneLine2(r.name, 60) || "New place",
     promptName: r.promptName,
     prompt: r.prompt,
     lighting: r.lighting,
@@ -14918,7 +14920,7 @@ function startSceneStudioJob(deps, input) {
     attachFrom: null,
     conversation,
     sceneId: oneLine2(input.sceneId, 80) || null,
-    label: oneLine2(input.label, 60) || reading?.name || nameFromWords(instruction) || "New scene"
+    label: oneLine2(input.label, 60) || reading?.name || nameFromWords(instruction) || "New place"
   };
   jobs.set(job.id, job);
   prune2(input.brandId);
@@ -15038,9 +15040,9 @@ async function run2(deps, job, input, signal) {
       if (job.attachTo) {
         const landed = landOn(deps, job.brandId, job.attachTo, hash, job.attachFrom, job.anchor, heroOf(job));
         if (landed === "gone")
-          patch2(job, { warnings: [...job.warnings, "The scene was gone before its picture landed."] });
+          patch2(job, { warnings: [...job.warnings, "The place was gone before its picture landed."] });
         if (landed === "moved")
-          patch2(job, { warnings: [...job.warnings, "The scene had a new picture by then, so it kept that one."] });
+          patch2(job, { warnings: [...job.warnings, "The place had a new picture by then, so it kept that one."] });
       }
     }
     patch2(job, { status: "done", phase: null, finishedAt: now() });
@@ -15244,8 +15246,8 @@ function registerAssetBuildRoutes(app, deps) {
     if (!brand) return;
     const id = String(req.params.presenterId);
     const base = brandCharacters(brand.json).find((c) => c.id === id);
-    if (!base) return reply.status(404).send({ error: "presenter not found" });
-    if (!isCustomPresenter(base)) return reply.status(400).send({ error: "this presenter is not editable" });
+    if (!base) return reply.status(404).send({ error: "person not found" });
+    if (!isCustomPresenter(base)) return reply.status(400).send({ error: "this person is not editable" });
     const built = presenterRecordFrom(await withDerivedCrops(core, storedOnly(core, req.body), base), base);
     if (!built.ok) return reply.status(400).send({ error: built.error });
     try {
@@ -15263,8 +15265,8 @@ function registerAssetBuildRoutes(app, deps) {
     const id = String(req.params.presenterId);
     const rows = brandCharacters(brand.json);
     const current = rows.find((c) => c.id === id);
-    if (!current) return reply.status(404).send({ error: "presenter not found" });
-    if (!isCustomPresenter(current)) return reply.status(400).send({ error: "this presenter is not editable" });
+    if (!current) return reply.status(404).send({ error: "person not found" });
+    if (!isCustomPresenter(current)) return reply.status(400).send({ error: "this person is not editable" });
     const older = current.revisionOf && !current.supersededBy ? rows.find((c) => c.id === current.revisionOf) : void 0;
     if (!older) return reply.status(400).send({ error: "nothing to revert" });
     try {
@@ -15297,8 +15299,8 @@ function registerAssetBuildRoutes(app, deps) {
     const id = String(req.params.presenterId);
     const rows = brandCharacters(brand.json);
     const base = rows.find((c) => c.id === id);
-    if (!base) return reply.status(404).send({ error: "presenter not found" });
-    if (!isCustomPresenter(base)) return reply.status(400).send({ error: "this presenter is not editable" });
+    if (!base) return reply.status(404).send({ error: "person not found" });
+    if (!isCustomPresenter(base)) return reply.status(400).send({ error: "this person is not editable" });
     const gone = rows.filter((c) => c.id === id || headOf(brand.json, c.id) === id);
     const goneIds = new Set(gone.map((c) => c.id));
     commit(core, brand.id, (json) => {
@@ -15340,7 +15342,7 @@ function registerAssetBuildRoutes(app, deps) {
     if (!brand) return;
     const id = String(req.params.sceneId);
     const base = brandScenes(brand.json).find((s) => s.id === id);
-    if (!base) return reply.status(404).send({ error: "scene not found" });
+    if (!base) return reply.status(404).send({ error: "place not found" });
     const body = sceneBody2(core, req.body);
     if ("error" in body) return reply.status(400).send({ error: body.error });
     const built = sceneRecordFrom(body, base);
@@ -15367,7 +15369,7 @@ function registerAssetBuildRoutes(app, deps) {
     if (!brand) return;
     const id = String(req.params.sceneId);
     const gone = brandScenes(brand.json).find((s) => s.id === id);
-    if (!gone) return reply.status(404).send({ error: "scene not found" });
+    if (!gone) return reply.status(404).send({ error: "place not found" });
     cancelSceneBuilds(brand.id, id);
     cancelSceneStudioFor(brand.id, id);
     let row;
@@ -15387,11 +15389,11 @@ function registerAssetBuildRoutes(app, deps) {
     if (!brand) return;
     const id = String(req.params.sceneId);
     const scene = brandScenes(brand.json).find((s) => s.id === id);
-    if (!scene) return reply.status(404).send({ error: "scene not found" });
+    if (!scene) return reply.status(404).send({ error: "place not found" });
     if (!(scene.refs ?? []).length)
-      return reply.status(400).send({ error: "this scene was written from words, so there is nothing to read again" });
+      return reply.status(400).send({ error: "this place was written from words, so there is nothing to read again" });
     if (sceneBuildRunning(brand.id, id))
-      return reply.status(409).send({ error: "this scene is already being read again" });
+      return reply.status(409).send({ error: "this place is already being read again" });
     const body = req.body ?? {};
     try {
       return startAssetBuild(await buildDeps(), {
@@ -15415,7 +15417,7 @@ function registerAssetBuildRoutes(app, deps) {
     if (!brand) return;
     const id = String(req.params.sceneId);
     const scene = brandScenes(brand.json).find((s) => s.id === id);
-    if (!scene) return reply.status(404).send({ error: "scene not found" });
+    if (!scene) return reply.status(404).send({ error: "place not found" });
     const engine = await buildEngine();
     if (!engine) return reply.status(400).send({ error: "no engine here can draw a preview" });
     const own = scene;
@@ -15732,7 +15734,7 @@ function registerSceneStudioRoutes(app, deps) {
     const job = jobOr404(req, reply, brand.id);
     if (!job) return;
     const sceneId = String((req.body ?? {}).sceneId ?? "");
-    if (!sceneId) return reply.status(400).send({ error: "which scene?" });
+    if (!sceneId) return reply.status(400).send({ error: "which place?" });
     const state = attachSceneStudioJob(await buildDeps(), job.id, sceneId);
     return { state, brand: core.store.getBrand(brand.id) };
   });
@@ -15746,7 +15748,7 @@ function registerSceneExampleRoutes(app, deps) {
     const brand = core.store.getBrand(String(req.params.id));
     const scene = brand ? brandScenes(brand.json).find((s) => s.id === String(req.params.sceneId)) : void 0;
     if (!brand || !scene) {
-      reply.status(404).send({ error: "scene not found" });
+      reply.status(404).send({ error: "place not found" });
       return null;
     }
     return { brandId: brand.id, scene };
@@ -16301,6 +16303,7 @@ function readme(json, missing) {
     "brand.json holds the whole kit; assets/ holds every image it references,",
     "and the file fields inside brand.json are paths relative to brand.json.",
     "Format: https://scenri.co/schema/brand-0.1.schema.json",
+    "Scenri shows characters[] as People and scenes[] as Places.",
     "",
     "Products imported from a store catalog are not included: this bundle is the",
     "brand document as stored, and catalog products are resolved at generation",
@@ -16383,6 +16386,41 @@ function registerImageRoutes(app, deps) {
 var HEADLINES_KEPT = 5;
 var FIRST_PUBLIC = "0.2.0";
 var RELEASES = [
+  {
+    version: "0.22.0",
+    date: "2026-10-07",
+    title: "Presenters are now People, and Scenes are now Places",
+    announce: true,
+    sections: [
+      {
+        heading: "People",
+        body: "Presenters are called People now. Everyone you made is where you left them, with the same face, and a link to an old Presenters page still opens.",
+        image: {
+          file: "0.22.0-people-places.webp",
+          alt: "Two chips side by side, People and Places, each with its picture and a caret to open it."
+        }
+      },
+      {
+        heading: "Places",
+        body: "Scenes are called Places now, with the same pictures and light. A place's empty picture is called Empty, and old links to Scenes still open."
+      },
+      {
+        heading: "Help",
+        body: "The Help menu now opens Scenri's website and the guides on it."
+      }
+    ]
+  },
+  {
+    version: "0.21.2",
+    date: "2026-10-05",
+    title: "Halvard 12 has a full-size product photo",
+    sections: [
+      {
+        heading: "Examples",
+        body: "The whisky bottle now has a photo as large as the other products, so its label stays readable, and a shot made from it is told every word on that label."
+      }
+    ]
+  },
   {
     version: "0.21.1",
     date: "2026-10-04",
@@ -16693,11 +16731,7 @@ var RELEASES = [
     sections: [
       {
         heading: "Local access",
-        body: "Open Scenri on a phone, tablet or another computer on the same Wi-Fi: scan the QR code in Settings > Local access. If your computer's firewall stops it, Local access says so and offers Allow Scenri.",
-        image: {
-          file: "0.16.0-local-access.webp",
-          alt: "The Local access card: a QR code to scan, the address and six-digit code to type, and an iPhone just connected."
-        }
+        body: "Open Scenri on a phone, tablet or another computer on the same Wi-Fi: scan the QR code in Settings > Local access. If your computer's firewall stops it, Local access says so and offers Allow Scenri."
       },
       {
         heading: "Security",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scenri",
-  "version": "0.21.1",
+  "version": "0.22.0",
   "author": "Tony Gorb <hello@scenri.co>",
   "license": "AGPL-3.0-only",
   "type": "module",
@@ -66,7 +66,7 @@
     "url": "git+https://github.com/tonygorb/scenri.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://github.com/tonygorb/scenri#readme",
+  "homepage": "https://scenri.co",
   "bugs": {
     "url": "https://github.com/tonygorb/scenri/issues"
   },