@gentbajko/slopify 3.0.5 → 3.0.6

package/dist/slices/studio/settings.js

@@ -2,7 +2,7 @@ import { randomBytes, timingSafeEqual } from "node:crypto";
 import { z } from "zod";
 import { readSetting, writeSetting } from "../settings/repo.js";
 import { studioPlaylistMax } from "./model.js";
-// Two rows of the key/value `settings` table. The playlist travels with a backup; the
+// Rows of the key/value `settings` table. The playlists travel with a backup; the
 // pairing stays on this machine (`slices/storage/portable.ts`): its token is what lets the
 // browser extension read a project's upload pack.
 export const studioPlaylistKey = "studio.playlist";
@@ -12,23 +12,37 @@ const pairingSchema = z.object({
     origin: z.string().nullable(),
     pairedAt: z.string().nullable(),
 });
-// A channel's own playlist is a row of its own, `studio.playlist.<channelId>`; a channel
-// without one uses the default above.
+// A channel's own playlists are a row of their own, `studio.playlist.<channelId>`; a channel
+// without one uses the default list above. Each playlist is ticked by default or not; a
+// project's Prepare upload can change which it goes into. A row saved before lists existed
+// holds one name, read as one playlist ticked by default.
 export const studioChannelPlaylistPrefix = `${studioPlaylistKey}.`;
 function playlistKey(channelId) {
     return channelId === undefined ? studioPlaylistKey : `${studioChannelPlaylistPrefix}${channelId}`;
 }
-// The playlist an upload pack names: the channel's own, else the default. Without a channel,
-// the default alone.
-export function readStudioPlaylist(db, channelId) {
+// Up to 20 playlists a list: Studio's own dialog shows every playlist of the channel, and a
+// video in more than a handful of them is rare.
+export const studioPlaylistsMax = 20;
+export const studioPlaylistSchema = z.object({
+    name: z.string().trim().min(1).max(studioPlaylistMax),
+    byDefault: z.boolean(),
+});
+// What a row holds: the list, or the one name a row held before lists.
+export const storedPlaylistsSchema = z.union([
+    z.string().max(studioPlaylistMax),
+    z.array(studioPlaylistSchema).max(studioPlaylistsMax),
+]);
+// The playlists a channel's upload packs offer: the channel's own list, else the default.
+// Without a channel, the default alone.
+export function readStudioPlaylists(db, channelId) {
     if (channelId !== undefined) {
-        const own = storedPlaylist(db, playlistKey(channelId));
+        const own = storedPlaylists(db, playlistKey(channelId));
         if (own !== null)
             return own;
     }
-    return storedPlaylist(db, studioPlaylistKey);
+    return storedPlaylists(db, studioPlaylistKey) ?? [];
 }
-// Every channel's own playlist, by channel id.
+// Every channel's own list, by channel id.
 export function readChannelPlaylists(db) {
     const prefix = studioChannelPlaylistPrefix;
     const rows = db
@@ -36,41 +50,92 @@ export function readChannelPlaylists(db) {
         .all(prefix.length, prefix);
     const out = {};
     for (const { key } of rows) {
-        const value = storedPlaylist(db, key);
+        const value = storedPlaylists(db, key);
         if (value !== null)
             out[key.slice(prefix.length)] = value;
     }
     return out;
 }
-function storedPlaylist(db, key) {
+function storedPlaylists(db, key) {
     const stored = readSetting(db, key);
     if (stored === undefined)
         return null;
     try {
-        const value = JSON.parse(stored);
-        return typeof value === "string" && value.trim() !== "" ? value : null;
+        const parsed = storedPlaylistsSchema.safeParse(JSON.parse(stored));
+        if (!parsed.success)
+            return null;
+        if (typeof parsed.data === "string")
+            return parsed.data.trim() === "" ? null : [{ name: parsed.data.trim(), byDefault: true }];
+        return parsed.data.length === 0 ? null : parsed.data;
     }
     catch {
         return null;
     }
 }
-export function studioPlaylistProblem(raw) {
-    return raw.trim().length > studioPlaylistMax
-        ? `The playlist name is longer than YouTube allows (${String(studioPlaylistMax)} characters). Shorten it in Settings → YouTube Studio.`
-        : undefined;
-}
-// Saves the default playlist, or a channel's own; empty clears it (the channel then uses the
-// default again).
-export function saveStudioPlaylist(db, raw, channelId) {
-    const value = raw.trim();
+// Why a list can't be saved, in words for Settings → YouTube Studio; undefined when it can.
+export function studioPlaylistsProblem(list) {
+    const long = list.find((one) => one.name.trim().length > studioPlaylistMax);
+    if (long !== undefined)
+        return `The playlist name "${long.name.slice(0, 40)}…" is longer than YouTube allows (${String(studioPlaylistMax)} characters). Shorten it in Settings → YouTube Studio.`;
+    const seen = new Set();
+    for (const one of list) {
+        const key = one.name.trim().toLowerCase();
+        if (seen.has(key))
+            return `"${one.name.trim()}" is listed twice. Remove one in Settings → YouTube Studio.`;
+        seen.add(key);
+    }
+    return undefined;
+}
+// Saves the default list, or a channel's own; an empty list clears it (the channel then uses
+// the default again). Blank names are dropped.
+export function saveStudioPlaylists(db, list, channelId) {
+    const value = list
+        .map((one) => ({ name: one.name.trim(), byDefault: one.byDefault }))
+        .filter((one) => one.name !== "");
     const key = playlistKey(channelId);
-    if (value === "") {
+    if (value.length === 0) {
         db.prepare("DELETE FROM settings WHERE key = ?").run(key);
-        return null;
+        return [];
     }
     writeSetting(db, key, JSON.stringify(value));
     return value;
 }
+// The playlists a project's uploads go into, when its Prepare upload changed them from the
+// channel's defaults: one row, project id to names.
+export const studioProjectPlaylistsKey = "studio.projectPlaylists";
+export const storedProjectPlaylistsSchema = z.record(z.string().max(64), z.array(z.string().max(studioPlaylistMax)).max(studioPlaylistsMax));
+function projectChoices(db) {
+    const stored = readSetting(db, studioProjectPlaylistsKey);
+    if (stored === undefined)
+        return {};
+    try {
+        const parsed = storedProjectPlaylistsSchema.safeParse(JSON.parse(stored));
+        return parsed.success ? parsed.data : {};
+    }
+    catch {
+        return {};
+    }
+}
+// The channel's playlists, each ticked as this project goes into it: the project's own choice
+// when it made one (a playlist the channel no longer lists is dropped), else the defaults.
+export function projectPlaylists(db, projectId, channelId) {
+    const list = readStudioPlaylists(db, channelId);
+    const own = projectChoices(db)[projectId];
+    return list.map((one) => ({
+        name: one.name,
+        chosen: own === undefined
+            ? one.byDefault
+            : own.some((name) => name.toLowerCase() === one.name.toLowerCase()),
+    }));
+}
+export function saveProjectPlaylists(db, projectId, names) {
+    const { [projectId]: _previous, ...others } = projectChoices(db);
+    const next = names === null ? others : { ...others, [projectId]: [...names] };
+    if (Object.keys(next).length === 0)
+        db.prepare("DELETE FROM settings WHERE key = ?").run(studioProjectPlaylistsKey);
+    else
+        writeSetting(db, studioProjectPlaylistsKey, JSON.stringify(next));
+}
 // The projects whose uploaded clips are real footage (filmed, not generated): ticked in the
 // project's Prepare upload, under AI use. One row holding their ids; YouTube's second AI use
 // case is footage of a real event or place altered by AI (`disclosure.ts`).

package/dist/slices/youtube/answer.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { descriptionMaxCharacters, hashtagsMax, minChapterSeconds, minChapters, tagMaxCharacters, tagsMaxCharacters, } from "./model.js";
+import { alternativeTitles, descriptionMaxCharacters, hashtagsMax, minChapterSeconds, minChapters, pinnedCommentMaxCharacters, tagMaxCharacters, tagsMaxCharacters, titleMaxCharacters, } from "./model.js";
 import { parseTimestamp, youtubeTimestamp } from "./timestamps.js";
 export function descriptionMessages(brief) {
     const end = youtubeTimestamp(brief.durationSeconds);
@@ -8,7 +8,7 @@ export function descriptionMessages(brief) {
             role: "system",
             content: [
                 "You write YouTube descriptions. Answer with one JSON object and nothing else, in this shape:",
-                '{"summary": "...", "chapters": [{"start": "0:00", "title": "..."}], "hashtags": ["#Example"], "tags": ["example tag"]}',
+                '{"summary": "...", "chapters": [{"start": "0:00", "title": "..."}], "hashtags": ["#Example"], "tags": ["example tag"], "pinnedComment": "...", "titles": ["...", "..."]}',
                 "",
                 "Rules YouTube enforces, which the answer must follow:",
                 '- The first chapter starts at exactly "0:00".',
@@ -20,6 +20,11 @@ export function descriptionMessages(brief) {
                 `- Tags are plain search terms without # or commas, each at most ${String(tagMaxCharacters)} characters, no tag repeated, and all tags together at most ${String(tagsMaxCharacters)} characters.`,
                 "- No < or > anywhere.",
                 "- The summary is plain text without chapters, hashtags or links.",
+                `- The pinned comment is plain text without links, at most ${String(pinnedCommentMaxCharacters)} characters.`,
+                `- Titles are exactly ${String(alternativeTitles)} other titles for this video, for YouTube's title A/B test beside the video's own title: each at most ${String(titleMaxCharacters)} characters, one line, different from the video title and from each other.`,
+                "",
+                "The pinned comment is what the channel pins under the video, unless the instructions below say otherwise: thank the viewer in one line, ask one question a viewer can answer from their own experience of the subject, point to the chapters in the description, and end by inviting a suggestion for the next video. Two to four short paragraphs, in the same voice as the summary.",
+                "The other titles try different angles on the same video (a question, a stake, a surprising fact) while staying true to it and in the video title's language and tone.",
             ].join("\n"),
         },
         {
@@ -42,16 +47,20 @@ const answerSchema = z.object({
     chapters: z.array(z.object({ start: z.union([z.string(), z.number()]), title: z.string() })),
     hashtags: z.array(z.string()),
     tags: z.array(z.string()),
+    pinnedComment: z.string(),
+    titles: z.array(z.string()),
 });
 const fix = "Try again, or choose another model in Edit project → Providers.";
 // Reads and checks the model's answer. The reason is the sentence the stage shows; the
 // provider wrapper's `check` asks the model again while attempts remain.
-export function checkDescriptionAnswer(text, durationSeconds) {
+export function checkDescriptionAnswer(text, durationSeconds, 
+// The video's own title, which the other titles must differ from.
+title = "") {
     const parsed = answerSchema.safeParse(jsonOf(text));
     if (!parsed.success)
         return {
             ok: false,
-            reason: `The AI model's YouTube description didn't come back in the expected format (a JSON object with a summary, chapters, hashtags and tags). ${fix}`,
+            reason: `The AI model's YouTube description didn't come back in the expected format (a JSON object with a summary, chapters, hashtags, tags, a pinned comment and titles). ${fix}`,
         };
     const summary = parsed.data.summary.trim();
     if (summary === "")
@@ -65,7 +74,25 @@ export function checkDescriptionAnswer(text, durationSeconds) {
     const tags = checkTags(parsed.data.tags);
     if (!tags.ok)
         return tags;
-    const value = { summary, chapters: chapters.value, hashtags: hashtags.value, tags: tags.value };
+    const pinnedComment = parsed.data.pinnedComment.trim();
+    if (pinnedComment === "")
+        return { ok: false, reason: `The AI model wrote no pinned comment. ${fix}` };
+    if (pinnedComment.length > pinnedCommentMaxCharacters)
+        return {
+            ok: false,
+            reason: `The AI model's pinned comment is ${String(pinnedComment.length)} characters, over the ${String(pinnedCommentMaxCharacters)} Slopify allows. ${fix}`,
+        };
+    const titles = checkTitles(parsed.data.titles, title);
+    if (!titles.ok)
+        return titles;
+    const value = {
+        titles: titles.value,
+        summary,
+        chapters: chapters.value,
+        hashtags: hashtags.value,
+        tags: tags.value,
+        pinnedComment,
+    };
     const description = assembleDescription(value);
     if (/[<>]/.test(description))
         return {
@@ -139,6 +166,28 @@ function checkChapters(raw, durationSeconds) {
     }
     return { ok: true, value: chapters };
 }
+function checkTitles(raw, title) {
+    const broke = (rule) => ({
+        ok: false,
+        reason: `The AI model's other titles broke YouTube's rules (${rule}). ${fix}`,
+    });
+    const titles = raw.map((one) => one.trim().replace(/\s+/g, " ")).filter((one) => one !== "");
+    if (titles.length !== alternativeTitles)
+        return broke(`there must be ${String(alternativeTitles)} other titles, and it wrote ${String(titles.length)}`);
+    const long = titles.find((one) => one.length > titleMaxCharacters);
+    if (long !== undefined)
+        return broke(`"${long.slice(0, 40)}…" is over ${String(titleMaxCharacters)} characters`);
+    const odd = titles.find((one) => /[<>]/.test(one));
+    if (odd !== undefined)
+        return broke(`"${odd}" contains < or >`);
+    const seen = new Set([title.trim().toLowerCase()]);
+    for (const one of titles) {
+        if (seen.has(one.toLowerCase()))
+            return broke(`"${one}" repeats a title`);
+        seen.add(one.toLowerCase());
+    }
+    return { ok: true, value: titles };
+}
 function checkHashtags(raw) {
     const broke = (rule) => ({
         ok: false,

package/dist/slices/youtube/edits-repo.js

@@ -63,7 +63,8 @@ export function readChannelLinksFor(db, channelId) {
         return channel.brand.links;
     return channel.id === defaultChannelId ? readChannelLinks(db) : [];
 }
-// The description and tags as the project page shows and copies them: the user's edits over
+// The description, tags, pinned comment and other titles as the project page shows and copies
+// them: the user's edits over
 // the generated text, the chapters fitted to YouTube's rules (`chapters.ts`; the last one's
 // length only checked when the video's length is given), placeholders filled from the
 // project's and its channel's links (one with no link stays as typed). For anything that hands
@@ -71,7 +72,10 @@ export function readChannelLinksFor(db, channelId) {
 // fitting changed.
 export function effectiveDescription(db, projectId, generated) {
     const edits = readDescriptionEdits(db, projectId);
-    const shown = shownFields(resolveFields(splitDescription(generated.description, generated.tags), edits.fields));
+    const shown = shownFields(resolveFields(splitDescription(generated.description, generated.tags, {
+        pinnedComment: generated.pinnedComment,
+        titles: generated.titles,
+    }), edits.fields));
     const fitted = fitChapters(shown.chapters, generated.durationSeconds);
     const notice = chapterNotice(fitted.adjustments);
     const links = mergeLinks(readChannelLinksFor(db, projectChannelId(db, projectId)), edits.links);
@@ -79,6 +83,8 @@ export function effectiveDescription(db, projectId, generated) {
         description: fillPlaceholders(composeDescription({ ...shown, chapters: fitted.text }), links)
             .text,
         tags: fillPlaceholders(shown.tags, links).text,
+        pinnedComment: fillPlaceholders(shown.pinnedComment, links).text,
+        titles: shown.titles,
         ...(notice === undefined ? {} : { chapterNotice: notice }),
     };
 }

package/dist/slices/youtube/edits.js

@@ -1,14 +1,22 @@
 // Hand edits to the YouTube description. The project page lets the user edit the summary,
-// the chapters, the hashtags and the tags in place; each edit is saved with the generated
+// the chapters, the hashtags, the tags and the pinned comment in place; each edit is saved with the generated
 // text it was made from (`base`), so when the description is written again the page can tell
 // a field the user changed from one they left alone. Browser-safe: the project page applies
 // these rules to what it shows, and the server only stores the edits.
 import { parseTimestamp } from "./timestamps.js";
-export const descriptionFields = ["summary", "chapters", "hashtags", "tags"];
-// Splits a written description back into its three parts. `assembleDescription` (answer.ts) lays it out as
+export const descriptionFields = [
+    "summary",
+    "chapters",
+    "hashtags",
+    "tags",
+    "pinnedComment",
+    "titles",
+];
+// Splits a written description back into its three parts, beside the tags, the pinned comment
+// and the other titles (each empty for a description written before it existed). `assembleDescription` (answer.ts) lays it out as
 // the summary, a blank line, one chapter per line, a blank line and the hashtags; reading it
 // from the end keeps a summary with blank lines of its own whole.
-export function splitDescription(description, tags) {
+export function splitDescription(description, tags, extras = {}) {
     const lines = description.replace(/\r\n?/gu, "\n").split("\n");
     while (lines.length > 0 && lines.at(-1)?.trim() === "")
         lines.pop();
@@ -29,6 +37,8 @@ export function splitDescription(description, tags) {
         chapters: chapters.join("\n"),
         hashtags,
         tags: tags.trim(),
+        pinnedComment: (extras.pinnedComment ?? "").trim(),
+        titles: (extras.titles ?? "").trim(),
     };
 }
 function isChapterLine(line) {
@@ -65,6 +75,8 @@ export function resolveFields(generated, edits) {
         chapters: one("chapters"),
         hashtags: one("hashtags"),
         tags: one("tags"),
+        pinnedComment: one("pinnedComment"),
+        titles: one("titles"),
     };
 }
 export function shownFields(resolved) {
@@ -73,6 +85,8 @@ export function shownFields(resolved) {
         chapters: resolved.chapters.text,
         hashtags: resolved.hashtags.text,
         tags: resolved.tags.text,
+        pinnedComment: resolved.pinnedComment.text,
+        titles: resolved.titles.text,
     };
 }
 // Saving an edit: text equal to the generated text is no edit at all, so the field follows the

package/dist/slices/youtube/model.js

@@ -1,5 +1,6 @@
 // The optional YouTube description step of the Video stage: a short summary, a chapter list
-// YouTube turns into chapters, hashtags, and a separate list for YouTube's Tags field.
+// YouTube turns into chapters, hashtags, a separate list for YouTube's Tags field, a comment
+// to pin under the video, and two more titles for YouTube's title A/B test.
 // Browser-safe: Play, Edit project and the project page read these names and limits too.
 // YouTube's own rules for chapters in a description: the first starts at 0:00, there are at
 // least three, and each lasts at least ten seconds.
@@ -12,6 +13,12 @@ export const tagMaxCharacters = 100;
 export const hashtagsMax = 15;
 // YouTube's limit on a description.
 export const descriptionMaxCharacters = 5000;
+// YouTube's title A/B test ("Test & compare") takes up to three titles: the video's own and
+// these alternatives. YouTube's limit on a title.
+export const alternativeTitles = 2;
+export const titleMaxCharacters = 100;
+// YouTube's limit on a comment is 10,000; a pinned comment people read in full is far shorter.
+export const pinnedCommentMaxCharacters = 1500;
 // What a project uses when no Description prompt from the library is picked. No keywords,
 // so it never asks Play for a field.
 export const defaultDescriptionPrompt = [

package/dist/tutorials/Publishing-to-YouTube.md

@@ -2,11 +2,11 @@
 
 Slopify never uploads or publishes for you: there is no YouTube sign-in and no upload API. Instead, **Prepare upload** lists everything YouTube Studio asks for, in the order it asks, with a Copy button for each value, for the long video and for every short. You upload in Studio in your own browser and press Publish yourself. The optional [Studio-Extension](Studio-Extension) can fill Studio's upload dialog from the same list.
 
-**Where to find it:** a finished project → **Prepare upload** (the next action, and in the **YouTube** section), Home → **Ready to upload** → **Prepare upload**, or the Calendar's **Needs you** → **Prepare upload**. Settings → **YouTube Studio** holds the playlist, and each channel's **Brand** tab holds the links it uses.
+**Where to find it:** a finished project → **Prepare upload** (the next action, and in the **YouTube** section), Home → **Ready to upload** → **Prepare upload**, or the Calendar's **Needs you** → **Prepare upload**. Settings → **YouTube Studio** holds the playlists, and each channel's **Brand** tab holds the links it uses.
 
 ## Before your first upload
 
-1. Open **Settings → YouTube Studio** and type your **Playlist** name exactly as it is called in Studio (up to 150 characters), then press **Save**. It is the default for every channel; pick a channel in the list above the field to give that channel its own playlist. Leave it empty for no playlist.
+1. Open **Settings → YouTube Studio**, press **Add playlist** and type each playlist exactly as it is called in Studio (up to 150 characters). Tick **On by default** for the ones every video goes into, then press **Save playlists**. The list is the default for every channel; pick a channel above it to give that channel its own list.
 2. Open **Channels** → your channel → **Brand** and, under **Channel links**, add any links your descriptions use, such as `Patreon` or `Discord`. See [Channels](Channels#channel-links).
 3. In **Settings → Voices**, turn on **Real person** for any voice cloned from, or made to sound like, a real person.
 4. In **Library → Prompts**, turn on **Draws photorealistic pictures** for any Image prompt whose style looks like real photos or film.
@@ -27,7 +27,7 @@ Steps 3 and 4 decide the AI use answer; see [AI use disclosure](#ai-use-disclosu
 | **Title** | The project's title (up to 100 characters), or the short's title. **Copy**. |
 | **Description** | The description with chapters and hashtags, links filled in. For a short: its description, the "Watch the full video:" line and its hashtags. **Copy**. |
 | **Thumbnail** | The thumbnail file, with **Open folder**. With three thumbnails: "The first under Thumbnail; all 3 in A/B Testing (beside the title)." Shorts have no thumbnail step, since Studio shows a frame of a short. |
-| **Playlist** | The project's channel's playlist from Settings → YouTube Studio (or the default one), or "None set". **Copy**. |
+| **Playlist** | The project's channel's playlists from Settings → YouTube Studio (or the default list), or "None set". With more than one, each has a tick: tick the ones this project goes into (saved for this project; the others keep the defaults). **Copy**. |
 | **Audience** | "No, it's not made for kids". |
 | **AI use (under Show more)** | **Yes** or **No**, with the reason. |
 | **Tags (under Show more)** | The tags, comma-separated. For a short, its hashtags without the `#`. **Copy**. |
@@ -119,7 +119,7 @@ Slopify does not check YouTube, so it can't know when you've published. After yo
 
 ## Tips
 
-- Set the playlist once in Settings (per channel if your channels upload to different playlists); every upload pack names it.
+- Set the playlists once in Settings (per channel if your channels upload to different playlists), and tick the few a single video joins in its Prepare upload.
 - Upload the long video first, then paste its link as the shorts' **Full video link** so each short's description points to it.
 - If the AI use answer surprises you, read its reason: it names the voice, footage or prompt that made it Yes.
 

package/dist/tutorials/Settings-Reference.md

@@ -15,7 +15,7 @@ Every section of Settings, what each control does and its default. Sections with
 | [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) | Playlist per channel, the Studio extension's download and pairing | [Studio-Extension](Studio-Extension) |
+| [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) |
@@ -140,12 +140,12 @@ Each channel now keeps its own links, on its **Brand** tab under **Channel links
 
 ## YouTube Studio
 
-"The playlist upload packs name, and the Studio extension's pairing."
+"The playlists upload packs offer, and the Studio extension's pairing."
 
 | Control | What it does | Default / limit |
 |---|---|---|
 | **Upload pack and extension** | Explains that Slopify never uploads or publishes: **Prepare upload** on a finished project lists everything Studio asks for, and the optional extension fills Studio's upload dialog from it. | |
-| **Playlist** | The YouTube playlist upload packs name, typed exactly as it is called in Studio. Pick **Every channel (default)** or one channel first: the default is used by every channel without its own. **Save** stores it. Empty means no playlist (or, for a channel, the default). | Empty; up to 150 characters |
+| **Playlists** | The YouTube playlists upload packs offer, each typed exactly as it is called in Studio. Pick **Every channel (default)** or one channel first: the default list is used by every channel without its own. **Add playlist** adds a row; **On by default** puts every project into it; **Remove** drops it; **Save playlists** stores the list. A project's **Prepare upload** changes which ones it goes into. | None; up to 20, each up to 150 characters |
 | **Extension pairing token** | A secret the Slopify Studio extension needs before it may read your upload packs. **Copy** it into the extension's options and press Pair there. | |
 | **New pairing token** | Makes a fresh token, unpairs the extension until you paste the new one, and clears the uploads waiting for Studio. | |
 | **Install the Studio extension** | **Chrome, Edge, Brave** or **Firefox**, then **Download for Chrome** or **Download for Firefox**, with the three install steps. | |

package/dist/tutorials/Studio-Extension.md

@@ -58,7 +58,7 @@ The section is headed **Upload pack and extension**.
 
 | Option | What it does | Default / range |
 |---|---|---|
-| **Playlist** | The YouTube playlist upload packs name, so the extension ticks it in Studio's dialog. Pick **Every channel (default)** or one channel in the channel list, type the playlist exactly as it is called in Studio, and press **Save**. The default is used by every channel without its own; a channel's own playlist wins for its videos. Leave it empty for no playlist. | Empty; up to 150 characters |
+| **Playlists** | The YouTube playlists upload packs offer, so the extension ticks them in Studio's dialog. Pick **Every channel (default)** or one channel, **Add playlist** for each, type it exactly as it is called in Studio, tick **On by default** for the ones every video joins, and press **Save playlists**. A channel's own list wins for its videos; Prepare upload changes the ticks for one project. | None; up to 20, each up to 150 characters |
 | **Extension pairing token** | The secret the extension needs before it may read your upload packs. **Copy** copies it; **New pairing token** makes a new one and unpairs the extension. | Made for you |
 | **Install the Studio extension** | The download and install steps (see [Get the extension](#get-the-extension)). | |
 
@@ -89,7 +89,7 @@ Each press of **Fill in YouTube Studio** adds the item to **Waiting for Studio**
 | **Title** | Types the title (up to 100 characters for the video, the short's own title for a short). |
 | **Description** | Types the description line by line, so line breaks are kept. |
 | **Thumbnail** | Sets the first thumbnail. With three thumbnails, it looks for Studio's **A/B Testing** button beside the title and puts all three in. If the button isn't there or its dialog can't be filled, it sets the first and asks you to add the others in A/B Testing by hand. Shorts get no thumbnail. |
-| **Playlists** | Opens the dropdown, ticks the playlist named in Settings → YouTube Studio, and closes it. |
+| **Playlists** | Opens the dropdown, ticks every playlist the project goes into (Settings → YouTube Studio, and the project's own ticks in Prepare upload), and closes it. |
 | **Audience** | Picks "No, it's not made for kids". |
 | **Show more** | Presses it once, to reach the advanced settings. |
 | **AI use** | Picks Yes or No, as Prepare upload worked it out. See [AI use disclosure](Publishing-to-YouTube#ai-use-disclosure). |

package/dist/tutorials/YouTube-Description.md

@@ -2,7 +2,7 @@
 
 Slopify can write your video's YouTube description for you: a short summary, chapters at the narration's real times, hashtags, and a separate list of search tags. Each part has a Copy button and can be edited in place, and your edits survive when the description is written again.
 
-**Where to find it:** Play → **Outputs** row → **YouTube description**. On a finished project: the **YouTube** section (Description and Tags), and Edit project → **Prompts**.
+**Where to find it:** Play → **Outputs** row → **YouTube description**. On a finished project: the **YouTube** section (Description, Tags, Pinned comment and Other titles), and Edit project → **Prompts**.
 
 ## What you get
 
@@ -12,8 +12,10 @@ Slopify can write your video's YouTube description for you: a short summary, cha
 | **Chapters** | Timestamped lines such as `0:00 Introduction`, at the narration's real times. YouTube turns them into chapters. |
 | **Hashtags** | The hashtags at the end of the description. YouTube shows the first three above the title. |
 | **Tags** | Search tags for YouTube Studio's **Tags** field, kept separate from the description. Viewers don't see them. |
+| **Pinned comment** | A comment to post under the video and pin: a thank-you, a question viewers can answer from their own experience, a pointer to the chapters and an ask for the next topic. Your Description prompt can say how you want it. |
+| **Other titles** | Two more titles for YouTube's **A/B Testing** (Test & compare), beside the project's own title: each a different angle on the same video, one per line. |
 
-Slopify lays out the description itself (summary, blank line, one chapter per line, blank line, hashtags), so the layout YouTube needs never depends on the model's spacing. The files are saved in the project as `description.txt` and `tags.txt`.
+Slopify lays out the description itself (summary, blank line, one chapter per line, blank line, hashtags), so the layout YouTube needs never depends on the model's spacing. The files are saved in the project as `description.txt`, `tags.txt`, `pinned-comment.txt` and `titles.txt`.
 
 ## Turn it on
 
@@ -42,20 +44,22 @@ To change the tone or add your own links, write a prompt of the kind **YouTube D
 
 ## Read and copy it
 
-When the step has run, the project page's **YouTube** section shows two parts. A finished project with a written description opens on this section, so copying it is one press:
+When the step has run, the project page's **YouTube** section shows four parts. A finished project with a written description opens on this section, so copying it is one press:
 
 - **Description**, with the Summary, Chapters and Hashtags, a character count such as `1,240 / 5000 characters`, and **Copy**.
 - **Tags**, shown as chips, with a count against YouTube's 500-character limit and **Copy**.
+- **Pinned comment**, below the tags, with **Copy**. YouTube pins comments only on a published video: once it is live, post the comment from your channel and choose **Pin** in its menu.
+- **Other titles**, below the pinned comment, with **Copy**. In Studio, press **A/B Testing** beside the title and add them next to the video's own title. Prepare upload lists them in its Title step with **Copy others**.
 
 **Copy** on Description copies the whole description, placeholders filled in. **Copy** on Tags copies them comma-separated, ready to paste. A count over YouTube's limit turns red and says "over YouTube's limit".
 
-You can also run **Copy description** (`Shift+D`) and **Copy tags** from the command palette (`Ctrl+K`) while the project is open. The **YouTube description (.txt)** and **YouTube tags (.txt)** downloads are the text exactly as the page shows it: your edits, the fitted chapters and the filled links. See [Keyboard-Shortcuts-and-Command-Palette](Keyboard-Shortcuts-and-Command-Palette).
+You can also run **Copy description** (`Shift+D`), **Copy tags** and **Copy pinned comment** from the command palette (`Ctrl+K`) while the project is open. The **YouTube description (.txt)** and **YouTube tags (.txt)** downloads are the text exactly as the page shows it: your edits, the fitted chapters and the filled links. See [Keyboard-Shortcuts-and-Command-Palette](Keyboard-Shortcuts-and-Command-Palette).
 
 While the stage is running the parts say "Written after the subtitle timing."; before it starts they say "Not written yet. It is made with the video."
 
 ## Edit a part
 
-1. In the project's YouTube section, press **Edit** beside Summary, Chapters, Hashtags or Tags.
+1. In the project's YouTube section, press **Edit** beside Summary, Chapters, Hashtags, Tags, Pinned comment or Other titles.
 2. Change the text and save.
 
 Your text is now marked **Your edit**. It is kept as yours:
@@ -103,6 +107,10 @@ Because placeholders are filled when shown or copied, changing a channel's link
 
 ## Write it again, or turn it on later
 
+To write a description again, press **Write again** beside **Description** in the project's YouTube section, then confirm. Only this step runs. A description written before pinned comments and other titles existed shows neither until it is written again this way.
+
+To turn it on, or to change its prompt first:
+
 1. Open the project and press **Edit project**.
 2. Open **Prompts**. Tick **YouTube description** if it was off, and pick a **Description prompt**.
 3. To replace a description that is already written, press **Write the description again after review**. **Keep the current description** cancels it.