The v0.35.0 APK built successfully three times and was never attached. The
build was fine every time; the upload step failed with "Resource not accessible
by integration" on update-a-release.
`softprops/action-gh-release@v3` was resolving the target release from
GITHUB_REF rather than from the `tag_name` it was handed. On the tag push it
looked for a release tagged `refs/tags/v0.35.0`; on the workflow_dispatch re-run
it looked for one tagged `refs/heads/main`. Neither exists, so it fell through
to CREATING a release against a branch ref, which the token is quite right to
refuse. The permissions were never the problem — the job log shows
`Contents: write` on every run.
Replaced with `gh release upload`, which is pre-installed on every runner and
takes the tag as a positional argument, so it cannot make that substitution.
`--clobber` makes a re-run idempotent.
Also uploads the APK as a workflow artifact first, so a failed release upload
never costs another 20-minute NDK build to recover from — which is what it cost
to diagnose this.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Every major the project had been sitting on, brought current. No user-facing
feature changes; the app should behave identically.
React 18 → 19 (+ types, @vitejs/plugin-react 6)
Tailwind 3 → 4
ESLint 9 → 10 (+ eslint-plugin-react-hooks 5 → 7)
Zustand 4 → 5
i18next 23 → 26, react-i18next 15 → 17
@testing-library/*, typescript-eslint 8.67, Vite/Vitest/tsx/knip patches
**React 19** needed exactly one source change: `useRef<T>(null)` is now typed
`RefObject<T | null>` rather than `RefObject<T>`. The old type quietly claimed a
ref was non-null before its element mounted; ScrollToTopButton now matches,
which makes its existing null check honest rather than defensive.
**Tailwind 4** moves configuration from `tailwind.config.ts` (deleted) into
CSS. The tokens live in an `@theme` block that maps Tailwind's names onto the
existing `:root` / `.light` variables, so the runtime theme toggle still owns
the values and keeps working untouched. `darkMode: "class"` becomes
`@custom-variant dark` — the app toggles a class on <html> rather than
following the OS, so the default prefers-color-scheme variant would be wrong.
Verified in the browser in both themes; a CSS migration fails visually, not at
build time.
**The lint upgrade earned its keep.** `react-hooks/set-state-in-effect` (new in
v7, React Compiler-aware) flagged seven sites. Four were real extra render
passes:
- use-online-status rewritten to `useSyncExternalStore`. It had been
re-reading `navigator.onLine` inside an effect to close the gap between
first render and the listeners attaching — subscribing properly removes the
gap instead of patching it.
- ShortcutHelpModal derives its filter from `open` instead of resetting state
in an effect, so a modal that is closed most of the time stops scheduling
work on unrelated parent updates.
- DraftIndicator and use-languages-ready now guard their setters.
Three remain as warnings, deliberately. They genuinely sync state FROM an
external source (i18next bundle readiness, a text mirror of a numeric store
field, a useMemo the compiler cannot preserve) and need a restructure rather
than a guard. Recorded in eslint.config.js with the reason — downgraded, not
silenced, and not a reason to hold back ESLint 10.
**lucide-react deliberately stays at 0.577.0.** 1.x removes every brand icon;
upstream dropped them for trademark reasons. Taking it would mean either a
generic globe beside a Facebook link or re-adding the marks ourselves and
inheriting the exposure lucide just shed. 0.577 already delivered the win —
main bundle 175 kB → 137 kB.
knip now ignores `tailwindcss`: after the migration its only reference is
`@import "tailwindcss"` in CSS, which knip does not follow.
Full gate green — typecheck, typecheck:all, lint, format:check,
validate:locales, knip, check:version, 692 tests, build — plus a browser check
of both themes with the editor and batch pages functional.
0.36.0 is reserved for the two new locales.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
**docs/I18N.md was wrong in a way that would waste a contributor's afternoon.**
It said adding a locale to `SUPPORTED_LANGUAGES` was "the only registration
step". It is one of four, and the missing ones fail differently: the
`SupportedLanguage` union is a compile error, `MULTILINGUAL_TAGS` is a compile
error, but `detectBrowserLanguage`'s own hardcoded copy of the list fails
*silently* — the language works and simply never auto-selects for a visitor
whose browser is set to it. Also noted: `SUPPORTED_LANGUAGES` is not type-bound
to the union and every consumer casts, so a mismatch compiles cleanly.
Also documents the `--copy-english` / `--force` flags on the locale generator,
which only started existing in v0.35.0 despite having been advertised in
package.json since v0.1.
Elsewhere:
- **DEVELOPMENT.md** — the five new npm scripts, including why `format:check`
excludes markdown and locale JSON, and why `typecheck:all` exists.
- **TECH-SPEC.md** — the real CI job, a new Field Limits section, and how
over-limit enforcement derives from the engine's long-ignored `warnings`.
- **ARCHITECTURE.md** — the settings→engine mapping and its two guards, the
two-source validation state, and an honest note that the first Strict Mode
implementation typechecked, passed tests, and did nothing.
- **FEATURES.md** — the settings table still listed `Default Genre` and
`Auto-save Draft`, removed in v0.22.0 and v0.3. Replaced, plus a guardrails
section.
- **README.md** — guardrails in the feature list, and a link to the wiki.
The wiki itself (12 pages: quick start, glossary, field reference, guardrails,
batch/social, import-export, languages, privacy, troubleshooting, FAQ, release
process) is published separately — it lives in its own repository.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The new grouped Dependabot config opened six PRs within minutes of landing.
Merging them one at a time would mean six lockfile rebases and six CI runs for
what is a single dependency resolution, so this applies all of them together:
i18next-resources-to-backend 1.2.1 → 1.2.3
@tauri-apps/{api,plugin-dialog,plugin-fs,plugin-opener} → latest 2.x
lucide-react 0.400.0 → 0.577.0
eslint + @eslint/js 9.39.4 → 9.39.5, typescript-eslint 8.58 → 8.67
knip 6.14.1 → 6.32.2, prettier 3.8.1 → 3.9.6,
prettier-plugin-tailwindcss 0.6.14 → 0.8.1
vite 8.0.16 → 8.2.1, vitest 4.1.8 → 4.1.10, tsx 4.22 → 4.23,
postcss 8.5.15 → 8.5.26, autoprefixer 10.4.27 → 10.5.4
All within-major; the majors (React 19, Tailwind 4, ESLint 10, i18next 26,
Zustand 5) are held back by the Dependabot ignore rule and belong to their own
planned release.
The `lint-and-format` group's own PR was RED, and correctly so: prettier 3.9
formats six files differently, and Dependabot cannot run `npm run format` for
itself. Reformatted here — which is the format gate doing exactly its job on
its first real outing.
lucide-react's jump also drops the main bundle 175 kB → 137 kB (gzip 48 → 37).
Verified: typecheck, typecheck:all, lint, format:check, validate:locales, knip,
check:version, 692 tests and build all pass, and the app renders with icons
intact in the browser.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Splits SettingsPage (544 → 347 lines), extracting the import/export IO and the
42-input Genre Playlists section — the two pieces with no reason to sit inside
a page component.
Bumps all six version manifests and adds the CHANGELOG entry. `npm run
check:version`, added earlier in this cycle, confirms they agree.
Deliberately NOT split: `description-builder.ts` (974) and `editor-store.ts`
(998). Both are large, but this release changes almost nothing in either, and
carving up a 20-section render pipeline or a migration ladder is a test-heavy
refactor with real regression surface and no connection to guardrails.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The first cut had each input register its own error into a shared store as it
rendered, clearing on unmount. That read as reasonable and was quietly useless:
the fields live on the Editor page, the gates live on Batch / Social / Output /
Profiles, and unmounting the Editor took every issue with it. Verified in the
browser — typing a malformed Steam URL, navigating to Batch, and finding
Generate perfectly enabled with no banner.
Replaced with two sources that between them cover what the setting promises:
- `collectEditorIssues` (pure, `@utils/editor-issues`) walks the editor STATE
against the same validators and the same `PLATFORMS` / `SOCIAL_FIELDS` config
the inputs use — one rule set, two consumers, no duplicated regexes. This is
what catches data that never passed through an input at all: an imported
profile, a preset shared by someone else, a draft persisted before a
validator got stricter. Since `ValidatedInput` refuses to commit invalid
text, imports are in fact the main way bad data reaches the store.
- `pending-invalid-store` holds text that is invalid and therefore *not*
committed. Without it, a field showing a red error would still be invisible
to every gate, because the store behind it holds the last good value. It has
no unmount cleanup — that was the original bug — so an entry lives until the
field is valid again.
Both are filtered through one relevance check, so a field nobody can see never
blocks: `adEmail` / `gameKeyEmail` while the split toggle is off, `zaloGroupLink`
outside Vietnamese output. Without that, Strict Mode could become an
unresolvable dead end — blocked on a field with no visible input to fix it.
Dropping the registry also removes the render-loop hazard it carried: the
effect published on every render of every input, guarded only by a deep-equal
bail-out.
Verified end to end in the browser: a bad Steam URL now disables Generate on
Batch and names the field in the banner; fixing it re-enables; and a Ko-fi link
on a vanity domain shows its inline prefix warning without blocking anything.
Tests 687 → 696.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Completes the field-limit work: `maxLength` is now wired at 53 call sites
across every editor form, the Settings genre-playlist inputs, the save dialogs
and the Playlist notes — grouped by what the field holds rather than named one
by one, so a new input inherits a sensible cap instead of inventing a number.
Two gaps that a `maxLength` attribute alone cannot close:
- **Imports bypass it entirely.** `maxLength` constrains typing and pasting;
a profile, preset or template — including one saved before the caps existed
— never passes through an input at all. `normalizeEditorPatch` now clamps on
the way in, covering the flat fields plus the nested `social` and
`storeLinks` URL maps. Without this the cap was decorative for exactly the
path most likely to violate it.
- **Strict Mode could not see any field.** The registry landed in the previous
commit, but nothing registered with it. Every `ValidatedInput` now carries a
stable `fieldId` (composed for loop-rendered fields: `editor.social.twitch`,
`settings.genrePlaylists.horror`), so the banner can name the offending
input rather than saying "something is wrong".
Also fixed: `liveUrl` was a plain `Input` with no validation at all — the only
URL field in the app that would accept anything and pass it straight into the
description.
Tests 681 → 687.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
**Over-limit output could always be copied.** `renderAll` has returned
`warnings: CharLimitWarning[]` since v0.5 and nothing in the UI ever read it.
Three ad-hoc checks had grown up in the components instead, each with a
different blind spot:
- `CopyButton` turned red and stayed clickable.
- `CopyAllBar` checked title and description but not tags — and bailed out of
every check when its `extraText` prop was set. Exactly one caller set that
prop: OutputPage, whenever more than one language was selected. So picking
a second language silently disabled limit checking on the main copy path.
- BatchPage passed no limits at all, so a 6000-character description copied
without a word.
`src/engine/limits.ts` is now the single derivation, and the requested rule is
all-or-nothing per output: if any one of title / description / tags is over,
none of them can be copied. Copying two fields and silently leaving the third
is how a half-populated description gets published.
Scoping decisions worth stating:
- Batch blocks the offending part's own buttons plus Copy All Batch, but not
the other 99 parts. Freezing an entire batch because part 7 is three
characters long would be useless.
- On Output, per-field buttons use the ACTIVE TAB's status while Copy All
uses the merge — an over-long Japanese title must not disable the English
copy button the user is looking at, but it must block the blob containing it.
- `OutputExtras` (thumbnail text, pinned comment) and Playlist stay ungated:
different YouTube surfaces with different limits, so reusing YT_LIMITS
there would be wrong.
Batch also gained the description and tag counters it never had — a row could
be 1500 characters over with nothing on screen saying so. Social bulk Copy All
now respects each platform's own cap (TikTok 4000, Reels 2200).
**Strict Mode** (Settings → Guardrails, default OFF). Blocks Generate, Copy and
Export while any field carries a hard error. This needed something that did not
exist: an app-wide view of which fields are invalid. Every error lived in the
private `useState` of the input that produced it, so no caller could ask the
question. `src/store/validation-store.ts` is that registry — ephemeral, not
persisted, since an error rehydrated from disk would describe text the user can
no longer see.
Errors only. `validateUrlWithPrefix` returns a soft warning for a link that
works but doesn't match a platform's usual prefix; blocking on that would
strand anyone on a vanity domain or a regional mirror.
Two exemptions: the log .txt/.json export stays ungated (a debugging export
must not be held hostage by an unrelated bad URL), and the Editor gets the
banner but no gate — it is where you go to FIX the fields, so disabling
anything there would be backwards. Unmounted fields deregister, so a hidden
`adEmail` or a swapped-out video-type field can never block.
**Settings sections are collapsible.** Genre Playlists renders one input per
genre — 42 of them — and was the tallest block on the page. It now ships
collapsed with a filled-count badge. The other eight sections became accordions
too (defaulting OPEN) because a page mixing bare headings with chevrons reads
as broken, and unknown ids default open so a section added later cannot vanish
for an existing user.
Settings persist v11 → v12 (`strictMode`, `settingsAccordionState`), with
`SCHEMA_VERSIONS.settings` bumped in lockstep. Both are coerced, not just
back-filled: a hand-edited `"strictMode": "yes"` is truthy in JS, and silently
switching a seatbelt on is the opposite of an opt-in. Also corrected
`SCHEMA_VERSIONS.profile` 1 → 2, left behind when profile-store bumped in v0.34.0.
16 UI keys across all six locales (validator 999 ui / 563 templates).
Tests 665 → 681.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Two independent guardrails; both were missing outright rather than broken.
**Exports never asked where to save.** There were two writers that disagreed:
`saveFile` branched correctly per platform but had exactly one caller (the log
.txt export), while every JSON export went through a private blob-download
helper with no platform branch at all. So "Export" on Settings, Profiles,
Presets, Templates, Social and the log JSON dumped straight into Downloads —
even on desktop, where a native Save As dialog had been available and
capability-approved the whole time.
Now one writer, `saveTextFile`, with three branches:
1. Tauri desktop — native Save As, then the existing `save_to_file` command.
No Rust or capability change was needed; the permissions were already there.
2. Web with the File System Access API — a real picker. It must be the FIRST
await in a click handler because it needs transient user activation, so
every call site now builds its payload synchronously first. A
`NotAllowedError` from a spent activation degrades to (3) instead of
losing the file.
3. Everything else (Android WebView, Firefox, Safari) — blob download.
`exportTypedToJsonFile` is now async and returns the outcome, so **cancelling
is silent**: dismissing a save dialog is a decision, not a failure, and
toasting "Export failed" at someone who pressed Escape is how people learn to
ignore toasts. The shared `useFileExport` hook holds that rule in one place and
retires the hardcoded English "Exported!" / "Export failed" strings.
Settings Import/Export is no longer desktop-only. That gate was a leftover from
when export meant dumping the on-disk settings.json; import has always been a
plain <input type="file">, and export now offers a real dialog on the web too.
**No field had a length cap** — `maxLength` appeared nowhere in the codebase, so
a pasted novel in the game-name field produced a title YouTube would reject.
`FIELD_LIMITS` groups caps by what a field holds (URL 200, email 320, short
name 100, label 300, long text 2000, timestamps = the 5000 description budget)
so a new input inherits a sensible limit instead of inventing one. `clampField`
covers the paths `maxLength` cannot: profile/preset/template import and
paste-autofill.
**Emails hard-stop at three per field.** The cap is enforced on the increase,
not the absolute count, which buys two things: a field that already holds four
(legacy profile, hand-edited import) stays editable down to three instead of
freezing, and a half-typed `a@b.com,c@` is never punished. Per field rather
than across the split — each of the three renders its own labelled line, so
filling the advertising address must not retroactively invalidate the contact.
**`ValidatedInput` no longer destroys good input.** On an invalid value it used
to call `onChange("")`, wiping the stored value while the box still showed the
user's text — so backspacing one character out of a complete URL silently
emptied the field, and autosave then persisted the empty value with no signal.
It now simply doesn't commit, leaving the last valid value in place; bad input
is kept out just as effectively. Also fixed while here: `displayValue` never
re-synced when the prop changed, so applying a profile or preset left the box
showing stale text that disagreed with the store.
i18n keys for the new strings land in the following commit.
Tests 629 → 655.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Reported: with Settings → "Split contact email by purpose" ON, the Batch tab
showed only the old single "📧 Business inquiries:" line, while the Output tab
correctly showed the grouped 📧 BUSINESS / CONTACT block with all three
addresses.
Root cause is not in the engine. `renderAll` had three call sites, each
hand-copying the same twelve settings fields into an options object, and
BatchPage's copy was missing two: `splitContactEmail` and `showThirdPartyAds`
(plus `tEn`). An absent flag defaults to `false` inside `buildDescription`, so
the else-branch emitted the legacy single line — silently, with no type error
and no failing test, because the engine tests call `buildDescription` directly
with an explicit options object and never exercise the wiring.
Rather than add a third copy of the list, the mapping now lives in one place:
- `SettingsRenderOptions` (settings-derived) is split from
`RenderOptionOverrides` (per-caller: `tEn`, `bilingualContentBlocks`), and
`RenderOptions` is their intersection. Same shape as before for `renderAll`.
- New `useRenderOptions` / `buildRenderOptions` produce the settings half; all
three call sites consume it and layer only their own overrides.
Two guards, both verified to fail when the original bug is reintroduced:
- Compile-time: `buildRenderOptions` builds a `Required<SettingsRenderOptions>`,
so dropping a key is `TS2741: Property 'splitContactEmail' is missing`.
- Runtime: `tests/hooks/render-options-parity.test.ts` diffs the produced keys
against `SETTINGS_DERIVED_RENDER_KEYS` in both directions and names the
offending key in the failure message.
Also fixed by the same change, since Batch was dropping it too:
`showThirdPartyAds` — the SPONSORS & PARTNERS block now renders in Batch.
Batch deliberately still passes no `tEn`: its rows are one language each, so
the bilingual `EN · LOCAL` treatment would duplicate every content-warning line.
Note for the changelog: Batch descriptions get *longer* for anyone who had
either toggle on, because those blocks were being silently dropped.
Tests 621 → 629.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The first attempt at this alert swapped the bare host substring for the full
URL, which CodeQL still flags — `js/incomplete-url-substring-sanitization`
fires on `.includes()` against any URL-shaped value, not on the needle's
length, so the change produced two alerts where there had been one.
A store line renders as `🎮 {label}{suffix}: {url}`, so asserting
`(free): <url>` against the whole description tests the actual adjacency the
case is about, drops `.includes()` entirely, and no longer needs to locate a
line by host at all.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
CI ran typecheck/lint/locales/test/build. Everything else the repo owned was
configured but never executed — `knip` was installed and configured yet ran
nowhere, Prettier had a config and no gate, and the six version fields the
release ritual bumps by hand had nothing watching them. This wires all of it
into the pipeline.
Correctness gaps this immediately caught:
- `tsconfig.json` covers only `src`, so tests/ and scripts/ were NEVER
type-checked. Adding `tsconfig.check.json` (+ `typecheck:all`) surfaced 53
errors, including three fields silently missing from the editor→engine
parity fixture: `videoStyleEra` (v0.22.0), `adEmail` + `gameKeyEmail`
(v0.34.0), and the four `endings*` fields (v0.16.0/v0.17.1). The fixture is
the guard against exactly that class of drift, and it had drifted itself.
- `vitest.config.ts` `include` matched only `*.test.ts`, so any `.test.tsx`
would have been collected by nobody and "passed" silently. Now `{ts,tsx}`.
New gates in ci.yml: `typecheck:all`, `format:check`, `knip`, `check:version`,
and an advisory `npm audit --audit-level=high` (advisory so a fresh transitive
advisory cannot redden every unrelated PR before Dependabot opens its fix).
Plus least-privilege `permissions: contents: read` — which also clears the
`actions/missing-workflow-permissions` code-scanning alert — and a
concurrency group that cancels superseded runs everywhere except `main`.
New scripts:
- `scripts/check-version-sync.ts` — asserts all SIX version fields agree
(package.json, package-lock root AND packages[""], tauri.conf.json,
Cargo.toml, Cargo.lock self-entry). Nothing else notices a missed one, and a
stale tauri.conf.json ships an installer that disagrees with its tag.
- `scripts/generate-locale-template.ts` — `npm run generate:locale` has been
advertised in package.json and docs/I18N.md step 1 since v0.1, but the file
was never committed, so the documented first step of adding a language
failed outright. Blocks the planned pt-BR + id work.
Dead code removed: the Rust `ensure_dir` command and its two scoped `opener:`
capabilities. Its documented caller, `openSettingsFolder()`, no longer exists
in `src/` — `opener:default` (all `openExternal` needs) is untouched. Also
`@tauri-apps/plugin-opener` left knip's ignore list now that it is genuinely
imported, and `DroppedReasonId` went from unused export to typing
PlaylistPage's dropped-reason state.
Security: the `js/incomplete-url-substring-sanitization` alert in
description-builder.test.ts was a real (if low-stakes) weak assertion —
`includes("itch.io")` also matches `https://itch.io.example.com/`, so the
test could pass on the wrong line. Now matches the full URL.
CHANGELOG: v0.31.0, v0.32.0 and v0.32.1 shipped as tagged releases but were
never logged, leaving the file jumping v0.33.0 → v0.30.0. Reconstructed from
the release commits in the file's existing house style.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
`prettier --check` failed on 81 files: the repo had a Prettier config and a
`format` script from day one, but nothing ever enforced them, so formatting
drifted file by file. This is that pass, isolated in its own commit so the
CI gate added alongside it lands on an already-clean tree and no future
feature diff has to carry whitespace noise.
Formatting only — no behavioural change. Verified by `npm run test:run`
(621 passing, unchanged) and `npm run typecheck`.
Markdown, `_schema.json` and the workflow YAML are deliberately excluded:
Prettier reflows prose and expands the locale schema's compact arrays by
~1600 lines, which makes both harder to review for zero benefit. The
`format` script is scoped to `{src,tests,scripts}/**/*.{ts,tsx,css}` to
match.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
`nanoid` <3.3.18 (GHSA-2v37-7h3g-55p8 — custom generators can loop
indefinitely when size is zero) reached the tree transitively through
postcss. `npm audit` now reports 0 vulnerabilities; the brace-expansion
advisories were cleared separately by #134.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Add a Settings "Split contact email by purpose" toggle (off by default).
When on, the editor exposes three email fields — Contact, Advertising,
and Game keys & playtest — and the description renders a grouped
"BUSINESS / CONTACT" block with one labeled line per non-empty field.
Off keeps the single "Business inquiries" line unchanged.
- New editor fields adEmail/gameKeyEmail (persist v17->v18); contactEmail
is reused as the Contact line, so no saved data moves. The
splitContactEmail toggle mirrors showThirdPartyAds end-to-end
(settings persist v10->v11). Profiles persist v1->v2. All migrations
are additive back-fills.
- +8 ui / +4 templates i18n keys across all six locales (983/563).
- 621 tests pass (613 + 8), typecheck/lint/locale validation green.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Grow the description's COMMUNITY block into the channel's full "join the
chat" hub. Two new dedicated invite fields — Signal
(https://signal.group/#<id>) and the Instagram group chat
(https://www.instagram.com/j/<id> or https://ig.me/j/<id>) — plus
Facebook Group moved out of the generic Social list into its own
facebookGroupLink community field. All three render for every output
language (like Messenger); Zalo stays Vietnamese-only. Block order:
Messenger, Signal, Instagram, Facebook Group, Zalo.
Each new link hard-rejects off-format input via a strict validator
(validateSignalGroupUrl / validateInstagramInviteUrl /
validateFacebookGroupUrl). The three fields thread through defaults, the
store (persist v16 -> v17), GeneratorInput, the editor -> engine mapper,
and template snapshots. The v17 migration lifts a legacy social.fb_group
value into facebookGroupLink and drops the dead key; normalizeEditorPatch
does the same for profiles/presets/templates.
i18n: 9 keys added / 1 removed across all 6 locales + schema
(975 ui / 559 templates). 613 tests pass (was 583). Five manifests
bumped 0.32.1 -> 0.33.0.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
v0.32.0 accepted `https://m.me/[id]` (a personal-page link) for the
Messenger Community field. A community/channel invite is actually
`https://m.me/ch/[id]` (e.g. https://m.me/ch/Abb1hmBhU_97UMCF/).
- Tighten MESSENGER_URL_REGEX to require the /ch/ segment (trailing
slash optional) and hard-reject the old bare form.
- Update the shown example (MESSENGER_URL_EXPECTED) + the 6-locale
placeholder to https://m.me/ch/yourid; refresh stale doc comments.
- Update validation/engine/migrate tests; add trailing-slash accept
and bare-form reject cases.
Engine and store are unchanged (the link is printed verbatim, and the
field type/persist shape is untouched). Bump to v0.32.1.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add two "join the chat" community links that render into a single
"💬 COMMUNITY" description block:
- Messenger community (https://m.me/[id]) — shown for every language.
- Zalo group (https://zalo.me/g/<code>) — Zalo is a Vietnam-audience
app, so the editor input only appears (and the description line only
renders) when the output language is Vietnamese, mirroring the VN
donate block. A value entered while in Vietnamese is preserved if the
creator switches language.
Both links are hard-validated (validateMessengerUrl / validateZaloGroupUrl)
so a malformed URL never reaches the output. New editor-store fields
persist via a v15→v16 migration and round-trip through saved templates.
i18n across all 6 locales (967 ui / 559 templates). Tests 560→581.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Playlist Generator now produces a status-adaptive pinned comment for the
latest video, and when a series is marked dropped, a multi-select of
reasons (predefined checklist + free-text) that render in both the
playlist description and the comment. Localized across all 6 locales.
New buildPlaylistComment engine fn + first tests for playlist-builder.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Playtest section (Store & Social): a signup link + platform dropdown
(Steam Playtest / Epic / itch.io / Discord / Other) + invite count
capped per-platform (≤100). Renders a localized "🧪 PLAYTEST" block in
the description only when a link is set, like Store Links. New config
playtest-platforms.ts; 3 editor fields thread through the store (persist
v14→v15 migration), GeneratorInput, and the editor→engine mapping.
Invalid-number guarding: validateIntegerInRange + validateBatchRange
reject negative / decimal / out-of-range / end<start / >100-span inputs.
Batch and Social bulk disable Generate + warn on a bad range; Playlist
"Total videos" and Playtest invites warn inline and guard the output.
Input primitive gains optional errorText/helpText.
60 new i18n strings across all six locales (validator 948/544). 544
tests (517 + 27), typecheck, lint, and locale validation pass; verified
live. Five manifests bumped 0.29.3 → 0.30.0.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Multi-language Output tabs were rendering content warnings / tech notes / playthrough notes bilingually after v0.29.2 forwarded the shared `tEn` translator. New `bilingualContentBlocks` render option (default true) lets the multi-language hook keep those blocks single-language while the AI-translation disclaimer stays bilingual. Single-language output unchanged.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
useMultilangOutput had drifted out of sync with useGeneratedOutput and never
forwarded showTranslationQuality, showThirdPartyAds, or the always-English tEn
translator to renderAll. As a result the AI-translation disclaimer (and the
identical third-party-ads disclaimer) never appeared when the Output page showed
two or more languages, and the bilingual blocks rendered target-language-only.
Bring the hook to parity with the single-language hook: destructure both
settings, build a memoized tEn, and pass all three into renderAll. Single-language
output and the Batch page were already correct. No engine/store/config/i18n
changes; 513 tests + locale validation (937/542) pass; verified live.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
GitHub deprecated the Node.js 20 Actions runtime on 2026-06-16 (removal
from runners 2026-09-16). release-android.yml was the only workflow still
pinning actions whose latest-supported runtime was node20; each has a
newer major declaring `runs.using: node24`, so bump to the floating major:
actions/setup-java v4 -> v5 (node20 -> node24)
android-actions/setup-android v3 -> v4 (node20 -> node24; defaults
cmdline-tools 20.0, NDK install
via sdkmanager unaffected)
actions/cache v4 -> v5 (node20 -> node24)
softprops/action-gh-release v2 -> v3 (node20 -> node24)
All four bumps are pure runtime migrations with unchanged inputs. The
node24 majors require Actions Runner >= 2.327.1, which GitHub-hosted
ubuntu-latest already satisfies. ci.yml and release-desktop.yml use only
checkout@v6 / setup-node@v6 (already node24) plus composite actions
(rust-toolchain, tauri-action) that have no Node runtime, so no changes
there. App build node-version (22) is unaffected — this is action
runtimes only. Verified with actionlint (clean) + YAML parse.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Side-by-side rows that never collapsed on narrow mobile (~360-400px) made
the Batch and Profile screens overrun the viewport horizontally on Android
and web mobile. Make those rows responsive (flex-col -> sm:flex-row) and
sweep a few adjacent overflow spots. Layout-only; desktop is unchanged
(every change gated behind the sm: breakpoint).
- Batch: part-range row stacks below sm (full-width Generate); copy-button
rows wrap.
- Profile: tab pill + Export/Import stack onto separate rows; Profile/
Preset/Template cards stack action buttons below content and let long
names wrap (min-w-0).
- Sweep: Settings responsive padding + wrapping header (Import/Export shows
on Android), VideoSettingsForm grid 1-col below sm, Modal pinned to
calc(100% - 2rem).
Bumps five manifests 0.29.0 -> 0.29.1 (package-lock.json resynced from a
0.28.0 drift). typecheck/lint/locales/513 tests/build all green; verified
live at 375px and 1280px with zero horizontal overflow.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add an explicit "Requirements & tested versions" section for the Android build:
- Minimum Android 11 (minSdk 30), target Android 16 (targetSdk 36), universal ABIs.
- Tested Android 11 -> 16 on emulators, plus a real device on Android 12.
- Rationale for the Android 11 floor: device coverage, a modern auto-updating
WebView (why the Android 12 real device worked but a stale WebView-91 emulator
black-screened), and component-level security upkeep (Play system updates /
Play services / WebView) since OS bulletins for 11-13 have ended.
Touches docs/PACKAGING.md, docs/FEATURES.md, README.md only — no code change.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Build and package the app for Android from the same Tauri 2 codebase, shipping
an installable, sideloadable signed APK alongside the desktop binaries.
Build / packaging
- cfg-gate desktop-only tray / single-instance / hide-to-tray / exit-prevention
in lib.rs behind #[cfg(desktop)]; move tauri-plugin-single-instance to a
desktop-only target table so the library compiles for Android.
- `cargo tauri android init` -> committed gen/android Gradle project; release
signingConfigs read keystore.properties (gitignored, from CI secrets locally).
- .github/workflows/release-android.yml: JDK 17 + Android SDK/NDK + rust targets,
decode keystore from secrets, build --apk, upload to the same draft release.
- vite.config.ts: es2020 build.target for Tauri builds (older-WebView safety).
Runtime fixes (found via on-device testing)
- External links: a real tap on `<a target="_blank">` makes the Android WebView
fire onCreateWindow, which Tauri tries to satisfy via the shell plugin's open
(no such binary on Android -> uncaught error, nothing opens). Strip
target="_blank" from external anchors and route clicks through the opener
plugin in the capture phase. (open-external.ts, main.tsx)
- Boot black screen on old WebViews: crypto.randomUUID() (Chrome/WebView 92+)
ran at module load and threw on WebView 91. Fall back to a manual RFC 4122 v4
built on getRandomValues. (uuid.ts; +4 regression tests, 509 -> 513)
- File export on Android routes through the in-WebView blob download. (IS_MOBILE)
Compatibility
- minSdk 30 (Android 11+), targetSdk 36 (Android 16): covers the large majority
of active devices with a modern, patched WebView + Google Play system updates.
Release: bump manifests 0.28.0 -> 0.29.0; docs (README, FEATURES, PACKAGING,
CHANGELOG). Verified on an Android 13 emulator (render, links, export).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Render a full-screen, non-dismissible consent gate in place of the router
until the user reviews the legal docs (Terms/Privacy/Disclaimer/License,
linked to the GitHub copies) and ticks one 'I agree' box. Acceptance is
recorded in the settings store (legalConsentVersion + timestamp) — no
cookie, no new storage key — and re-prompts only when CURRENT_TERMS_VERSION
is raised, so it is one-time in normal use and re-appears in fresh/incognito
storage.
Also: surface all four docs in About -> Legal (only License was linked
before); add a Windows MSI/NSIS installer license page via bundle.licenseFile;
add an accessible Checkbox primitive; and apply the persisted theme on boot
in main.tsx (fixes a pre-existing dark flash for light-theme users, and makes
the gate render in the right theme before the app shell mounts).
Consent state is additive (no persist version bump); healSettings coerces a
malformed value to 0 so a corrupt file re-shows the gate. 60 new locale
strings (10 keys x 6 languages); validator now 937 ui keys. +9 tests (500 ->
509).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Resolves the 4 high-severity esbuild advisories (GHSA-gv7w-rqvm-qjhr,
GHSA-g7r4-m6w7-qqqr) deferred from v0.27.0. esbuild 0.17.0-0.28.0 is
vulnerable; the fix (0.28.1) is only reachable via vite 8 -- vite 7.3.3
pins esbuild ^0.27.0 and cannot reach it. Dev-server-only; the shipped
static bundle was never affected. npm audit: 4 high -> 0.
- vite ^7.3.3 -> ^8.0.16, @vitejs/plugin-react ^4.3.0 -> ^5.2.0,
tsx ^4.16.0 -> ^4.22.4 (vitest 4.1.8 already supports vite 8)
- vite 8 bundles with Rolldown: manualChunks object form -> function
form (vite.config.ts) is the only source change required
- Full gate chain green (typecheck, lint, knip, validate:locales,
500/500 tests, build); dev/preview + Tauri-context build verified
- Bump 5 manifests 0.27.0 -> 0.27.1; CHANGELOG + stack-version docs
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add a reusable, router-agnostic ErrorPage (404/403/419/500/offline/runtime)
driven by a pure config/error-pages.ts kind->meta map. Wire standalone
error routes (/403, /419, /500, /offline) plus a catch-all '*' -> 404 as
siblings of the AppShell group, so they render full-screen with no shell —
closing the long-standing gap where unknown hash routes rendered blank.
Add a navigator.onLine hook + non-blocking, dismissible OfflineBanner (the
app works fully offline, so it never blocks input). Redesign the
ErrorBoundary fallback to reuse ErrorPage's 'contained' runtime variant, so
render crashes share the same localized visual language.
120 new locale strings (20 keys x 6 languages) + _schema.json; validator
now expects 927 ui keys per locale. +6 pure config tests (494 -> 500).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Node 20 reached end-of-life in April 2026 and GitHub is removing it
from runner images (actions/runner-images#14029), so setup-node now
downloads it on every run. Node 22 satisfies Vite 7's engine range
(^20.19 || >=22.12) and matches the docs/TECH-SPEC.md snippets.
Also sync the two doc mentions of CI's Node version.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Build-only run 27388695090 on windows-2025-vs2026 produced both MSI
and NSIS bundles cleanly, so windows-latest stays unpinned.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
windows-latest redirects to this image from June 15, 2026. Build-only
(no tagName), so no release is touched. Reverted before merge.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
GitHub forces the Node 24 runtime for actions on June 16, 2026 and
removes Node 20 from runners September 16, 2026. checkout v4,
setup-node v4, configure-pages v5, upload-pages-artifact v3 and
deploy-pages v4 all declare node20; their current majors (v6/v6/v6/
v5/v5) declare node24. tauri-action@v0 already runs node24 and
dtolnay/rust-toolchain is composite, so both stay.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Dependabot cargo security-update jobs for rand and glib fail with
security_update_not_possible every time Cargo.lock changes on main
(runs 27387346373, 27387346324). Both are transitive deps of tauri:
rand 0.7.3 is pinned to ^0.7 by phf_generator 0.8 (via kuchikiki),
fix is 0.8.6; glib 0.18.5 is pinned by the gtk-rs 0.18 stack, fix is
0.20.0. Cargo cannot resolve the patched versions until tauri bumps
those subtrees, so ignore both to stop the recurring red runs.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Only English ships in the main chunk (fallbackLng + the engine's
bilingual tEn must resolve synchronously); the 10 non-English locale
JSONs become Vite async chunks fetched on first use via
i18next-resources-to-backend. Main chunk: 594.0 -> 264.0 kB min
(204.3 -> 82.0 kB gzip), back under the 500 kB warning threshold.
Every reactive getFixedT site gates on the new useLanguagesReady hook
(an unloaded language would silently render English — and OutputPage
would save that as a wrong-language history entry); Batch/Social bulk
handlers preload all selected languages before their loops; main.tsx
preloads the persisted UI + output languages before first paint. A
failed chunk fetch is retried once via direct import (i18next pins
failed languages permanently), then logged, degrading to English.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Two new warning groups — Dialogue / Language (10) and Internet / Digital
life (18) — plus 5 color phobias, 5 suggestive-imagery disclosures, 2
body-image phenomena, and an educational/PSA-purpose disclosure: 207 -> 248
ids across 12 groups. 504 new locale strings (84 keys x 6 locales), VI
flag-prone labels masked per the v0.21.0 precedent. Backfills the
content-inventory docs (audio group + v0.23.0 VFX items were never
documented) and replaces the stale v0.7 warning lines in FEATURES.md.
Adds 8 tests incl. a CONTENT_WARNINGS <-> groups parity guard. Five
manifests bumped 0.24.2 -> 0.25.0.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
v0.24.1's Linux job failed on a sustained upstream GitHub-CDN 504 while the AppImage bundler fetched linuxdeploy, so v0.24.1 shipped with only Windows + macOS binaries. Set APPIMAGE_EXTRACT_AND_RUN=1 + NO_STRIP=true on the tauri-action step (fixes the linuxdeploy FUSE run-failure mode + future resilience; no-op on Win/macOS) and bump to 0.24.2 to re-run the full matrix. No application code changes — identical app to v0.24.1.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Security/deps: react-router 6.30.3→6.30.4 (moderate open-redirect patch, non-breaking) and vitest 3.2.4→4.1.8 (clears the dev-only critical Vitest-UI advisory); all 482 tests pass unchanged on the new major. npm audit now reports 0 vulnerabilities. Removed unused serde/serde_json from src-tauri/Cargo.toml (no refs in src-tauri/src/; cargo check confirms the crate still compiles). Documented the cross-post caption generator (Social tab) in README + docs/FEATURES.md. Five manifests bumped 0.24.0→0.24.1.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Adds a cross-post caption generator (TikTok 4000 / Instagram Reels 2200 / Facebook Reels 2200) with single + bulk modes and JSON import/export, a header dark/light theme toggle synced with Settings, an opt-in translation-quality notice for non-trusted (non EN/VI) output languages, and a Telegram social link. Fixes a stray 'Pick a DDR generation' warning on the OS Rig field via a pure validateCompositeField helper. Extracts a shared buildBilingualBulletSection helper reused across content warnings, tech notes, the translation notice, and the social-post builder. +28 tests (482 total). Gates green: typecheck, lint, validate:locales, knip, build.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Three concerns bundled per the per-version plan:
1. CHANGELOG catch-up — v0.22.0 was shipped without a `CHANGELOG.md`
entry. Backfilled the missing section (Added / Changed / Removed /
Under the hood) matching v0.21.0's structure.
2. +8 VFX warnings in the `photosensitive` group. New IDs:
`lens_flare_intense`, `bloom_excessive`, `particle_effects_dense`,
`screen_overlay_flashing`, `color_saturation_extreme`,
`motion_blur_heavy`, `depth_of_field_aggressive`,
`post_processing_intense`. Closes the gap between blanket
flashing-lights / strobe warnings and AAA / horror games that ship
intense VFX passes (bloom, particles, post-processing) without ever
triggering a strobe-style flash. Total warnings 187 → 195;
photosensitive group 5 → 13. Engine renders each automatically.
3. macOS + Linux in the OS Rig field. `CompositePart.options` widened
from a static array to a union with `(previousParts) =>
RigFieldOption[]`, plus new optional `labelKeyResolver` (swap
"Version" ↔ "Distro") and `hiddenWhen` (macOS has no Edition slot)
per-part predicates. macOS: 7 versions (10 Mojave-era through 26
Tahoe — the 15 → 26 jump is intentional, matching Apple's 2025
year-aligned numbering). Linux: 7 distros gameplay creators
actually use via Proton (Ubuntu / Fedora / Debian / Arch /
Manjaro / Pop!_OS / Mint) with per-distro version cascading. RAM
(the existing 2-part static composite) is unaffected — the union
accepts arrays unchanged. `RigEditor.renderComposite` walks parts
with a `previousValues` accumulator and resets all downstream
parts on parent change so the form can't end up in an invalid
state (e.g. macOS 11 Pro).
Stats: ui.json 835 → 844 keys (+9 = 8 VFX + 1 os_distro), templates
487 → 495 keys (+8 VFX). 6 locales updated in parallel.
454 tests pass (was 445, +9: 7 OS cascading cases + 1 empty-name
fallback + 1 RAM regression check). Gates green: lint, typecheck,
validate:locales (12/12), test, build. Five manifests bumped
0.22.0 → 0.23.0.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Group A — Warnings expansion + UX cleanup:
- New "audio" content-warning group (12 IDs: ear_piercing,
jumpscare_audio, sudden_volume_changes, distorted_audio,
screeching_metallic, persistent_high_pitch, audio_glitches,
heavy_bass_rumble, screaming_audio, glass_breaking_audio,
microphone_pops, white_noise_static). `loud_noises` migrated from
photosensitive into this dedicated group. Total warnings 175 → 187.
- Remove "Default Genre" from Settings (UI + state + legacy v1→v2
migration + migration tests). `healSettings` now strips both
`defaultGenre` and `defaultGenres` from persisted blobs.
- Remove "Dev Environment" block from About (locked hardcoded specs
that drift on every box upgrade; their wiki link survives in repo).
Group B — Editor additions:
- Video Style era toggle (12 eras: 1980s/90s/00s/10s/20s + modern,
cinematic, retro, vhs, film_noir, anime_mv, documentary). Combines
with `rig.video_editor` to emit a one-line credit like
"Edited in 1990s VHS style using DaVinci Resolve". Renders even
when `skipGraphicsSettings` is on (2D/pixel-art creators still
edit footage). New `src/config/video-styles.ts`; editor-store
persist version bumped 13 → 14 (additive, defensive coercion).
- OS field in My Rig — composite_dropdown following the RAM pattern
(name + version + edition → "Windows 11 Pro"). Windows 10/11 +
Home/Pro/Enterprise/Education/IoT for now; macOS/Linux can be
added later by extending the option arrays.
- `rig.os` locale key added across 6 locales (the rig.* namespace
itself already existed — only the new field's label is new).
Locale stats (per locale): ui.json 816 → 835 keys (+19),
templates.json 473 → 487 keys (+14). 6 locales updated in parallel
(en/vi/ja/es/ko/zh).
Tests: 416 → 445 passing (+29 — audio warnings touch no test, but
new OS composite tests + new video style line tests + reworked
default-genre migration test).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bundles two changes for the v0.20.0 release:
- Content warnings: +50 IDs across three thematic axes. The phobias
group gains 10 weather-related fears (homichlophobia/fog,
lilapsophobia/tornadoes, ombrophobia/rain, nephophobia/clouds,
ancraophobia/wind, cryophobia/cold, heliophobia/sun, cymophobia/waves,
limnophobia/lakes, potamophobia/rivers); 41 -> 51. The sensitive
group gains 20 political/religion/war themes (political_extremism,
religious_extremism, genocide, holy_war, holocaust_themes, civil_war,
mass_shooting, colonialism, propaganda, dystopian_state,
conspiracy_theories, censorship_themes, ethnic_conflict,
refugee_crisis, revolution_themes, assassination, coup_themes,
inquisition, forced_labor, ultranationalism); 29 -> 49. A new
social_phenomena group carries 20 psychological-social IDs that
don't fit clinical mental-health framing (autism_themes,
adhd_themes, hikikomori, neet_themes, social_anxiety_themes,
social_isolation, schizophrenia_themes, burnout_themes,
survivor_guilt, abandonment_themes, parasocial_themes,
gaslighting_themes, stockholm_syndrome, behavioral_addiction,
existential_crisis, impostor_syndrome, midlife_crisis,
quarter_life_crisis, workplace_harassment, masculinity_pressure).
Total content warnings 125 -> 175 across 9 groups (was 8). Fully
translated across all 6 locales. Purely additive.
- Tag generator: strip comma/semicolon/pipe from game names before
they enter the tag list. New sanitizeForTag helper applied to
rawName at generateTags entry and inside tagFriendlyGameName.
Title/description/hashtag paths still read input.gameName verbatim
so original punctuation survives for human copy. Fixes the case
where a game like "Hello, World" produced YouTube-broken composite
tags ("Hello, World gameplay" split at the comma).
Version bumped 0.19.0 -> 0.20.0 across all five manifests.
Pre-release gates green: lint, typecheck, validate:locales (12/12
files complete), 435 tests (+9 new for the tag fix), knip, build,
npm audit (0 vulnerabilities).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bundles five changes for the v0.19.0 release:
- Content warnings: +28 IDs (25 clinical phobias in the phobias group,
3 discrimination terms in the sensitive group); 97 -> 125 total,
fully translated across all 6 locales. Purely additive.
- Dead-code sweep: add knip tooling (knip.json + npm run knip); remove
the unused use-debounce.ts hook and ~13 unreferenced exports; tighten
~12 symbols to module-private.
- Security: npm audit fix for the brace-expansion moderate DoS
(transitive dev dependency, 5.0.5 -> 5.0.6).
- UI: scroll-to-top floating button that scrolls the AppShell <main>.
- Docs: accuracy pass across TECH-SPEC, ROADMAP, FEATURES,
CONTENT-INVENTORY (+ vi mirror), CHANGELOG, README.
Version bumped 0.18.0 -> 0.19.0 across all five manifests.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
package-lock.json (root + "" packages entry) and src-tauri/Cargo.lock
(yt-desc-gen entry) were left at 0.17.1 in the main release commit.
Bumped to 0.18.0 so tauri-action's same-version check passes and the
binaries it uploads are labelled correctly. Per project-memory note
from v0.13.1 incident — version-bump ritual is six files, not three.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bundles one new feature, two persistence-layer bug fixes, one cleanup,
and a transparency doc:
- feat: Vietnamese bank dropdown in VietnameseDonateEditor when output
language is `vi`. 30 banks from the SBV 2026 list (Big 4 state-owned
+ top 22 joint-stock + 4 foreign), plus a "Khác (nhập tay)" option
that reveals a free-form text input for unlisted banks. Persisted
shape (`vnBankName: string`) is unchanged.
- fix: UI language reverted to English on every app relaunch because
i18next initialised synchronously while the Zustand persist hydration
was async and nothing bridged the persisted value back to i18n.
App.tsx now reads `appLanguage` at mount and subscribes for future
changes (covers both the synchronous localStorage path and the async
Tauri settings.json path).
- fix: Settings JSON export was dumping the entire on-disk
`settings.json` — which contains every Zustand store's data. The new
exporter writes only the Settings store through the envelope-typed
flow already used by the Profiles tab. Importer rejects pre-v0.18.0
multi-store dumps with a friendly toast instead of silently injecting
profile / template / history rows into the Settings store.
- cleanup: removed the "Open Folder" button from Settings (low usage,
Tauri-only). The `ensure_dir` Rust command stays for other paths.
- docs: new `docs/CONTENT-INVENTORY.md` + Vietnamese mirror listing
every video type (20), genre (41), and content warning (96 across 8
groups) the editor surfaces. Linked from README's Documentation table.
Locale schema +2 keys × 6 locales (vnBankNameSelectPlaceholder,
vnBankNameOther). 720/720 ui keys per locale. 426/426 tests pass.
Bundle 427.46 kB (under 500 kB cap).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Closes the last deferred piece from the v0.16 ending redesign.
Multi-video ending playthroughs (case C) can now flip between
per-video previews of title / description / tags without leaving
the editor.
Key changes:
* `endingVideoIndex` joins `EditorData` (1-indexed, default 1).
Stored on the editor so the creator's pick survives navigating
away and back. Engine already respected the corresponding
`GeneratorInput.endingVideoIndex` since v0.17.0 — this just
persists it.
* "Preview video" Select dropdown in EndingsEditor case C.
Renders `endingVideoCount` options labelled "Video N (X–Y)"
with the matching ending-range bounds. Changing it pipes the
index into the engine, which slices `endings[]` for both
title (buildStructuredEndingLabel) and description
(sliceEndingsForVideo).
* "Previewing Video X of Y — Endings A–B" banner at the top of
Output page when in case C. Persistent reminder so a creator
flipping through videos doesn't forget which slice they're
looking at.
* `use-current-generator-input` forwards `endingVideoIndex` only
when `endingVideoCount > 1` — single-video mode passes
`undefined` so the slice helpers short-circuit to render the
union. Keeps the input cleaner for tests.
* `EndingsEditor.setVideoCount` clamps `endingVideoIndex` down
when the creator shrinks `endingVideoCount` (e.g. 6 → 2 with
index = 4 → snaps to 2) so the preview never targets a
non-existent video.
* Persist version 12 → 13 additive — `endingVideoIndex`
back-fills to 1 on first rehydrate; pre-v0.17.1 drafts with a
stale higher index get clamped to endingVideoCount by
migrateEditorState.
* 3 new locale keys × 6 locales (editor.endings.videoIndexLabel,
editor.endings.videoIndexHint, output.previewingVideo).
718/718 ui per locale.
* 4 new tests for v12→v13 migration (default back-fill, valid
preserved, clamp above max, clamp below 1). Total 426/426.
Bundle: index 473.91 KB (+3 KB). Under 500 KB cap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replaces the freeform "Endings shown" Input in Playthrough Notes
with a structured editor that knows about ending numbers, names,
multi-video splits, and timeline cross-validation. The output
description bullet renders comma-joined structured entries with
fallback to the legacy freeform for migrated drafts.
Key changes:
* New `EndingsEditor` component with three logical cases:
- 1 ending → Number + Name pair with live preview
- 2+ endings, 1 video → table row per ending + timeline gate
(warns when timeline lacks `ending` markers for each row)
- 2+ endings, 2+ videos → endings table + per-video range table
with auto-contiguous balanced split (extras spill into the
LAST video — climactic-final convention) and override support
+ inline overlap/gap/out-of-bounds warnings.
* Schema additions to `EditorData`:
- `endings: EndingEntry[]` ({number, name})
- `endingVideoCount: number`
- `endingVideoRanges: EndingVideoRange[]` (1-indexed inclusive)
- `endingsShown` kept on the type for migration round-trip but
no longer surfaces in the UI.
* Engine `endings-format.ts` — pure helpers used by description
builder + editor preview:
- `formatEndingEntry` (4 cases: both / number-only / name-only
/ neither → null drop signal)
- `sliceEndingsForVideo` (whole-array fallback when not multi-
video / index out of range; targeted slice otherwise)
- `clampRange`
* Timeline parser ending pattern now captures an optional ordinal
so `Ending 3: Best End` parses into `{keyword: "ending",
number: 3, rest: ": Best End"}`. Unblocks the case-B timeline
gate. Renderer collapses trailing whitespace so a bare `Boss`
no longer becomes `Boss `.
* Description builder reads structured `endings[]` first, falls
back to legacy `endingsShown` only when the array is empty.
Multi-row entries render comma-joined; sliced by
`endingVideoIndex` when supplied.
* Migration `migrateEditorState` v11 → v12:
- `liftLegacyEndingString` parses "Ending 3: Best End" /
"Ending 3" / localised "Kết thúc N" / "エンディングN" / etc.
into a single structured row. Unparseable strings fall
through to a name-only row.
- `computeContiguousRanges` builds the default video split.
- Clamps `endingVideoCount` to `[1, endings.length]`.
* 19 new locale keys × 6 locales under `editor.endings.*`
(705/705 keys, up from 686/686). Schema updated.
* 42 new tests (367 → 409): endings-format, editor-store
migration, description-builder structured render, timeline-
parser ending ordinal capture.
* Bundle: index 463.08 KB (+62 KB for new UI + engine). Under
the 500 KB cap.
Migration notes:
* Persisted v0.12–v0.15 drafts auto-lift their `endingsShown`
string into a single structured row on first rehydrate. The
rendered description bullet is byte-identical for the common
case ("True ending only" → "True ending only"). Numbered
legacy strings ("Ending 3: Best End") gain structure so future
edits via the new UI work seamlessly.
* Pre-v0.16 templates with `endings` missing still load — the
TemplateSnapshot type makes all three new fields optional.
* Case C (multi-video) currently renders the union of all
endings in the Output preview. Per-video output rendering is
wired into the engine via `endingVideoIndex` but the UI
selector for it lands in a follow-up patch.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Closes the "black-screen on bad file" class of bugs and gives every
JSON export an auto-detect header so users can no longer confuse
profile / preset / template files with each other.
Key changes:
* `ErrorBoundary` (new) wraps every <Route> in App.tsx plus a
top-level boundary in main.tsx. Catches render-time exceptions
that previously black-screened the app, surfaces a fallback UI
with `Try again` + `Reload page` actions, and copies the error
to the in-app Logs tab via the logger. Per-route boundaries mean
a crash on Profiles cannot take down the Editor.
* File envelope format (`src/utils/file-schema.ts`) — every JSON
export now writes `{ _app: "ytdescgen", _type, _schemaVersion,
_exportedAt, data }`. The `_type` discriminator lets imports
detect "you opened a Template file in Profiles importer" and
offer to auto-switch tabs instead of failing silently. Legacy
bare-array exports still import via shape detection.
* `importTypedFromJsonFile(expected)` returns a discriminated union
with five distinct failure kinds (cancelled / read-failed / empty
/ parse-error / wrong-shape / newer-schema) so every error gets a
targeted toast instead of a generic "Import failed".
* Black-screen root cause fix: null-guard the three-spread chain
`TemplateCard.snapshot` → `editor-store.normalizeEditorPatch` →
`ProfileCard.Object.values(profile.social)`. All three now treat
null/undefined as no-ops. Store-level import validators in
profile/preset/template stores filter rows with missing `id`
before they hit the store, so a malformed file can't even reach
the render path.
* 17 new unit tests in `tests/utils/file-schema.test.ts` cover the
envelope round-trip plus every detection branch. Total 367/367
pass.
Migration notes:
* No store schema bump. v0.14.x persisted state loads unchanged.
* Legacy bare-array export files still import via shape-detector.
Re-export to get the envelope header + tab-switch hints.
* Envelope versions: profile=1, preset=2, template=1, settings=9,
history=2. Bump per-type on a non-additive shape change.
Bundle: index 401 KB, ProfilesPage chunk 18.44 KB. Well under the
500 KB cap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Same-day patch on v0.14.0 closing two desktop-only papercuts.
* `openSettingsFolder()` now pre-creates the app-data directory via a
new `ensure_dir` Tauri command before calling `openPath(dir)`. Fixes
the first-run "Windows cannot find ... AppData\Roaming\
com.skullmute.ytdescgen" Explorer error — `appDataDir()` only
resolves the path string; the folder itself was being created lazily
on the first `save_to_file` write, so users who clicked Open Folder
before any setting had persisted hit the shell with a non-existent
path. `exportSettingsToFile` gets the same guard.
* Adds a Settings → Import button (Tauri-only, next to Export). Reads
via the existing `loadFile()` dialog wrapper, accepts both the
multi-store dump shape that Export produces *and* a bare
SettingsData payload, runs the input through `healSettings()` to
back-fill any missing keys, then dispatches via setState. Five
failure modes get their own toast (cancel, read-error, empty,
parse-error, non-object). Theme class on <html> is re-applied
directly because setState bypasses the setTheme action.
Auto-regenerated Tauri ACL schemas from local tauri-dev (incidental
Tauri-plugin minor versions; not behavioural). package-lock.json
version bump only.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bumps the six manifest files per the established ritual:
- package.json
- package-lock.json (root version + "" packages entry)
- src-tauri/Cargo.toml
- src-tauri/Cargo.lock (yt-desc-gen entry only)
- src-tauri/tauri.conf.json
`@tauri-apps/api` stays at 2.11.0 (Rust tauri crate is at 2.11.x;
no minor cross-bump needed this cycle).
CHANGELOG.md gains a v0.14.0 section covering the Apache-2.0
license switch, 22 new content-warning IDs (new gameplay_disclosure
group), mobile-responsive layout, and the docs sweep. Also
backfills the missing v0.13.1 hotfix section that the v0.13.1
release-day churn never landed in CHANGELOG.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Expands the content-warning vocabulary toward horror-channel staples
that the existing 7-group list lacked. Adds a new 8th group
`gameplay_disclosure` for transparency about non-vanilla play.
New IDs by group:
- Phobias (+3): coulrophobia, ablutophobia, taphophobia
- Photosensitive (+2): strobe_effects, screen_shake_intense
- Mental Health (+3): paranoia_themes, intrusive_thoughts, medical_horror
- Sensitive (+3): human_experimentation, cannibalism, nuclear_themes
- Horror-Specific (+5): liminal_spaces, analog_horror, unreality_themes,
pursuit_chase, entity_horror
- Playstyle (+2): first_time_playing, returning_player
- Gameplay Disclosure (NEW +4): mods_used, cheats_enabled,
glitch_exploits, assisted_run
Updates src/engine/types.ts CONTENT_WARNINGS array, the UI grouping
config, the locale validator schema, and all 6 locales x 2 files
(templates.json + ui.json). EN and VI authored directly; JA/ES/KO/ZH
AI-translated with disclosure documented in DISCLAIMER.md.
`npm run validate:locales` passes at 686/686 ui + 368/368 templates
across all 6 locales. Engine logic in description-builder.ts is
unchanged - the loop already renders content warnings in user
selection order regardless of count.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds canonical Apache License 2.0 text as LICENSE, NOTICE asserting
copyright + AI-assisted-dev disclosure, and the `license` field on
both package.json (npm) and src-tauri/Cargo.toml (Cargo).
Repository previously claimed MIT in README/CLAUDE.md without an
actual LICENSE file. Apache-2.0 was selected for the patent grant
and NOTICE pattern; see docs_guide.txt requirement.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The v0.13.1 rebuild failed because tauri-action's same-minor-version check
caught:
tauri (v2.11.1) : @tauri-apps/api (v2.10.1)
Dependabot's PR #51 bumped the Rust `tauri` crate to 2.11.1 but left the
npm `@tauri-apps/api` package at 2.10.1 (different ecosystem, separate
alert). The constraint `^2.0.0` allowed 2.10.x → 2.11.x but npm doesn't
auto-bump within range; needs explicit `npm install @tauri-apps/api@^2.11.0`.
The four plugin pairs were already aligned (plugin-dialog/fs/opener/shell
Rust crate versions match their npm counterparts exactly), so no other
bumps needed.
Side effect of `npm install`: package.json deps were alphabetized — that's
npm's default key-ordering on save.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
When PR #50 shipped the v0.13.1 hotfix, only `package.json` got bumped from
0.13.0 → 0.13.1; the Tauri-side manifests stayed on 0.13.0. As a result the
release-desktop run on the v0.13.1 tag built binaries as 0.13.0 and the
tauri-action uploaded them to the existing v0.13.0 release object, leaving
the v0.13.1 tag without a release on GitHub.
This commit closes the gap by bumping all three Tauri-side files:
- src-tauri/Cargo.toml
- src-tauri/tauri.conf.json
- src-tauri/Cargo.lock (yt-desc-gen entry)
Recovery follow-up after merge:
1. Force-move the v0.13.1 tag from d1cc099 to this merge commit
2. Re-run release-desktop on v0.13.1 (will pick up correct version)
3. Re-run release-desktop with workflow_dispatch input `tag: v0.13.0` to
restore the original v0.13.0 release binaries (which were clobbered)
The repo's version-bump checklist already documents this (5-file ritual:
package.json, package-lock.json, src-tauri/Cargo.toml, src-tauri/Cargo.lock
yt-desc-gen entry, src-tauri/tauri.conf.json) — see project memory note on
the v0.9.0 lockfile-bump miss.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Clears the upgradeable half of the rand Dependabot alert (GHSA-c275-2vrh-rmmc,
unsoundness with custom loggers using rand::rng()). Transitive update only —
no Cargo.toml change.
The other `rand 0.7.3` copy in the lockfile (deeply nested as
phf_codegen → selectors → kuchikiki → tauri-utils build-dependency) cannot
be bumped without a major upstream change in tauri-utils, and is build-only
(used by phf_codegen for hash-table seed generation — no runtime exposure).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Resolves Dependabot alerts:
- vite (GHSA-4w7w-66w2-5vf9, path traversal in optimized deps .map handling,
patched in 6.4.2 — jumping to vite 7 covers it cleanly)
- esbuild (GHSA-67mh-4wv8-2f99, dev server CORS allows arbitrary origins,
pulled transitively via vite 7 / vitest 3)
Dependabot's own PR #54 tried to bump vite to 8 but broke `npm ci` because
@vitejs/plugin-react@4.7.0 caps at vite 7 in its peer-dep range. This bumps
to the latest vite/vitest pair that plugin-react still supports.
Both deps are dev-scope only — no runtime impact on shipped artifacts.
- npm run typecheck — clean
- npm run lint — clean
- npm run test:run — 350/350 pass on vitest 3.2.4
- npm run validate:locales — 663 ui + 346 templates × 6 locales
- npm run build — clean, main bundle 426 KB raw / 133 KB gzip
(vite 7 default chunking runs a bit looser than vite 5's; still well under
the 500 KB CLAUDE.md budget)
No version bump — dev deps don't appear in the shipped artifact.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- workflows: narrow notify-* triggers to specific producer names so non-matching
workflow_run events don't instantiate a run (kills the Actions tab Skipped spam)
- workflows: auto-link each published release to a GitHub Discussion under
Announcements via a new link-discussion job before the Discord announce
- repo: add FUNDING.yml + ISSUE_TEMPLATE/{config,bug_report,feature_request}.yml
- docs: add docs/pc_spec.md, docs/dev_env.md (+ VI mirrors) and webapp/TAURI.md
- about: restructure AboutPage with Donate / Dev Environment sections, expanded
socials (Bluesky, Mastodon, Steam, Telegram bot+user, email, game Discord);
Ko-fi / Patreon moved from ABOUT.socials to new @config/donate
- header: persistent Donate button (Ko-fi) left of the language switcher
- sidebar: external Report Bug item linking directly to the bug_report template
- seo: full <head> metadata (description, OG, Twitter card, JSON-LD
WebApplication, 6 locale alternates), per-route useDocumentTitle hook applied
to all 9 pages, robots.txt, sitemap.xml, manifest.webmanifest, placeholder
favicon.svg
- warnings: new "horror_specific" group with 7 IDs (eye_horror, body_horror,
face_horror, cosmic_horror, extreme_gore, decay_rot, mutilation), localized
to en/vi/ja/es/ko/zh in both ui.json and templates.json
Additive only — no breaking changes to the engine, store schema, or persisted
content-warning IDs. _schema.json updated to reflect new keys.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bug fixes:
- AppShell layout reflow (h-screen overflow-hidden) so the main pane
scrolls without dragging the sidebar/header along
- Tauri window locked at 1100x750 (resizable=false, maximizable=false)
Gacha-quest editor:
- Anniversary year dropdown (1-20) replaces chapterName for anniversary type;
templates render "{{anniversaryYear}}{{ordinalSuffix}} Anniversary"
- Showcase swaps Chapter/Quest/Part for characterName input;
description matches user-requested phrasing including {{versionLabel}}
- New gachaVersion field (e.g. "1.2", "2.4"), surfaces in Gacha-specific
intros via description.intro.versionInline; distinct from the existing
versionInfo (driver / general game version)
- Smart placeholder per Quest Type (Day 12, Floor 12, Part 1, etc.) so
the inputs hint at the right shape per quest pattern
- Per-quest-type field visibility map controls which inputs render
My Rig editor:
- Cascading GPU dropdown (Brand -> Series -> Model) with ~200+ models
across NVIDIA, AMD, Intel Arc, Apple Silicon + free-text Custom brand
- Composite RAM input (size dropdown 4-256GB + custom numeric, paired
with DDR1-DDR7 dropdown). Output: "16 GB DDR5" / "48 GB DDR5"
- formatRigValue extended for both new types; legacy free-text passes
through unchanged so v0.12 profiles render identically
- Inline validation badges for incomplete selections (brand without
model, RAM size without DDR, custom numeric empty)
Content warnings:
- 27 new entries: 5 phobias (cynophobia, nyctophobia, pyrophobia,
pediophobia, hemophobia), 4 mental health (bipolar, ocd, panic,
dissociation), 5 sensitive (hate_speech, historical_atrocity,
slavery, terrorism, bullying)
- New "Playstyle disclosures" group (8 items): blind_playthrough,
no_spoilers_chat, casual/hardcore difficulty, permadeath,
speedrun_attempt, completionist_run, learning_mechanics
Copy validation:
- useClipboard().copy(text, { limit, fieldLabel }) refuses to write
when text exceeds the limit; toast warning surfaces the count
- CopyButton renders with text-danger style and warning icon when
over-limit so the lock state is visible before clicking
- CopyAllBar pre-validates Title and Description; combined error toast
if either is over
Storage:
- Editor store v10 -> v11 migration: adds characterName, anniversaryYear,
gachaVersion with safe defaults; out-of-range anniversaryYear coerces
to null
- Storage stays Record<string, string> for rig (pipe-delimited tuples)
so no rig migration needed
i18n:
- 6 locales (en/es/ja/ko/vi/zh) updated with new keys; schema validated
- 629 ui keys + 339 templates keys per locale
- ordinal suffix helper drops the English suffix for non-English locales
so "周年記念" / "주년" / "Aniversario" don't get "st/nd/rd/th"
Tests: 350/350 (was 335)
- 11 new rig-fields tests (cascading + composite + legacy passthrough)
- 4 new v10 -> v11 migration tests
- Anniversary title test updated to use anniversaryYear
Bundle: 373 KB raw / 125 KB gzipped, under the 500 KB target.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The v0.12.0 release added six new editor fields (endingsShown,
languagePatch + custom, gameVersion + custom, techNotes) but the field
mapping in src/hooks/use-current-generator-input.ts wasn't kept in sync.
Symptom: ticking a Tech Notes checkbox or filling Playthrough Notes
fields updated the editor state but never reached the description
preview, because the hook silently dropped them. The v0.12.0 unit tests
passed because they fed GeneratorInput to the engine directly,
bypassing the hook.
Also fixes the parallel TemplateSaveForm.tsx omission — saving as
template lost the same six fields, so loading a template later didn't
restore them.
Refactors the hook so the field-mapping is a pure exported helper
(buildGeneratorInputFromEditor) testable without React. Replaces the
50-entry useMemo deps list with [state, languageOverride] — the old
list was the silent-drop footgun. Adds a parity-guard test that fails
loud if any future EditorData field is added without surfacing it in
GeneratorInput.
EditorData is now \`export interface\` so the helper can reference it.
package-lock.json catches up to v0.12.x (was stuck at v0.11.0 since
the v0.12.0 PR forgot it). Test count: 335/335 (was 329/329).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Fixes the duplicate-tray-icon / orphan-process bug on desktop by registering
tauri-plugin-single-instance in src-tauri/src/lib.rs — second launches refocus
the existing window instead of spawning a fresh process.
Replaces the v0.7 standalone "🎯 Playthrough" line + "🎮 DIFFICULTY" block with
a unified ▸ 🎮 PLAYTHROUGH NOTES section (Run type, Difficulty, Endings shown,
Language patch, Game version) — three new structured fields piggyback on the
existing playthroughStatus + difficulty data, keeping the editor-store v9→v10
migration purely additive. A new ▸ 🛠 TECH NOTES bilingual checklist (24 items
across 5 groups) sits next to Content Warnings for production / playstyle
disclaimers, mirroring the v0.11 CW render pattern.
All 6 locales updated; 14 new description-builder tests + 9 new migration
tests; bundle 345 KB raw / 116 KB gzip (under the 500 KB constraint).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bumps the four release manifests that PR #44 didn't touch (package.json
itself was bumped inside that PR):
- src-tauri/tauri.conf.json
- src-tauri/Cargo.toml
- src-tauri/Cargo.lock (yt-desc-gen entry)
- package-lock.json
Also backfills CHANGELOG.md with the v0.10.0 section covering the three
features that landed via PR #44 — Pub/Dev Name → tag, GitHub Pages
white-page hotfix, and the vertical sidebar + About page.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* fix(deploy): correct GH Pages base path to /youtube-generator/
The deployed site at https://poli0981.github.io/youtube-generator/ was
serving a blank page because Vite's base was hardcoded to /yt-desc-gen/
(an old project name). Every asset request 404'd.
The actual GitHub repo is poli0981/youtube-generator, confirmed by the
Pages deploy log: "Evaluated environment url: https://poli0981.github.io/youtube-generator/".
Aligning the Vite base unblocks the live web build.
Also adds an empty public/.nojekyll so Vite copies it into dist/ —
defensive against future bundle filenames Jekyll might skip.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* feat(editor): add Pub/Dev Name field that emits a YouTube tag
When the Publisher / Developer site URL is filled in, a free-text
"Pub/Dev Name" input now appears underneath. Whatever the user types
becomes a bare YouTube tag (e.g. "Ubisoft", "FromSoftware") via the
tag generator — so SEO-relevant publisher names enter the tag pool
without inflating the description.
The new field is independent from the existing sponsorName/sponsorPlatform
pair, which still drive the description's "🎁 Thanks to …" line — that
flow is unchanged. Different semantic, different output.
- Schema bumped to v8 with an additive migration (empty-string default).
- Tag generator gates on a non-empty trim, reuses tagFriendlyGameName
for the 30-char per-tag limit, and lets the existing dedup pass
collapse case-insensitive duplicates against any future tag source.
- All 6 locales (en/vi/ja/es/ko/zh) translated; validate:locales clean.
- 4 new tag-generator tests cover emission, empty/whitespace skip,
dedup vs sponsorName, and over-long truncation.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* feat(v0.10): vertical collapsible sidebar + About page
Reworks the app shell from a horizontal top tab bar into a vertical
sidebar with a hamburger collapse toggle, and adds a new /about route
with app metadata, third-party credits, and configurable social links.
Sidebar
- TabBar.tsx renamed to Sidebar.tsx (vertical NavLink list, lucide
PanelLeftClose / PanelLeftOpen, w-56 ↔ w-14 width transition).
- AppShell switched from `flex flex-col` to a left-sidebar / right-pane
layout; Header stays at the top of the right pane.
- Collapsed state persisted via a new `sidebarCollapsed` field in the
settings store (v7 → v8, additive — healSettings back-fills the
default through the existing initialSettings spread).
- Ctrl+B toggles the sidebar (VS Code convention); shortcut surfaced
in the keyboard help cheatsheet.
About page
- New `/about` lazy route. Page reads from a new `src/config/about.ts`
(app name, version pulled live from package.json, repo + issues +
author + license URLs, and placeholder social URLs that hide their
rows when blank). YouTube channel left blank with a TODO marker —
fill in before tagging the v0.10 release.
- Third-party credits sourced from a new `src/config/third-party.ts`
with versions read from package.json deps so npm installs keep the
list honest. License + project URL hardcoded.
i18n
- All 6 locales (en/vi/ja/es/ko/zh) updated with `tabs.about`, the
new `sidebar.{expand,collapse}` block, the full `about.*` namespace
including `about.socials.*`, and `shortcuts.toggleSidebar`.
validate:locales clean at 448/448 keys.
Version bumped to 0.10.0. shadcn/ui evaluated and skipped — would have
forced a 10+ component retrofit and a token-system swap for one feature.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* chore(about): fill in social links (YouTube/X/Discord/Ko-fi/Patreon)
Replaces the TODO placeholders with the channel's actual URLs so the
About page's Connect section renders all five rows. Empty entries
would have hidden silently — wiring the real links is what the page
was waiting on before the v0.10 release.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Three CI release fixes against the v0.9.0 first run.
(1) macos-14 (ARM) failed in the DMG bundler:
`failed to run bundle_dmg.sh`
Tauri's DMG bundler runs an AppleScript via `osascript` to set
icon positions in the mounted DMG window. On hosted macOS runners
the headless display + sandboxing causes that AppleScript to
flake intermittently — known issue tracked in tauri-action.
Workaround: build only the `.app` bundle (`--bundles app`).
tauri-action tar.gzips the `.app` directory into a
`.app.tar.gz` upload. End user expands the archive and drags
the `.app` into /Applications.
(2) macos-13 (Intel) job sat in the queue 2h11m before being
cancelled. The `macos-13` free runner pool has been progressively
deprecated through 2025; jobs frequently never start. Drop the
matrix entry. Intel macOS users have no CI binary for now —
revisit by switching the macos-14 entry to
`universal-apple-darwin` if Intel support becomes a priority.
(3) Add `workflow_dispatch` with a `tag` input so the workflow can be
re-run manually against a previously-shipped tag without deleting
+ recreating it. `actions/checkout@v4` honours the input ref;
`tauri-action` honours the `tagName` input. This is the recovery
path for v0.9.0's missing macOS binary: after this fix merges,
`gh workflow run release-desktop.yml --ref main -f tag=v0.9.0`
rebuilds with the patched workflow against the v0.9.0 commit and
uploads to the existing draft release.
Matrix is now three platforms — Windows, macOS ARM, Linux. PACKAGING.md
docs reflect the change with explicit notes on the macOS choices.
Bumps package.json, src-tauri/tauri.conf.json, src-tauri/Cargo.toml,
and the yt-desc-gen entry in src-tauri/Cargo.lock from 0.8.1 to 0.9.0.
CHANGELOG.md gets a v0.9.0 section covering the three feature PRs that
shipped on main this release: #37 (Phase 1 B2 — URL extractors +
name-mismatch banner), #40 (Phase 1 B1 — gacha_quest video type with
17 quest patterns), #41 (Phase 2 — QoL trio + multi-platform release
matrix). 297 tests green, main bundle 270 KB, 428 ui + 203 template
keys per locale.
B3 — QoL trio:
(a) Cheatsheet modal — bare `?` key now opens the existing
ShortcutHelpModal (Ctrl+/ still works). The `?` handler skips firing
when the keydown target is an INPUT / TEXTAREA / SELECT / contentEditable
element so it doesn't hijack normal text entry. The modal grows a
search input that live-filters by translated label OR by the literal
key combo string (so "ctrl" finds every Ctrl-binding). Filter resets
on close.
(b) Genre search filter — GenreSelector now renders a search input
above the chip group. Live substring match (case-insensitive) on the
translated chip label. Empty query renders all 41 genres; empty result
set shows a localised "no matching genres" line in place of the chip
row.
(c) Bulk-toggle — three buttons above the chip group: "All RPGs", "All
Shooters", "All Horror". Clicking REPLACES the current selection with
the first MAX_GENRES (3) ids from the matching GENRE_GROUPS list — so
the cap is preserved end-to-end. Filter clears on bulk-toggle so the
new chips are always visible. Group registry lives in
src/config/genres.ts as a typed Record<GenreGroupId, readonly GenreId[]>.
i18n: 7 new keys/locale (4 in shortcuts/editor + 3 in
editor.genreGroups). All 6 locales fully translated. 428 ui keys/locale
(up from 421).
B4 — Multi-platform release matrix:
.github/workflows/release-desktop.yml grows from a Windows-only build
to a 4-entry matrix: windows-latest, macos-13 (Intel), macos-14 (ARM),
ubuntu-latest. fail-fast: false so one platform breaking doesn't
cancel the others. Each runner builds for its explicit
--target triple. Linux runner installs libwebkit2gtk-4.1-dev,
libgtk-3-dev, libayatana-appindicator3-dev, librsvg2-dev, and patchelf
(Tauri's webview + AppImage tooling).
tauri-action@v0 collects all artifacts onto a single draft GitHub
Release named "YTDescGen v__VERSION__". No code signing (open-source
project, recurring cert cost not justified) — users see the standard
unverified-publisher prompts on first launch. No git-cliff
auto-changelog; release notes come from the tag message.
Pre-workflow tags v0.8.0 and v0.8.1 will need a one-time manual
`gh release create` if multi-platform binaries are desired
retroactively. Documented in docs/PACKAGING.md.
CI: typecheck/lint clean. 297 tests pass. validate:locales 428/428 ui
+ 203/203 templates per locale. Main bundle 270 KB (≤500 KB gate).
Adds a first-class video type for gacha-game playthroughs. Covers the
quest taxonomy across major titles (Genshin, HSR, Wuthering Waves, ZZZ,
Honkai Impact 3rd, Reverse 1999, Nikke, Azur Lane, Granblue, …) where
the typical video is a quest-by-quest run with structured chapter /
event / side-quest metadata.
New config in src/config/gacha-quest-types.ts:
- GACHA_QUEST_TYPES: 17 literals grouped by use case
(story / events / tutorial-trial / endgame-multiplayer / showcase)
- GACHA_QUEST_TYPE_GROUPS: display-order grouping for the dropdown
- GACHA_PART_SUFFIX_STYLES: per-quest-type partNumber style — main_story
uses "Part N", anniversary + daily_commission use "Day N", endgame
uses "Floor N", every other quest type drops the suffix.
GeneratorInput grows three optional fields: gachaQuestType (the enum),
chapterName (free-form chapter / story-arc label), questName (free-form
event / side-quest name). partNumber is reused as-is.
Engine wiring:
- title-builder.buildTitle dispatches on videoType === "gacha_quest" to
the per-quest-type i18n template (`title.gachaQuestType.<id>`). The
template already embeds gameName + chapterName / questName + the
optional partSuffix; the standard `title.suffix` ("Gameplay No
Commentary") still tails the result, and the quality badge respects
badgePosition. Empty `videoTypeLabel` means a non-default badge in
"middle" position lands as its own segment, matching the v0.6
behaviour for `full` 4K runs.
- New helper `buildGachaPartSuffix(questType, partNumber, t)` resolves
`title.gachaPartSuffix.{part|day|floor}` based on the per-type style.
- description-builder routes the intro through
`description.intro.gacha_quest_<questType>` (17 distinct openings)
while every other videoType keeps its flat key.
- tag-generator gets one shared gacha pool — quest-type-specific tags
would balloon the pool and rarely surface in YouTube search.
UI (ExtraFieldsInput.tsx) renders a native <select> with <optgroup>
headers for the 5 quest groups, plus chapterName + questName inputs.
ExtraFields list for `gacha_quest` is
[gachaQuestType, chapterName, questName, partNumber].
Stores:
- editor-store v6 → v7: additive migration. Pre-v0.9 drafts get
gachaQuestType="main_story", chapterName="", questName="".
- TemplateSnapshot adds the three fields as optional so legacy
templates load cleanly via `loadProfile`'s spread.
- TemplateSaveForm + use-current-generator-input capture the new
fields end-to-end.
i18n: 67 new keys per locale (28 ui + 39 templates). All 6 locales now
carry 421 ui + 203 template keys. en + vi fully translated; ja/es/ko/zh
seeded with English placeholders per the v0.8 polish convention.
17 new tests across title + description + part-suffix engine paths.
297 total pass. Main bundle 266 KB (≤500 KB gate).
Adds four new storefront extractors to PLATFORM_NAME_EXTRACTORS:
- Epic: store.epicgames.com/<locale>/p/<slug>[-<6+-hex hash>]
- Nintendo US: nintendo.com/us/store/products/<slug>[-switch[-2]]
- Nintendo EU: nintendo.com/<locale>/Games/<segment>/<slug>[-<id>].html
- Humble: humblebundle.com/store/<slug>
PlayStation, Xbox, and Amazon Luna stay unsupported — their canonical
URLs use opaque product IDs rather than name slugs. Existing Steam,
itch.io, and GOG extractors are unchanged.
New isLinkNameMismatch(gameName, url) helper applies a subset-tolerant
token comparison: the link's tokens must all appear in the typed Game
Name. Apostrophes are stripped (not spaced) so Marvel's tokenises to
marvels and matches Steam slugs like Marvels_Spider-Man_Remastered
verbatim. Returns false when the URL is unsupported or either side is
empty.
StoreLinkEditor surfaces a reactive banner above the platform grid when
any filled link points at a game name whose tokens aren't a subset of
the user's Game Name. Iteration order follows PLATFORMS; dismissed
fingerprints (gameName|url pairs) are skipped so a chain of mismatches
surfaces one at a time.
i18n: 2 new keys per locale (editor.warning.linkNameMismatch and
common.dismiss). 393 ui keys per locale, fully translated in all 6
languages.
27 new tests across all 4 extractors and the mismatch helper. 280 total
pass. Main bundle 242 KB (≤500 KB gate).
* fix(v0.8.1): accept bare youtube.com + extra query params in playlist URL validator
The strict v0.8 regex required `www.youtube.com` and rejected any extra
query params after `list=`. Real YouTube share URLs often emit either
the bare `youtube.com` host or `&si=…`/`&pp=…` tracking suffixes, both
of which silently failed validation. ValidatedInput then called
`onChange("")` and wiped the entry from the settings store before the
user noticed — making the v0.8 phase 2 genre-playlist suggestion
feature look like it just didn't work.
The relaxed regex now accepts:
* optional `www.` (host can be `youtube.com` or `www.youtube.com`)
* `list=…` at any position in the query string, with sibling params
before AND/OR after
* a trailing `#fragment`
`watch?v=…` URLs and `youtu.be/…` short links remain rejected because
the path must be exactly `/playlist`. 4 new tests cover the relaxed
shapes (no-www, `&si=` suffix, list= after another param, fragment).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* chore: update version to 0.8.1
Patch release bumping all four manifest files.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* docs(changelog): backfill v0.8.0 + add v0.8.1 entries
CHANGELOG.md was last updated for v0.7.0 — adds the v0.8.0 release
notes (PRs #32 / #33 / #34 / #35) and the v0.8.1 patch.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* feat(v0.8-polish): VN bank/MoMo/ZaloPay donate, video-settings multi-line, mod-list textarea, template-snapshot fixes
Four small refinements requested before bumping 0.8.0.
VN donate (bank + MoMo + ZaloPay)
* Five new editor fields — vnBankName / vnBankAccount / vnBankHolder /
vnMomo / vnZalopay — surface in a new `VietnameseDonateEditor`
component nested inside the existing Store & Social accordion. The
editor is always visible regardless of output language; the
description block is gated on `language === "vi"` because non-VN
viewers don't typically use these payment methods.
* Description renders a `🏦 CHUYỂN KHOẢN / VÍ ĐIỆN TỬ (Việt Nam)` block
between donate links and social links. Bank line includes the holder
in parens when set, drops the parens when not. MoMo / ZaloPay each
get their own line, independent of the bank entry.
Video Settings — multi-line block with labels
* The "🖥 VIDEO SETTINGS" section now renders one labelled line per
token (Video / In-game Setting / Art Style / Version), matching the
key-value-per-line shape of the rig + timestamps blocks. The pre-v0.8
pipe-separated single line is gone.
* `composeGraphicsPart` drops its trailing "Setting" suffix — the new
"In-game Setting:" label provides the same context without the
"Cinematic Setting" / "Ultra Setting" double-up. The
`description.graphics.settingSuffix` template key is removed across
all 6 locales.
Mod List
* New `modList: string` editor field — multi-line textarea exposed
alongside `modName` whenever videoType is `mods`. Designed for pasting
straight from a mod manager (Wabbajack / Vortex / Mod Organizer).
* Description renders a `🧩 MOD LIST` block right after MY RIG, only
for the `mods` video type and only when the field is non-empty.
TemplateSnapshot completeness fix
* Adds the v0.7 phase 2 fields that had been missing — playthroughStatus,
difficulty, difficultyCustomLabel, contentWarnings — plus all v0.8
polish fields (modList, vnBank*, vnMomo, vnZalopay). Saving a template
now captures the full editor state. All new fields are optional on
the type so legacy snapshots load cleanly via `loadProfile`'s spread.
Migrations
* Editor store v5 → v6, additive — empty-string defaults for the 6 new
fields. No value mapping, no data loss.
i18n
* 6 locales × ui.json (14 new editor keys) + templates.json (2 new
section headers, 3 new graphics labels, dropped settingSuffix). 391
ui keys + 164 template keys per locale. Vietnamese fully translated;
ja / es / ko / zh seeded with English defaults for new editor strings.
Tests (7 new, 7 updated): `Video: 1080p - 60 FPS` / `In-game Setting:`
multi-line shape (8 tests), VN donate gating (4 tests, including the
non-vi guard), Mod List gating (2 tests). 249 total.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* chore: update version to 0.8.0
Bumps all four manifest files for the v0.8.0 release: package.json,
src-tauri/tauri.conf.json, src-tauri/Cargo.toml, and the yt-desc-gen
entry in src-tauri/Cargo.lock. Marks the end of the v0.8 cycle (PR #32
+ #33 + #34 — tag fix, graphics v2, livestream, genre playlists, VN
donate, video-settings multi-line, mod list, TemplateSnapshot fix).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Four small refinements requested before bumping 0.8.0.
VN donate (bank + MoMo + ZaloPay)
* Five new editor fields — vnBankName / vnBankAccount / vnBankHolder /
vnMomo / vnZalopay — surface in a new `VietnameseDonateEditor`
component nested inside the existing Store & Social accordion. The
editor is always visible regardless of output language; the
description block is gated on `language === "vi"` because non-VN
viewers don't typically use these payment methods.
* Description renders a `🏦 CHUYỂN KHOẢN / VÍ ĐIỆN TỬ (Việt Nam)` block
between donate links and social links. Bank line includes the holder
in parens when set, drops the parens when not. MoMo / ZaloPay each
get their own line, independent of the bank entry.
Video Settings — multi-line block with labels
* The "🖥 VIDEO SETTINGS" section now renders one labelled line per
token (Video / In-game Setting / Art Style / Version), matching the
key-value-per-line shape of the rig + timestamps blocks. The pre-v0.8
pipe-separated single line is gone.
* `composeGraphicsPart` drops its trailing "Setting" suffix — the new
"In-game Setting:" label provides the same context without the
"Cinematic Setting" / "Ultra Setting" double-up. The
`description.graphics.settingSuffix` template key is removed across
all 6 locales.
Mod List
* New `modList: string` editor field — multi-line textarea exposed
alongside `modName` whenever videoType is `mods`. Designed for pasting
straight from a mod manager (Wabbajack / Vortex / Mod Organizer).
* Description renders a `🧩 MOD LIST` block right after MY RIG, only
for the `mods` video type and only when the field is non-empty.
TemplateSnapshot completeness fix
* Adds the v0.7 phase 2 fields that had been missing — playthroughStatus,
difficulty, difficultyCustomLabel, contentWarnings — plus all v0.8
polish fields (modList, vnBank*, vnMomo, vnZalopay). Saving a template
now captures the full editor state. All new fields are optional on
the type so legacy snapshots load cleanly via `loadProfile`'s spread.
Migrations
* Editor store v5 → v6, additive — empty-string defaults for the 6 new
fields. No value mapping, no data loss.
i18n
* 6 locales × ui.json (14 new editor keys) + templates.json (2 new
section headers, 3 new graphics labels, dropped settingSuffix). 391
ui keys + 164 template keys per locale. Vietnamese fully translated;
ja / es / ko / zh seeded with English defaults for new editor strings.
Tests (7 new, 7 updated): `Video: 1080p - 60 FPS` / `In-game Setting:`
multi-line shape (8 tests), VN donate gating (4 tests, including the
non-vi guard), Mod List gating (2 tests). 249 total.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The big v0.8 feature drop: PC build viewers can finally see RT modes,
frame-gen multipliers, and upscaling quality in the description; 2D /
pixel-art games skip the Video Settings section entirely; livestreams
get their own video type with a 🔴 LIVE block; and the pinned-comment
template auto-suggests a per-genre playlist configured once in Settings.
Foundations
* New `src/config/graphics-settings.ts` — GraphicsPreset, RTMode,
FrameGenVendor, FrameGenMultiplier, UpscaleQuality, ArtStyle enums,
plus `GENRES_WITHOUT_GRAPHICS_SETTINGS` for the auto-suggest hint.
* `engine/types.ts` extends GeneratorInput; `livestream` joins VideoType.
* Editor store v4 → v5 migration maps legacy free-form `graphicsPreset`
text ("Ultra"→"ultra"; "Epic"→"custom"+"Epic") and backfills 9 new
fields. `legacyGraphicsPresetToEnum` is exported for unit tests, and
`normalizeEditorPatch` runs on `loadProfile` / `loadPreset` so legacy
profile / template snapshots round-trip cleanly.
* Settings store v6 → v7 — `genrePlaylists: {}` and
`pinnedCommentIncludeGenrePlaylist: false`.
Engine
* `description-builder.ts` — `composeGraphicsPart` produces lines like
`Cinematic Setting - NVIDIA Frame Generation x2 with Ray Tracing`,
with Art Style and Driver/Game Version as separate trailing tokens.
The whole 🖥 VIDEO SETTINGS section is omitted when
`skipGraphicsSettings` is true. Livestream videos render an extra
block with a locale-formatted scheduled time and the watch link.
* `tag-generator.ts` — new `livestream` pool ("livestream",
"live gameplay", `${gameName} live`, `${gameName} stream`).
* `pinned-comment-builder.ts` gains `includeGenrePlaylist`,
`genrePlaylists`, `genreLabels` options; emits the genre-playlist
suggestion line for the primary genre when configured.
UI
* `VideoSettingsForm.tsx` rewritten — preset Select, Custom field,
skip toggle (with help text), Ray Tracing chip multi-select,
Frame Gen vendor + multiplier, Upscaling Quality, Art Style, free-form
Driver/Game Version.
* `ExtraFieldsInput.tsx` — livestream extras (live URL, scheduled time
via native datetime-local input).
* `GenreSelector.tsx` — auto-suggest skip-graphics chip when a
visual_novel / fmv / rhythm genre is added; session-local dismissal.
* `SettingsPage.tsx` — Genre Playlists section (per-genre URL inputs
validated by `validatePlaylistUrl`); `pinnedCommentIncludeGenrePlaylist`
toggle nested under the existing pinned-comment template toggle.
* `OutputExtras.tsx` resolves genre labels and passes the new options
to `buildPinnedComment`.
* Profile + template stores carry `GraphicsPreset` typed slot;
TemplateSnapshot picks up the new fields as optional.
i18n — all 6 locales updated, schema enforces 377 ui + 160 template
keys / locale. Vietnamese fully translated; ja/es/ko/zh seeded with
English defaults for the new strings (refine later as needed). Brand
terms (DLSS / FSR / XeSS / Ray Tracing) intentionally English everywhere.
Tests (24 new): graphics composition (7), livestream (4 description +
1 title + 1 tag pool + 1 pinned greeting), genre-playlist suggestion (4),
`legacyGraphicsPresetToEnum` (7), settings-heal v6→v7 (3). 242 total.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Fixes the silent tag drop where a long game name (>30 chars after composition)
caused every game-name-bearing tag to disappear from the output. Adds
url-extractors that pre-fill Game Name from a pasted Steam / itch.io / GOG URL.
Tightens YouTube playlist URL validation. Introduces Publisher / Developer site
as a tenth store-link platform.
* tagFriendlyGameName helper strips trademark marks, peels edition qualifiers,
falls back to colon head, then leading words. generateTags now seeds both a
bare-name tag (≤30) and a compose-name (≤21) so composites also fit ≤30.
* validatePlaylistUrl rejects watch?v=, youtu.be, and http URLs; expects
https://www.youtube.com/playlist?list=[id].
* StoreLinkEditor onPaste auto-fills empty Game Name with extracted slug;
toast.custom shows the result with a 5s Undo action.
* Publisher platform uses a permissive HTTPS pattern for indie / niche releases
distributed only from a developer's own site.
* New i18n keys: validation.playlistUrlInvalid, editor.toast.urlAutoFilled,
common.undo (all 6 locales).
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Second half of v0.7. Bumps package.json to 0.7.0 and ships the final
feature set for this version. See CHANGELOG.md for the full cumulative
entry covering both phases.
New description fields
- PlaythroughStatus (none / blind / replay / newgame_plus / postgame)
renders a "🎯 Playthrough: …" line right after the intro.
- DifficultyLevel (none / easy / normal / hard / nightmare / custom)
renders a "🎮 DIFFICULTY" block after Video Settings. "custom" reveals
a free-form label that passes through the description untranslated —
game-specific names like "Lethal" survive a locale switch.
- ContentWarnings (multi-select: flashing_lights / loud_noises /
jump_scares) render a "⚠️ CONTENT WARNINGS" bulleted block between
the spoiler and mature warnings.
- All three use a "none" / [] sentinel: creator hasn't picked → section
is skipped entirely rather than rendered with a blank value.
Pinned-comment template system
- New pure engine module src/engine/pinned-comment-builder.ts composes
from four shared sub-keys (thanks / playlist / engage / askNextGame)
plus a per-video-type greeting. Missing per-type greeting falls back
to greetings.part; missing that too drops the line rather than
leaking a raw locale key.
- New Settings toggles showPinnedCommentTemplate (default off) and
pinnedCommentIncludeAskNextGame (default on, only rendered when the
parent toggle is on).
- OutputExtras renders a third section for the generated template with
its own copy button, alongside the existing freeform pinnedComment
field. They coexist as independent sections — no magic precedence.
- BatchPage generates one pinned-comment template per part per language
with its own copy button; the combined "copy everything" bar includes
the pinned block when the setting is on.
Refactor: useCurrentGeneratorInput hook
- The editor → GeneratorInput shape used to be copy-pasted across four
call sites (use-generated-output, use-multilang-output, BatchPage,
OutputExtras). Extracted into src/hooks/use-current-generator-input.ts
so future input fields touch one file instead of four.
Store migrations
- Editor store v3 → v4: adds playthroughStatus, difficulty,
difficultyCustomLabel, contentWarnings. Missing entries back-fill to
sentinels, so existing drafts round-trip cleanly.
- Settings store v5 → v6: adds showPinnedCommentTemplate and
pinnedCommentIncludeAskNextGame. Flat booleans pick up via the
existing healSettings spread.
Locales (6 languages, all in sync)
- ui.json: playthrough / playthroughOptions, difficulty /
difficultyOptions, difficultyCustomLabel / placeholder, content
warnings + options, pinnedCommentTemplate label + copy button,
Settings toggles for the template. (~23 new keys per locale.)
- templates.json: description.sections.{playthrough,difficulty,
contentWarnings} + description.{playthrough,difficulty,
contentWarnings} blocks + pinnedComment.{thanksForWatching,
playlistPrompt, engagementPrompt, askNextGame} + 18 per-video-type
greetings. (~36 new keys per locale.)
- _schema.json updated. validate:locales passes 314/125 keys across
all 6 locales.
Tests
- New tests/engine/pinned-comment-builder.test.ts (11 cases): default
greeting, localized game name, playlist include/exclude,
includeAskNextGame toggle, per-type greetings (boss, speedrun),
fallback to `part` greeting when per-type is missing, graceful
drop-line when even fallback is missing, channelName interpolation,
empty-locale returns "".
- description-builder.test.ts +8 cases for playthrough / difficulty
(preset + custom + blank custom) / content warnings (render / empty /
placement between spoiler & mature).
- settings-heal.test.ts +2 cases for v5 → v6 migration (back-fill
defaults + preserve user-set values).
- Full suite: 177 / 177 pass.
Version
- package.json 0.7.0-phase1 → 0.7.0.
- New CHANGELOG.md with cumulative v0.7.0 entry.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Add user-configurable title formatting so creators can switch the Batch
and Editor output to badge-first styles like "[2k] - Game - phần 1 -
Gameplay No Commentary". Reorganize the Settings page from 5 mixed
sections into 7 purpose-based sections so knobs are easier to locate.
Settings changes
- New nested `titleFormat: { badgePosition, separator, badgeCase }`
config in SettingsData with defaults that reproduce v0.6 output
byte-for-byte (middle / emDash / upper).
- Settings store v4 -> v5 with defensive sub-key merge in
healSettings so a partial titleFormat object keeps working defaults.
- New `setTitleFormat(patch)` action.
- Page split into Appearance / Language & Defaults / Editor / Title /
Description / Tags / History.
Engine changes
- buildTitle accepts an options bag (BuildTitleOptions) while still
accepting the legacy boolean third arg, so title-variants.ts and any
other existing caller keeps working unchanged.
- New composeTitle helper handles prefix / middle / suffix badge
positions; empty-badge case collapses all three to identical output.
- Separator resolution prefers `title.separators.<id>` with fallback to
the legacy `title.separator` key so partial locales still render.
- TitleFormatConfig + related types live in engine/types.ts (engine
stays pure, store re-exports).
Renderer / call sites
- RenderOptions.titleFormat threads through template-renderer into
buildTitle from useGeneratedOutput, useMultilangOutput, and BatchPage.
- Drive-by fix: useMultilangOutput was missing showSponsorCredit and
the sponsor fields on its GeneratorInput; added both so multi-lang
output matches single-lang.
Locales (6 languages)
- templates.json gains `title.separators.{emDash,hyphen,colon,pipe}`.
- ui.json gains the 14 new settings labels (titleFormatTitle,
descriptionSettingsTitle, badgePosition{Prefix,Middle,Suffix},
titleSeparator{EmDash,Hyphen,Colon,Pipe}, badgeCase{Upper,Lower}).
- _schema.json updated; `npm run validate:locales` passes 291/291 ui
keys and 89/89 template keys per locale.
Tests
- 10 new title-builder cases (prefix/middle/suffix, lower-case, hyphen/
colon/pipe separators, empty-badge collapse, legacy-separator
fallback, legacy-boolean arg).
- 3 new settings-heal cases (v4 -> v5 back-fill, partial titleFormat
merge, corrupt non-object titleFormat).
- Full suite: 156/156 pass.
Version
- package.json 0.6.0 -> 0.7.0-phase1. Tag + final 0.7.0 bump will land
with phase 2 (pinned-comment templates + new description fields).
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* feat(v0.6): sponsor / key-provider credit toggle
Adds a new optional "🎁 Thanks to {sponsor} for providing the
{platform} key of this game." line to the generated description, for
creators who get review / press keys from publishers or developers.
- Editor: new SponsorCreditEditor (sponsor name + key platform) inside
the Attribution accordion. Editor store v2 → v3 with a trivial
migration that back-fills empty strings for old drafts.
- Settings: new `showSponsorCredit` toggle under Tag Settings. Off by
default so existing users see no behaviour change. Settings store
v3 → v4; healSettings back-fills the new default.
- Engine: `buildDescription` / `renderAll` take a `showSponsorCredit`
option. Renders only when the toggle is on AND BOTH sponsor fields
are non-empty — partial data is treated as "not ready, skip" rather
than rendered with holes. Positioned above the music section and
donate block so the thank-you is visually prominent.
- i18n: added sponsor-section UI labels/placeholders, the
`settings.showSponsorCredit` toggle label, and
`description.sections.sponsorCredit` template across all 6 locales
(en, vi, ja, es, ko, zh) + schema.
- Tests: 7 new description-builder cases (render / toggle-off / blank
name / blank platform / trim / ordering / vi localization) + 1
healSettings case for the v3 → v4 back-fill.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* chore: update version to 0.6.0
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a new optional "🎁 Thanks to {sponsor} for providing the
{platform} key of this game." line to the generated description, for
creators who get review / press keys from publishers or developers.
- Editor: new SponsorCreditEditor (sponsor name + key platform) inside
the Attribution accordion. Editor store v2 → v3 with a trivial
migration that back-fills empty strings for old drafts.
- Settings: new `showSponsorCredit` toggle under Tag Settings. Off by
default so existing users see no behaviour change. Settings store
v3 → v4; healSettings back-fills the new default.
- Engine: `buildDescription` / `renderAll` take a `showSponsorCredit`
option. Renders only when the toggle is on AND BOTH sponsor fields
are non-empty — partial data is treated as "not ready, skip" rather
than rendered with holes. Positioned above the music section and
donate block so the thank-you is visually prominent.
- i18n: added sponsor-section UI labels/placeholders, the
`settings.showSponsorCredit` toggle label, and
`description.sections.sponsorCredit` template across all 6 locales
(en, vi, ja, es, ko, zh) + schema.
- Tests: 7 new description-builder cases (render / toggle-off / blank
name / blank platform / trim / ordering / vi localization) + 1
healSettings case for the v3 → v4 back-fill.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Settings are now re-merged with defaults on every rehydrate, so a
missing / partially-written settings.json can never leave the store in
an incomplete state — missing keys are back-filled, legacy shapes are
upgraded, and removed keys are stripped. Bumps store version 2 -> 3.
Also removes the autoSaveDraft toggle: the editor store already
autosaves unconditionally via zustand persist middleware, so the flag
had no effect. Cleaned up across UI, all 6 locales, and schema.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 10:40:54 +07:00
303 changed files with 52404 additions and 4708 deletions
**YTDescGen** is a desktop-capable web application that generates YouTube video titles, descriptions, and tags for Gameplay No Commentary channels. It supports multiple languages, game genres, and video types with a profile/preset system to eliminate repetitive data entry.
This project adopts the **[Contributor Covenant v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)** in full.
By participating in this project — opening issues, submitting pull requests, commenting, translating locales, or any other form of contribution — you agree to abide by its terms.
## Reporting
Report violations privately to the maintainer: `lopop05905@proton.me`.
All reports are reviewed and investigated promptly and fairly. The maintainer is obligated to respect the privacy and security of the reporter.
## Enforcement
Examples of enforcement actions, in escalating order:
1. A private warning.
2. A public warning on the relevant issue / PR.
3. A temporary ban from contributing.
4. A permanent ban — applied without warning for serious violations (harassment, threats, malicious code submissions per [`CONTRIBUTING.md`](./CONTRIBUTING.md) auto-ignore rules).
For the full list of enforcement guidelines, read the [Contributor Covenant v2.1 — Enforcement Section](https://www.contributor-covenant.org/version/2/1/code_of_conduct/#enforcement).
- One logical change per PR. Don't bundle unrelated refactors.
- All locale files must stay in lock-step — see the i18n section below.
- AI-assisted contributions are welcome but **must be disclosed** in the PR description.
### i18n Contributions
If your change adds or removes any user-facing string:
1. Update the locale schema at `src/i18n/locales/_schema.json` first.
2. Add the key to **all 6 locales** (`en` / `vi` / `ja` / `es` / `ko` / `zh`).
3. `npm run validate:locales` must pass.
Native-speaker corrections to AI-translated locales (JA / ES / KO / ZH) are especially welcome — see [DISCLAIMER.md](./DISCLAIMER.md) for the current translation-quality status.
## Auto-ignored Contributions
The following are closed without review and may result in a contributor ban — no exceptions:
- **Suspected malicious code.** If a PR contains code we suspect may be a supply-chain attack, obfuscation, credential harvesting, cryptominer, or any form of malware — even if CodeQL and Dependabot don't flag it, the maintainer may investigate manually. **Detection equals ban.**
- **Unverified or suspicious links** in issues, PRs, or comments (pastebin scrapers, redirect chains, unfamiliar shortlinks, link-shortener URLs without context).
- **Behavior or language violating** [GitHub's Acceptable Use Policies](https://docs.github.com/en/site-policy/acceptable-use-policies).
- **Off-topic / rambling reports** that don't get to the point. Example of what gets ignored: *"Good morning, today is a beautiful day, I was just wondering if maybe…"* — get straight to the problem.
- **PRs that touch hundreds of files for a one-line fix** (typical sign of an auto-formatter run on unrelated files).
- **Tests deleted, or `--no-verify` used to bypass pre-commit hooks.**
- **"AI rewrote my entire codebase in a different style" PRs.** AI-assisted edits are welcome (disclosed); whole-repo rewrites are not.
- **Spam, drive-by typo fixes** that don't address a real issue, and karma-farming PRs.
## What We Want
- Bug fixes with a reproduction case and a regression test.
- Locale corrections from native speakers.
- New content-warning IDs with all 6 translations and a clear rationale (especially horror-genre vocabulary).
- New video types or genres that fit the gameplay no-commentary use case.
- Accessibility and mobile-responsive improvements.
- Performance fixes with a `before/after` measurement.
## What We Don't Want
- Cosmetic refactors with no behavior change.
- Adding new runtime dependencies without first opening an issue to discuss the tradeoff.
- Renaming files without coordinating with open PRs.
- Changes to the LICENSE or NOTICE files (these are governance, not contributions).
## License
By contributing, you agree your contribution will be licensed under the [Apache License 2.0](./LICENSE), the same license as the project, and that you have the right to grant that license.
YTDescGen is a personal project built by a single maintainer (`@poli0981`) for use with the [`@SkullMute`](https://www.youtube.com/@SkullMute) YouTube channel and shared publicly as open source. It is **not a commercial product** and there is no support obligation.
Code, documentation, locale translations, and design decisions in this repository were **co-authored with the assistance of Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. All commits, releases, and architectural decisions are reviewed and approved by the maintainer before merging.
This disclosure applies to:
- Source code in `src/` and `src-tauri/`.
- Documentation in `docs/` and all root markdown files.
- Locale files in `src/i18n/locales/`.
- CI/CD workflows in `.github/workflows/`.
See also: [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md) § "AI-Assisted Development Disclosure".
## Translation quality
The application UI ships in six languages. Authoring quality varies:
| Locale | Authoring | Notes |
| --- | --- | --- |
| English (`en`) | Maintainer + AI | Primary working locale. Strings reviewed before commit. |
| Vietnamese (`vi`) | Maintainer (native) + AI | Reviewed by the maintainer, who is a native Vietnamese speaker. |
| Japanese (`ja`) | AI-translated | Not native-reviewed. Grammar and tone may be imperfect. |
| Spanish (`es`) | AI-translated | Not native-reviewed. Regional voice (LatAm vs. Castilian) not specifically targeted. |
| Korean (`ko`) | AI-translated | Not native-reviewed. Honorific register chosen for neutrality, not specific cultural fit. |
| Chinese (`zh`) | AI-translated | Simplified Chinese only. Not native-reviewed. |
If you're a native speaker and spot mistranslations, please open an issue or PR — see [CONTRIBUTING.md](./CONTRIBUTING.md) § "i18n Contributions".
## Voice and tone
Generated description templates use an opinionated tone tailored to the **gameplay no-commentary** YouTube niche, with extra emphasis on horror / scary games (because that's the maintainer's channel). The output may not fit every channel's voice or every country's reader expectations. The application is template-driven — you can edit any generated text before publishing.
Some Vietnamese phrasings deliberately keep loanwords and casual tone reflecting how Vietnamese gameplay creators commonly write descriptions. These are not "incorrect translations"; they are stylistic choices for the target audience.
## No warranty
This software is provided **as-is, with no warranty of any kind**. See [`LICENSE`](./LICENSE) (Apache 2.0) §§ 7 and 8 for the full disclaimer of warranty and limitation of liability.
In plain English: if the application crashes, mangles your draft, generates a description that gets your video flagged by YouTube, or causes any other harm — the maintainer is not liable. Use at your own risk; back up your drafts.
## Not affiliated with YouTube / Anthropic
YTDescGen is **not** affiliated with, endorsed by, or sponsored by YouTube, Google LLC, or Alphabet Inc. The generated output is intended to be pasted into the YouTube Studio editor; this application does not interact with the YouTube API.
Use of Claude Code during development does **not** make this an Anthropic product. Anthropic, Claude, and Claude Code are trademarks of Anthropic, PBC. This project is independent.
## Not legal or financial advice
Any mention of GDPR, CCPA, copyright law, YouTube's monetization policies, or similar topics in this repository's documentation is provided for orientation only and is **not legal advice**. Consult a qualified lawyer in your jurisdiction if you need an authoritative answer.
- **Areas of responsibility**: all — core engine, locale management, UI, Tauri desktop shell, releases, CI/CD.
## Maintainer Responsibilities
- Triage incoming issues and PRs.
- Run the release process: `CHANGELOG.md` entry, version bump, build artifacts, signed tag.
- Enforce the [Code of Conduct](./CODE_OF_CONDUCT.md).
- Review and approve locale translation contributions.
- Coordinate security advisory disclosure per [SECURITY.md](./SECURITY.md).
## Becoming a Maintainer
There is currently no formal pathway. The project has been solo since inception. If you'd like to help maintain a specific area — most realistically, native-speaker review for one of the AI-translated locales (JA / ES / KO / ZH) — open an issue describing what you'd like to take on.
Persistent, high-quality contributions over time are the path. There is no application form.
YTDescGen is an **offline-first** template engine for generating YouTube video metadata. This document describes what data the application handles, where it lives, and what it never collects.
## What We Collect
**Nothing.** The application sends no data to any server controlled by the maintainer.
There is no analytics provider, no telemetry, no crash reporter, no A/B testing, no advertising network, no behavioral tracking. There is no backend.
## What Stays on Your Device
### Web version (GitHub Pages)
The web build stores your work in your browser's **`localStorage`** only. Keys used:
`localStorage` is scoped to the origin and never transmitted. Clearing your browser data, browsing in a private/incognito window, or signing out wipes all of it.
### Desktop version (Tauri)
The desktop build uses the operating system's standard application-data directory:
The same key set as the web version is stored as JSON files there. Uninstalling the application or deleting that directory removes everything.
## Third-Party Services
The application does **not** call third-party APIs at runtime.
Optional links you may click — donation buttons, store links you paste into a draft, social links you save to your profile — navigate **away** from the application to third-party sites. Those sites have their own privacy policies; the maintainer is not responsible for them.
YouTube oEmbed, the Steam store API, Twitch helix, and similar services are **not** fetched by this application.
## Cookies / Local Storage Distinction
The web version uses **`localStorage`**, not cookies. No cookie is set by the application. GitHub Pages itself may issue a session cookie at the platform level — that is GitHub's, not ours, and is governed by [GitHub's Privacy Statement](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement).
The first-run consent acknowledgement (added in v0.28.0) is recorded **inside the existing settings record** — a `legalConsentVersion` number plus a local timestamp — not as a separate cookie or storage key. It never leaves your device.
## Children's Privacy
This application is not directed at children under 13 and does not knowingly process any personal data from anyone.
## GDPR / CCPA / Equivalent Rights
Because no data ever leaves your device:
- **Right to access**: your data is already accessible — open DevTools → Application → Local Storage on the web, or browse the application-data directory on desktop.
- **Right to erasure**: clear your browser's site data (web) or delete the application-data directory / uninstall the app (desktop).
- **Right to portability**: use the in-app **Export** action in `Profiles` / `Presets` / `Templates` / `History` / `Logs` to download JSON.
- **Right to object / restrict processing**: not applicable — no processing happens off-device.
- **Right to know what is sold or shared**: nothing. Nothing is sold or shared.
## Changes to This Policy
If this policy changes, the change is committed to the repository under `PRIVACY.md` with the `Effective` date updated. There is no notification mechanism because the application has no way to reach you.
**YouTube Gameplay Description Generator** — A template engine for Gameplay No Commentary channels.
**YouTube Gameplay Description Generator** — an offline-first template engine for Gameplay No Commentary YouTube channels.
Generate YouTube video titles, descriptions, and tags in multiple languages with one click.
Generate YouTube titles, descriptions, and tags in six languages with one click. Save channel, rig, and game presets to skip repetitive data entry. Works in the browser (GitHub Pages), as a ~8 MB native desktop app (Windows / macOS / Linux), or as an installable Android APK — all from one Tauri 2 codebase.
YTDescGen is a single-purpose template engine. It does **one** job: turn a small set of structured fields (video type, game name, genres, rig, social links, content warnings, …) into a publish-ready YouTube title + description + tag set.
It doesn't talk to the YouTube API. It doesn't upload anything. It doesn't track you. There is no server. State lives in your browser's `localStorage` (web) or your OS application-data directory (desktop) — and nowhere else.
Built for the gameplay no-commentary niche — especially horror / scary games — by someone running the [@SkullMute](https://www.youtube.com/@SkullMute) channel who got tired of pasting the same boilerplate into every video. Released under Apache 2.0 in case it's useful to anyone else.
## Features
- **14 video types** — Full Gameplay, Part, Boss Fight, Speedrun, 100%, DLC, and more
- **12 languages** — English, Vietnamese, Japanese, Spanish, Korean, Chinese, and more
- **25 game genres** — Action, Horror, RPG, FPS, Open World, Souls-like, and more
- **Profile system** — Save social/rig/channel info once, reuse forever
- **Game presets** — Save game info once, reuse for multi-part series
- **Character counters** — Real-time limits for title (100), description (5000), tags (500)
- **Batch mode** — Generate descriptions for multiple parts at once
- **Desktop app** — Windows & macOS via Tauri (~8MB binary)
- **Offline** — Full functionality without internet
- **20 video types** — Full Gameplay, Part, Boss Fight, Boss No-Hit, Ending, Speedrun, 100%, DLC, NG+, Challenge, Side Quest, Secret, Comparison, Guide, Mods, Collectibles, Livestream, Gacha Quest, Demo, Demo Part.
- **6 UI languages** — English, Vietnamese, Japanese, Spanish, Korean, Chinese. *(VI authored by a native speaker; JA / ES / KO / ZH AI-translated — see [DISCLAIMER.md](./DISCLAIMER.md).)*
- **40+ game genres** — across action, RPG, FPS, horror, soulslike, indie, simulation, fighting, and more.
- **248 content-warning IDs** across 12 groups — spoilers, photosensitive/VFX, audio, dialogue/language, phobias (incl. color phobias), mental health, social phenomena, internet/digital life, sensitive themes (incl. method-specific death/violence and suggestive imagery), horror-specific, playstyle, and gameplay disclosure (mods / cheats / glitches / guide-assisted / educational purpose). Sets viewer expectations before they hit play.
- **Profile system** — save channel / social / rig info once, reuse across every video.
- **Game presets** — save game name + store links once, reuse across the entire part series.
- **Snapshot templates** — save full-form configurations and recall in one click.
- **Smart tag generation** — combines genre pool, platform, quality tier, multilingual hooks, and trending terms; auto-dedup and 500-char-limit aware.
- **Character counters** — real-time limits for title (100), description (5000), tags (500). If **any one** is over, no field can be copied — partial copying is how a half-finished description gets published.
- **Guardrails** — hard length caps on every input field, a three-address cap per email field, and an opt-in **Strict Mode** that blocks Generate / Copy / Export while any field holds an error.
- **Batch mode** — generate metadata for all parts of a series in one pass.
- **Cross-post captions** — a dedicated **Social** tab re-packages the same YouTube source into short-form captions for **TikTok** (4,000-char), **Instagram Reels**, and **Facebook Reels** — title, rig, content warnings, copyright, thanks, and hashtags (game + genre + curated per-platform popular tags). Single + bulk modes, per-platform character limits with smart overflow trimming, and JSON import/export.
- **Desktop app** — Windows, macOS & Linux native binaries via Tauri (~8 MB).
- **Android app** — installable, sideloadable `.apk` built from the same Tauri 2 codebase. **Requires Android 11+** (tested 11–16; real-device test on Android 12). Grab it from [Releases](https://github.com/poli0981/youtube-generator/releases) and enable "Install unknown apps" to sideload.
- **Mobile-responsive web** — drawer navigation, touch-sized controls, iOS-safe text-input behavior. Tested down to 360 × 640.
- **100% offline** — no server, no telemetry, no account. See [PRIVACY.md](./PRIVACY.md).
See [`docs/PACKAGING.md`](./docs/PACKAGING.md#android-apk-packaging) for the SDK/NDK setup and signing steps.
Full development setup, IDE config, and troubleshooting: see [`docs/DEVELOPMENT.md`](./docs/DEVELOPMENT.md). Vietnamese version: [`docs/i18n/vi/DEVELOPMENT.md`](./docs/i18n/vi/DEVELOPMENT.md).
## Use Cases
- **Gameplay no-commentary channels** — the primary target. Default templates assume no voice-over and lean on visual hooks, music attribution, and timestamps.
- **Horror / scary-game channels** — the content-warning system is especially deep here (analog horror, liminal spaces, pursuit / chase, entity / SCP-style, body horror, etc.).
- **Demo / Early Access playthroughs** — dedicated video types and language-patch / game-version disclosure fields.
- **Speedrunners and 100% completionists** — playstyle disclosures, run-type metadata, and difficulty fields.
- **Solo creators tired of copy-paste** — profiles and presets exist specifically to eliminate repetitive data entry.
## Privacy & Offline-First
Nothing leaves your device. No analytics, no telemetry, no tracking. The web version stores your work in `localStorage`; the desktop version stores it in the OS application-data directory. Clearing site data (web) or uninstalling the app (desktop) wipes everything. Full details in [PRIVACY.md](./PRIVACY.md).
| **[Wiki](https://github.com/poli0981/youtube-generator/wiki)** | **User documentation** — quick start, glossary, every field and its limit, guardrails, troubleshooting, FAQ. Start here if you're using the app rather than building it. |
| [Architecture](./docs/ARCHITECTURE.md) | Layer model, data flow, engine design. |
| [Features](./docs/FEATURES.md) | Full feature matrix. |
| [Content Inventory](./docs/CONTENT-INVENTORY.md) | Every video type, genre, and content warning the editor surfaces. *(Also: [Vietnamese](./docs/i18n/vi/CONTENT-INVENTORY.md).)* |
| [Roadmap](./docs/ROADMAP.md) | Development phases. |
| [Tech Spec](./docs/TECH-SPEC.md) | Implementation details and configs. |
| [i18n Guide](./docs/I18N.md) | Adding new locales. |
PRs welcome — read [CONTRIBUTING.md](./CONTRIBUTING.md) first. Native-speaker corrections to AI-translated locales (JA / ES / KO / ZH) are especially appreciated.
## License
MIT
Licensed under the **[Apache License 2.0](./LICENSE)**. See [`NOTICE`](./NOTICE) for the copyright statement and [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md) for dependency licenses.
## AI Disclosure
This project was co-authored with **Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. Source code, locale translations, documentation, and CI workflows were generated or edited with AI assistance, then reviewed by the human maintainer (`@poli0981`) before being committed. See [DISCLAIMER.md](./DISCLAIMER.md) for the full disclosure.
These terms govern your use of YTDescGen — both the web version hosted at the project's GitHub Pages URL and any Tauri desktop binaries distributed under this project.
## License
YTDescGen is licensed under the **[Apache License 2.0](./LICENSE)**. You may use, modify, and redistribute it under those terms.
Apache 2.0 grants a patent license (Section 3) and an irrevocable copyright license (Section 2). It does **not** grant trademark rights — see Section 6 of the LICENSE.
## Acceptable Use
You may use YTDescGen for any lawful purpose. You may **not** use it to:
- Generate content that harasses, threatens, defames, or incites violence against any person or group.
- Generate content intended to mislead or impersonate (faked attribution, false sponsor disclosure, deepfake-adjacent metadata).
- Generate content that violates any third party's intellectual-property rights (including misleading copyright or licensing claims in descriptions).
- Distribute modified versions of YTDescGen in a way that violates Apache-2.0 — e.g. stripping copyright notices, omitting the NOTICE file, falsely indicating endorsement.
- Violate applicable law in your jurisdiction, including but not limited to **GDPR** (EU), **CCPA / CPRA** (California), **PIPL** (China), **LGPD** (Brazil), the **Vietnamese Cybersecurity Law**, or equivalent data-protection / cybercrime regulation in your country.
- Bypass YouTube's policies on metadata (misleading thumbnails / titles / tags) using the application.
## GitHub Terms
If you use the web version hosted on GitHub Pages, your use is also subject to:
- [GitHub's Terms of Service](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service)
- [GitHub's Acceptable Use Policies](https://docs.github.com/en/site-policy/acceptable-use-policies)
These apply alongside this document; in case of conflict, GitHub's policies govern the hosted artifact.
## No Warranty
See [DISCLAIMER.md](./DISCLAIMER.md) and `LICENSE` §§ 7–8. The software is provided **as-is** with no warranty of any kind, express or implied.
## Generated Content
YTDescGen produces text intended to be pasted into YouTube descriptions. **You — the operator pasting that text — are solely responsible for**:
- Confirming the generated description complies with [YouTube's Community Guidelines](https://www.youtube.com/howyoutubeworks/policies/community-guidelines/) and [YouTube's Terms of Service](https://www.youtube.com/static?template=terms).
- Disclosing paid promotions, sponsorships, and any AI-generated portions per YouTube's monetization and disclosure rules.
- Not including misleading information, copyright-infringing material, or any prohibited content listed in YouTube's policies.
- Truthful representation of run-type, difficulty, blind status, mod / cheat usage, and similar disclosures the application optionally exposes.
## Contributions
By submitting a contribution (issue, pull request, comment, locale translation, screenshot, log dump), you agree:
1. Your contribution is licensed under Apache 2.0, the same as the project.
2. You have the right to grant that license (you wrote it, or it's compatibly licensed and credited).
3. You will not include malicious code or knowingly vulnerable dependencies.
4. You will follow the [Code of Conduct](./CODE_OF_CONDUCT.md) and [Contributing Guide](./CONTRIBUTING.md).
Violations may result in your contribution being closed and, in severe cases, a permanent ban from the repository — see `CONTRIBUTING.md` § "Auto-ignored Contributions".
## Termination
These terms remain in effect for as long as you use the software. Your rights under Apache 2.0 are perpetual subject to that license's termination clauses (notably § 3 patent retaliation).
## Changes
Updates to these terms are committed under `TERMS.md` with the `Effective` date updated. Continued use of the software after a change constitutes acceptance.
YTDescGen incorporates the following third-party software. Each dependency retains its own license; consult the linked project page for the full text of each license.
## Runtime Dependencies (web bundle)
| Package | Version | License | Project |
| --- | --- | --- | --- |
| `react` | ^18.3.0 | MIT | <https://github.com/facebook/react> |
| `react-dom` | ^18.3.0 | MIT | <https://github.com/facebook/react> |
| `react-router-dom` | ^6.26.0 | MIT | <https://github.com/remix-run/react-router> |
| `react-i18next` | ^15.0.0 | MIT | <https://github.com/i18next/react-i18next> |
| `i18next` | ^23.15.0 | MIT | <https://github.com/i18next/i18next> |
| `zustand` | ^4.5.0 | MIT | <https://github.com/pmndrs/zustand> |
| `react-hot-toast` | ^2.4.0 | MIT | <https://github.com/timolins/react-hot-toast> |
| `tsx` | ^4.16.0 | MIT | <https://github.com/privatenumber/tsx> |
| `tailwindcss` | ^3.4.0 | MIT | <https://github.com/tailwindlabs/tailwindcss> |
| `prettier-plugin-tailwindcss` | ^0.6.0 | MIT | <https://github.com/tailwindlabs/prettier-plugin-tailwindcss> |
| `postcss` | ^8.5.14 | MIT | <https://github.com/postcss/postcss> |
| `autoprefixer` | ^10.4.0 | MIT | <https://github.com/postcss/autoprefixer> |
| `eslint` | ^9.0.0 | MIT | <https://github.com/eslint/eslint> |
| `@eslint/js` | ^9.0.0 | MIT | <https://github.com/eslint/eslint> |
| `eslint-plugin-react-hooks` | ^5.0.0 | MIT | <https://github.com/facebook/react> |
| `typescript-eslint` | ^8.0.0 | MIT | <https://github.com/typescript-eslint/typescript-eslint> |
| `prettier` | ^3.3.0 | MIT | <https://github.com/prettier/prettier> |
| `vitest` | ^3.2.4 | MIT | <https://github.com/vitest-dev/vitest> |
| `@testing-library/react` | ^16.0.0 | MIT | <https://github.com/testing-library/react-testing-library> |
| `@testing-library/jest-dom` | ^6.4.0 | MIT | <https://github.com/testing-library/jest-dom> |
| `@types/react` | ^18.3.0 | MIT | DefinitelyTyped |
| `@types/react-dom` | ^18.3.0 | MIT | DefinitelyTyped |
## Tauri Desktop (Rust crates)
| Crate | Version | License | Project |
| --- | --- | --- | --- |
| `tauri` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-build` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-plugin-dialog` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-fs` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-opener` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-shell` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-single-instance` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `serde` | ^1 | Apache-2.0 OR MIT | <https://github.com/serde-rs/serde> |
| `serde_json` | ^1 | Apache-2.0 OR MIT | <https://github.com/serde-rs/json> |
Transitive dependencies are not enumerated here. `cargo tree` (in `src-tauri/`) and `npm list --all` produce the exhaustive trees; this list covers the direct dependencies declared in `package.json` and `src-tauri/Cargo.toml`.
## Fonts & Icons
The application uses **system fonts** (`Inter` / `SF Pro` / `Segoe UI` / `Roboto`, fallback `sans-serif`). No custom font files are bundled in the web build.
Icons are provided by [`lucide-react`](https://github.com/lucide-icons/lucide) (ISC license — see above).
## AI-Assisted Development Disclosure
Per [`DISCLAIMER.md`](./DISCLAIMER.md), this project was co-authored with **Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. The model contributed to source code, locale translations, documentation, and CI configuration. All output was reviewed by the human maintainer (`@poli0981`) before being committed.
No third-party content was reproduced verbatim from the model's training data. Any external text quoted in this repository (notably the Apache License 2.0 in [`LICENSE`](./LICENSE) and the Contributor Covenant link in [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md)) is sourced from canonical public locations.
Claude is a product of Anthropic, PBC — <https://www.anthropic.com>. No license is granted by Anthropic to use this project; the Apache 2.0 license in `LICENSE` is granted by `@poli0981` as the project author.
## Reporting an Omission
If you believe a dependency is missing from this list, please open an issue or PR per [`CONTRIBUTING.md`](./CONTRIBUTING.md).
**Error pages (v0.27):**`components/errors/` holds a reusable `ErrorPage`
(404/403/419/500/offline/runtime) driven by the pure `config/error-pages.ts`
map. The dedicated error routes (`/403`, `/419`, `/500`, `/offline`, catch-all
`*`) are declared as **siblings of the `AppShell` route group** in `App.tsx`, so
they render full-screen with no Sidebar/Header. `ErrorPage` is router-agnostic
(hash anchors + `history.back()`) so the root `ErrorBoundary` — mounted outside
`HashRouter` in `main.tsx` — can reuse it as its crash fallback.
## 2. Core Engine Design
Engine module chứa toàn bộ logic generate — **zero framework dependency**. Mọi function đều pure: input → string.
@@ -253,13 +261,55 @@ Zustand Stores:
├───────────────────────────────────────────────┤
│ SettingsStore │
│ - theme: "dark" | "light" │
│ - defaultLanguage: SupportedLanguage │
│ - defaultGenre: Genre │
│ - autoSaveDraft: boolean │
│ Middleware: persist (localStorage) │
│ - appLanguage / defaultOutputLanguage │
│ - strictMode, settingsAccordionState (v12) │
│ - (flags: quality badge / copyright / ...) │
│ Middleware: persist (localStorage + file) │
├───────────────────────────────────────────────┤
│ PendingInvalidStore (0.35) │
│ - entries: Record<fieldId, PendingInvalid> │
│ Middleware: NONE — in-flight typing, not data │
└───────────────────────────────────────────────┘
```
### Settings → engine options
`renderAll` is called from three places (the Output hook, the multi-language
Output hook, BatchPage). Each used to hand-copy the same twelve settings fields
into an options object, and they had drifted — BatchPage's copy silently omitted
`splitContactEmail` and `showThirdPartyAds`, so Batch rendered a different
description than Output from identical data.
`src/hooks/use-render-options.ts` is now the single mapping, with two guards:
- **Compile-time** — `buildRenderOptions` builds a
`Required<SettingsRenderOptions>`, so omitting a key is a type error.
- **Runtime** — `tests/hooks/render-options-parity.test.ts` diffs the produced
keys against `SETTINGS_DERIVED_RENDER_KEYS` in both directions.
`RenderOptions` is split accordingly: `SettingsRenderOptions` (from the user)
plus `RenderOptionOverrides` (`tEn`, `bilingualContentBlocks` — decided per call
site, since Output wants bilingual content blocks and Batch does not).
### Validation state
Two sources, unioned by `useStrictBlock`, because neither alone is sufficient:
| Source | Catches | Why it's needed |
|---|---|---|
| `collectEditorIssues` (pure, over `EditorData`) | Saved values that fail validation | Bad data from imports — `ValidatedInput` refuses to commit invalid text, so imports are the main way it gets in |
| `PendingInvalidStore` | Typed text that is invalid and therefore **not** saved | Otherwise a field showing a red error is invisible to every gate, because the store behind it holds the last good value |
Both are filtered through `isRelevantIssueId`, so a field that isn't currently
shown (`adEmail` with split-email off, `zaloGroupLink` outside Vietnamese
output) can never block on a value with no visible input to fix it.
The first implementation registered issues from the inputs themselves and
cleared on unmount. It typechecked and had passing tests, and did nothing: the
fields live on the Editor page while the gates live on Batch / Social / Output,
so navigating away cleared every issue. Deriving from state removes the mount
coupling entirely.
## 4. i18n Architecture
```
@@ -278,6 +328,8 @@ i18n/locales/
**Adding a new language** = 2 JSON files + 1 line registration. See docs/I18N.md.
**Lazy loading (v0.26+)**: only English is bundled into the main chunk — it is the `fallbackLng` and the engine's bilingual `tEn` translator, both of which must resolve synchronously. Every other language is fetched on first use as a Vite async chunk via `i18next-resources-to-backend` + dynamic `import()`. Generation paths gate on bundle readiness (`useLanguagesReady` hook / `ensureLanguagesLoaded`): an unloaded language would otherwise silently render English fallback output. A chunk that fails to fetch degrades to English and logs to the in-app Log page — it never hangs the UI.
**UI language vs Output language**: These are independent. User can browse the app in English but generate descriptions in Japanese. UI language follows `SettingsStore.defaultLanguage`, output language follows `EditorStore.language`.
## 5. Desktop Packaging (Tauri)
@@ -313,7 +365,7 @@ Tauri advantages over Electron:
| What | How to Extend | Files to Touch |
|------|--------------|----------------|
| New language | Add `locales/{code}/ui.json` + `templates.json`, register in `i18n/index.ts` | 3 files |
| New language | Add `locales/{code}/ui.json` + `templates.json`, register in `SUPPORTED_LANGUAGES` (lazy-loaded automatically) | 3 files |
| New genre | Add entry to `config/genres.ts`, add tag pool to `engine/tag-generator.ts` | 2 files |
| New video type | Add to `config/video-types.ts`, add patterns to all `templates.json` | 1 + N locale files |
| New platform/store | Add entry to `config/platforms.ts` | 1 file |
A static manifest of every video type, game genre, and content warning surfaced in YTDescGen's editor. Maintained manually — when adding a new option to one of the source files below, **add a row here too** in the same PR.
This file exists for **transparency** — anyone curious about what the editor can describe (without installing the app or reading the source) can scan it in one minute.
Each video type drives a dedicated description template + title structure + tag bias. The "Extra fields" column lists fields the editor reveals when this type is selected.
| Icon | Type | Extra fields |
|---|---|---|
| 🎮 | Full Gameplay | — |
| 📂 | Gameplay Part | Part Number |
| 🎬 | Full Demo | — |
| 🎞 | Demo Part | Part Number |
| 👹 | Boss Fight | Boss Name |
| 💀 | Boss No Hit | Boss Name |
| 🏁 | Ending / All Endings | — |
| ⚡ | Speedrun | — |
| 💯 | 100% Completion | — |
| 📦 | DLC Content | DLC Name |
| 🔄 | New Game+ | — |
| 🏆 | Challenge Run | Challenge Name |
| 📌 | Side Quests | — |
| 🔍 | Secrets / Hidden | — |
| ⚖️ | Graphics Comparison | — |
| 📘 | Silent Guide | — |
| 🧩 | Modded Gameplay | Mod Name |
| ⭐ | All Collectibles | — |
| 🔴 | Livestream | Live URL, Scheduled Time |
| 🎴 | Gacha Quest | Quest Type, Chapter Name, Quest Name, Part Number |
---
## 2. Game genres (41)
Selected genres feed the title format, the tag pool, and (when configured in Settings → Genre Playlists) the pinned-comment recommendation.
Bulk-select groups available in the editor: **All RPGs** (rpg + jrpg + action_rpg + crpg), **All Shooters** (fps + arena_shooter + tactical_fps + boomer_shooter + extraction_shooter + shmup), **All Horror** (horror + survival_horror + psychological_horror).
| Icon | Genre |
|---|---|
| ⚔️ | Action / Adventure |
| 🗡 | Hack & Slash |
| 👊 | Beat 'em Up |
| 🦘 | Platformer |
| 👻 | Horror / Survival |
| 🧟 | Survival Horror |
| 🧠 | Psychological Horror |
| 🛡 | RPG |
| 🎎 | JRPG |
| 🏹 | Action RPG |
| 📜 | CRPG / Isometric |
| 🔫 | FPS / Shooter |
| 🎯 | Arena Shooter |
| 🎖 | Tactical FPS |
| 💥 | Boomer Shooter |
| 🎒 | Extraction Shooter |
| 🛸 | SHMUP / Bullet Hell |
| 🌍 | Open World / Sandbox |
| 🕹 | Indie |
| 💀 | Souls-like |
| 🏎 | Racing / Sports |
| 📖 | Story / Narrative |
| 🏗 | Simulation / Strategy |
| 🏙 | City Builder |
| 🥊 | Fighting |
| 🥷 | Stealth / Espionage |
| ⛏ | Survival / Crafting |
| 🎲 | Roguelike / Roguelite |
| 🗺 | Metroidvania |
| 🌐 | MMO / Online |
| 🎵 | Rhythm / Music |
| 🧩 | Puzzle |
| 🏰 | Tower Defense |
| 🃏 | Card Game |
| 🎴 | Deck Builder |
| 🤖 | Auto Battler |
| 🏆 | Battle Royale |
| ♟ | Tactical / Turn-based |
| 🚀 | Space / Sci-Fi |
| 🌾 | Farming / Life Sim |
| 🎬 | FMV / Interactive Movie |
| 💬 | Visual Novel |
---
## 3. Content warnings (248, grouped)
Selected warnings are appended to a `⚠ CONTENT WARNINGS` block in the description, ahead of timestamps. Each group is collapsible in the editor; warnings render in description order = user's selection order.
Blind playthrough · No spoilers in chat · Casual / story mode · Hardcore / max difficulty · Permadeath / Iron Man · Speedrun attempt · 100% completionist · Still learning mechanics · First time playing · Returning / NG+
### Gameplay disclosure (5)
Mods used · Cheats / debug · Glitches used · Guide-assisted · Educational / PSA purpose
---
## 4. Maintenance
When adding a new item to any of the source files:
1.**Video types** → append to [`src/config/video-types.ts`](../src/config/video-types.ts) AND add a row in section 1 above.
2.**Genres** → append to [`src/config/genres.ts`](../src/config/genres.ts) AND add a row in section 2.
3.**Content warnings** → append to the relevant group in [`src/config/content-warning-groups.ts`](../src/config/content-warning-groups.ts) AND add the label to the right group in section 3 — keep the group count in the heading accurate.
4. Update the Vietnamese mirror at [`docs/i18n/vi/CONTENT-INVENTORY.md`](./i18n/vi/CONTENT-INVENTORY.md) in the same PR.
Mismatch between this file and the source files is treated as a documentation bug — open an issue or PR.
This guide covers setting up YTDescGen for local development on Windows, macOS, or Linux. The application is a Vite/React web app with an optional Tauri desktop shell.
## Reference Workstation
The reference workstation used to develop and ship this project:
| Component | Spec |
| --- | --- |
| OS | Windows 11 Pro (24H2 or newer) |
| CPU | Modern x86-64 — 6+ cores with AVX2 (Intel 11th-gen / AMD Zen 3 or newer) |
| GPU | Discrete or integrated — Tauri's WebView2 backend runs fine on iGPU |
| RAM | 16 GB minimum, 32 GB recommended for parallel typecheck + dev server |
| Storage | 5 GB free for `node_modules` + Cargo `target/` after a full Tauri build |
| Display | 1920×1080 minimum; mobile-responsive layout tested down to 360×640 |
macOS and Linux work for development. Tauri release builds are cross-compiled or run on dedicated CI runners — see [PACKAGING.md](./PACKAGING.md).
## Toolchain
Install in this order:
| Tool | Version | Why |
| --- | --- | --- |
| **Node.js** | `>= 22.12.0` | Vite 8 requires Node `^20.19` or `>= 22.12`. Use [nvm](https://github.com/nvm-sh/nvm) or [fnm](https://github.com/Schniz/fnm). |
| **npm** | bundled with Node 22 | The project uses npm; `pnpm` and `yarn` are not tested. |
| **Rust** | stable, `>= 1.78` | Required for the Tauri desktop build. Install via [rustup](https://rustup.rs/). |
| **Python** | `3.12` | Optional — only needed for some Tauri platform tooling on Windows. |
| **Tauri prerequisites** | per OS | See <https://v2.tauri.app/start/prerequisites/>. |
### Windows specifics
- Install **Visual Studio Build Tools 2022** with the "Desktop development with C++" workload (required by `tauri-build`).
- Install the **WebView2 Runtime** (usually pre-installed on Windows 11).
- Long path support: `git config --global core.longpaths true`.
### macOS specifics
- Install Xcode Command Line Tools: `xcode-select --install`.
### Linux specifics
- Install per-distro Tauri prerequisites — `libwebkit2gtk-4.1-dev`, `libappindicator3-dev`, etc. See the Tauri docs linked above.
## IDE Setup
The reference workflow uses **JetBrains 2026.x** IDEs (WebStorm or RustRover) as primary, with **VS Code** for quick edits.
| `npm run dev` | Vite dev server, hot reload, web only. |
| `npm run build` | Production web bundle into `dist/`. |
| `npm run preview` | Serve the production bundle for sanity-testing. |
| `npm run typecheck` | `tsc --noEmit` over `src/` — what Vite actually builds. |
| `npm run typecheck:all` | Same, plus `tests/` and `scripts/`, which the base config deliberately excludes. Added in v0.35.0 after it turned out they had **never** been type-checked — and immediately found three fields silently missing from the editor→engine parity fixture. |
| `npm run lint` | ESLint. Use `npm run lint:fix` to autofix. |
| `npm run format` | Prettier write across `src/`, `tests/`, `scripts/`. |
| `npm run format:check` | Same, read-only. CI gate. Markdown and the locale JSON are deliberately out of scope — Prettier reflows prose and expands the schema's compact arrays by ~1600 lines for no benefit. |
| `npm run knip` | Dead-code / unused-dependency check. CI gate. |
| `npm run check:version` | Asserts all **six** version fields agree (`package.json`, both `package-lock.json` entries, `tauri.conf.json`, `Cargo.toml`, `Cargo.lock`). The only thing that notices a missed one. |
| `npm run test` | Vitest watch mode. |
| `npm run test:run` | Vitest single-run (for CI / pre-commit). |
| `npm run test:coverage` | Coverage report into `coverage/`. |
| `npm run validate:locales` | Enforces all 6 locales match `_schema.json` exactly. **Must pass before any locale-touching PR merges.** |
| `npm run generate:locale` | Scaffold a locale from the English source. `--lang <code>`, plus optional `--copy-english` / `--force`. (Advertised since v0.1 but only actually written in v0.35.0.) |
| `npm run tauri:dev` | Tauri desktop in dev mode (auto-restarts on Rust or frontend changes). |
| `npm run tauri:build` | Tauri release binary for the current platform. |
## Tauri Desktop Build
See [PACKAGING.md](./PACKAGING.md) for the full release pipeline. Quick local build:
The first build takes ~5–10 minutes (cold Cargo cache). Subsequent builds are incremental.
## Troubleshooting
### `validate:locales` fails after adding a key
You forgot to update `src/i18n/locales/_schema.json`. The schema is the source of truth; locales must match it exactly.
### Tauri build fails with `link.exe not found` (Windows)
Install Visual Studio Build Tools 2022 + Desktop C++ workload, then restart your shell so the new PATH is picked up.
### Tauri build fails with `pkg-config not found` (Linux)
Install the per-distro Tauri prerequisites listed at <https://v2.tauri.app/start/prerequisites/>.
### `npm install` is slow or hangs
Disable corporate VPNs / proxies that block the npm registry. The lock file is committed; offline installs work after one successful online install.
### Hot reload not picking up locale edits
Locale JSON is bundled at build time, not watched. Restart the dev server after editing `src/i18n/locales/*`.
Since v0.26, only English ships in the main chunk; the other languages are
lazy-loaded async chunks fetched on first use (see `src/i18n/index.ts` and
docs/I18N.md). The restart advice above still applies to all of them.
### Pre-commit hook fails on `validate:locales` but I didn't touch locales
You probably added a new key to `_schema.json` indirectly via the engine types (`src/engine/types.ts` → `CONTENT_WARNINGS`). New IDs require translations in all 6 locales.
## See Also
- [ARCHITECTURE.md](./ARCHITECTURE.md) — layer model, data flow, engine design.
- [I18N.md](./I18N.md) — adding new languages step-by-step.
- [PACKAGING.md](./PACKAGING.md) — Tauri release builds and signing.
Three independent mechanisms. The first two are always on.
| Mechanism | Scope |
|---|---|
| **Character limits** | Title 100 / description 5,000 / tags 500. If **any one** is over, **no** field can be copied — on Output and Batch. Batch scopes per part; Copy All Batch blocks if any part is over |
| **Field limits** | Hard `maxLength` per category: URL 200, email 320, short name 100, label 300, long text 2,000, timestamps 5,000, numeric 10. Imported values are clamped too |
| **Strict Mode** | Opt-in. Blocks Generate / Copy / Export on hard errors only; warnings (e.g. a working link on a non-standard prefix) never block. Log export is exempt |
Emails are capped at **three per field**, enforced on the increase so an
over-cap legacy value stays editable. Invalid input is never committed to the
store, so a malformed URL cannot reach the generated description whether Strict
Mode is on or off.
## 🖥 Desktop App Features (Tauri)
@@ -266,6 +276,58 @@ interface HistoryEntry {
| Offline | Full functionality without internet |
| Global Hotkey | System-wide hotkey to open app (optional) |
## 📱 Android App (v0.29)
An installable, sideloadable `.apk` built from the same Tauri 2 codebase — no
separate mobile project. Build with `cargo tauri android build --apk`; see
(no Sidebar/Header), with Home / Back / (Reload) / Report-a-bug actions.
- **Non-blocking offline banner** — a dismissible bottom strip; the app stays
fully usable offline, and a toast confirms when the connection returns.
## ⚖️ Legal & Consent (v0.28)
A first-run **consent gate** (`src/components/ConsentGate.tsx`, backed by the
pure `src/config/legal.ts`) blocks the app until the user reviews the legal
documents and ticks one "I agree" checkbox.
| Aspect | Behaviour |
|--------|-----------|
| Documents | Terms of Use, Privacy Policy, Disclaimer, License — linked to the GitHub-hosted copies (open in the browser); also surfaced in About → Legal |
| Acceptance | One combined checkbox; Continue disabled until checked |
| Persistence | Stored in the existing settings record (`legalConsentVersion` + timestamp) — **no cookie, no new storage key** |
| Re-prompt | Version-based — only when `CURRENT_TERMS_VERSION` is raised (terms changed); also re-shows in fresh / incognito storage |
| Desktop | Same in-app gate on Windows/macOS/Linux, **plus** a license-acceptance page in the Windows MSI/NSIS installer (`bundle.licenseFile`) |
The live workflow lives at [.github/workflows/release-desktop.yml](../.github/workflows/release-desktop.yml). Pushing a `v*` tag (e.g. `v0.10.0`) triggers a three-platform matrix build (Windows, macOS ARM, Linux) and uploads each installer to a single draft GitHub Release named `YTDescGen v__VERSION__`. Publish the draft manually after smoke-testing the binaries.
Linux runners install `libwebkit2gtk-4.1-dev`, `libgtk-3-dev`, `libayatana-appindicator3-dev`, `librsvg2-dev`, and `patchelf` before building — Tauri's webview + AppImage tooling needs these.
`fail-fast: false` keeps the other platforms going if one breaks. The `bundleArgs` matrix field is concatenated with `--target ${{ matrix.target }}` and passed through to `tauri build`.
**macOS notes (v0.9.1+):**
- **DMG bundling is skipped** (`--bundles app`). Tauri's DMG bundler runs an AppleScript that flakes intermittently on hosted macOS runners (the headless display can't load Finder fast enough for `osascript` to position icons), so we ship a `.app.tar.gz` instead. Users expand the archive and drag the `.app` into `/Applications`.
- **Intel macOS (`macos-13`) is NOT built.** GitHub started deprecating the `macos-13` free runner pool in 2025; jobs queue indefinitely. If Intel support becomes a priority, switch the macos-14 entry's target to `universal-apple-darwin` (Tauri builds both archs and lipos them into one universal binary) — the runner already has the toolchain capacity.
**Code signing is intentionally skipped** for both Windows and macOS — this is an open-source personal tool, and signing certificates carry recurring cost. End users will see the standard "unverified publisher" / "unidentified developer" prompts on first launch. Document the bypass steps in the release notes if needed.
**Auto-changelog** (`git-cliff`) is out of scope; release notes come from the tag's annotated message via the default `tauri-action` behaviour. CHANGELOG.md is hand-maintained.
**Manual re-run:** the workflow accepts `workflow_dispatch` with a `tag` input — `gh workflow run release-desktop.yml -f tag=v0.9.0` rebuilds an existing release without deleting + recreating the tag. Useful when a transient runner failure costs a single arch's binary.
**Backfill for pre-workflow tags:**`v0.8.0` and `v0.8.1` predate the multi-platform matrix and only have local Windows builds. To attach binaries retroactively, build manually then `gh release create v0.8.0 --notes-file CHANGELOG.md path/to/*.msi …`.
## Android (.apk) Packaging
YTDescGen also builds an installable Android APK from the **same** Tauri 2
codebase — there is no separate mobile project. Tauri 2 ships Android support;
the crate is already `cdylib`/`staticlib` with a `#[cfg_attr(mobile, …)]` entry
point, and the Android launcher icons live in `src-tauri/icons/android/`. The
desktop-only tray / single-instance / hide-to-tray logic in `src-tauri/src/lib.rs`
is gated behind `#[cfg(desktop)]` so the library compiles for Android.
### Requirements & tested versions
| | |
|---|---|
| **Minimum OS** | **Android 11** (API level 30, `minSdk 30`). The APK will not install below this. |
| **Tested** | **Android 11 → 16.** The v0.29.0 build was verified on Android emulators across this range **and on a real device running Android 12** (the maintainer's phone). |
Where the value lives: `bundle.android.minSdkVersion` in
[`src-tauri/tauri.conf.json`](../src-tauri/tauri.conf.json) is the source of
truth used by `tauri android init`; the generated
`gen/android/app/build.gradle.kts` carries the baked `minSdk = 30` — edit that
directly if you change the floor without re-running `init`.
**Why Android 11 is the floor (rationale):**
- **Coverage.** Android 11+ accounts for the large majority of active devices in
2026 (Android 14/15 alone are the two biggest slices, and 11–13 together still
hold a sizeable share). Going lower buys few extra users at growing compat cost.
- **A modern, patched WebView.** The app renders entirely in the system WebView,
whose minimum is Android 10. On Android 11+ the WebView auto-updates via Google
Play, so the rendering/JS engine stays current and patched. This is exactly why
the **real-device test on Android 12 worked**, while a *stale* Android-12
emulator stuck on WebView 91 showed a black screen (the `crypto.randomUUID`
boot crash) — that class of bug is fixed in v0.29.0 and is moot on an
up-to-date WebView.
- **Security upkeep.** Even though Google's *OS-level* monthly security bulletins
for Android 11–13 have ended (Android 12 in 2025, Android 13 in early 2026),
Android 11+ keeps receiving security updates for the components that matter to a
sandboxed WebView app: Google Play system updates (Project Mainline), Google
Play services, and System WebView. Requiring strict OS-bulletin support would
mean Android 14+, which would drop more than half of users.
### Prerequisites
- **Android SDK** — platform-tools, a platform (e.g. `android-34`/`android-36`), build-tools. Install via Android Studio or the command-line tools.
- `--apk` produces an APK. **Without it Tauri builds an `.aab`** App Bundle for the Play Store, which cannot be sideloaded.
- `cargo tauri android build --apk --target aarch64` builds an arm64-only APK (smaller download; covers virtually all modern phones).
- The build runs `npm run build` first (the `beforeBuildCommand`), then Gradle. The first build takes several minutes (Rust × up to 4 ABIs + a cold Gradle).
- For on-device iteration with hot reload: `cargo tauri android dev`.
Install on a device: copy the APK over (or `adb install -r <apk>`) and enable
builds and signs the APK on a `v*` tag (or `workflow_dispatch`) and attaches it
to the same draft GitHub Release as the desktop binaries. It needs four repo
secrets:
| Secret | Value |
|---|---|
| `ANDROID_KEYSTORE_BASE64` | base64 of the `.jks` (`base64 -w0 ytdescgen-release.jks`) |
| `ANDROID_STORE_PASSWORD` | keystore store password |
| `ANDROID_KEY_PASSWORD` | key password |
| `ANDROID_KEY_ALIAS` | `ytdescgen` |
### App-level changes for Android
- **`src-tauri/src/lib.rs`** — tray / single-instance / hide-to-tray / exit-prevention are `#[cfg(desktop)]`; the dialog/fs/opener/shell plugins and the six file commands run on every platform.
- **`src-tauri/Cargo.toml`** — `tauri-plugin-single-instance` lives in a desktop-only `[target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies]` table.
- **`src/utils/platform.ts` / `file-ops.ts`** — `IS_MOBILE` routes file export through the WebView blob download on Android (the native save dialog is unreliable under scoped storage). Settings persist via `appDataDir()` (app-private storage) **and** localStorage, both of which work on Android.
Bản kê khai tĩnh cho mọi loại video, thể loại game, và cảnh báo nội dung trong editor của YTDescGen. Cập nhật thủ công — khi thêm mục mới vào một trong các file nguồn dưới đây, **thêm dòng tương ứng vào đây** trong cùng PR.
File này tồn tại để **minh bạch** — bất kỳ ai tò mò về việc editor có thể mô tả được gì (mà không cần cài app hay đọc source) đều có thể quét trong một phút.
**Bản gốc tiếng Anh:** [`docs/CONTENT-INVENTORY.md`](../../CONTENT-INVENTORY.md).
**Nguồn tham chiếu (source of truth):**
- Loại video: [`src/config/video-types.ts`](../../../src/config/video-types.ts)
- Thể loại game: [`src/config/genres.ts`](../../../src/config/genres.ts)
Mỗi loại video kéo theo một template description, cấu trúc title, và tag bias riêng. Cột "Trường bổ sung" liệt kê các trường editor sẽ hiển thị khi chọn loại video tương ứng.
| Icon | Loại | Trường bổ sung |
|---|---|---|
| 🎮 | Gameplay đầy đủ | — |
| 📂 | Gameplay theo phần | Số phần |
| 🎬 | Demo đầy đủ | — |
| 🎞 | Demo theo phần | Số phần |
| 👹 | Đấu trùm | Tên trùm |
| 💀 | Đấu trùm không trúng đòn | Tên trùm |
| 🏁 | Kết thúc / Toàn bộ Ending | — |
| ⚡ | Speedrun | — |
| 💯 | Hoàn thành 100% | — |
| 📦 | Nội dung DLC | Tên DLC |
| 🔄 | New Game+ | — |
| 🏆 | Thử thách | Tên thử thách |
| 📌 | Nhiệm vụ phụ | — |
| 🔍 | Bí mật / Ẩn | — |
| ⚖️ | So sánh đồ họa | — |
| 📘 | Hướng dẫn không lời | — |
| 🧩 | Chơi với Mod | Tên Mod |
| ⭐ | Toàn bộ vật phẩm sưu tầm | — |
| 🔴 | Livestream | URL Live, Thời gian dự kiến |
| 🎴 | Nhiệm vụ Gacha | Loại nhiệm vụ, Tên chapter, Tên quest, Số phần |
---
## 2. Thể loại game (41)
Thể loại được chọn ảnh hưởng đến định dạng title, tag pool, và (khi cấu hình ở Settings → Genre Playlists) gợi ý playlist trong pinned comment.
Cảnh báo được chọn sẽ thêm vào khối `⚠ CONTENT WARNINGS` trong description, trước phần timestamp. Mỗi nhóm có thể thu gọn trong editor; cảnh báo hiển thị theo thứ tự người dùng chọn.
Hiệu ứng chớp sáng · Say game / camera nhanh · Có thể đau nửa đầu · Đèn nhấp nháy · Rung màn hình mạnh · Loé sáng / lens flare · Bloom quá đà / sáng cháy · Hiệu ứng hạt dày đặc · HUD / overlay nhấp nháy · Màu sắc quá rực / loè loẹt · Motion blur nặng · Depth of field gắt · Post-processing đậm đặc
### Âm thanh / Cảm âm (13)
Âm thanh đột ngột · Âm chói tai / tần số cao · Jumpscare bằng âm thanh · Thay đổi âm lượng đột ngột · Âm thanh méo / vỡ · Tiếng ken két / kim loại · Tiếng cao kéo dài · Lỗi âm thanh / glitch · Bass nặng / sub-bass rung · Tiếng la hét kéo dài · Tiếng kính vỡ / va đập · Tạp âm mic / tiếng thở · Tiếng nhiễu / tĩnh điện
### Lời thoại / Ngôn từ (10)
Văng tục dày đặc · Lời thoại ẩn ý t*nh d*c · Lời thoại kích động · Lăng mạ / sỉ nhục bằng lời · Lời đe dọa / uy hiếp · Từ ngữ miệt thị / xúc phạm · Hài thô tục · Hài người lớn · Hài đen / u tối · Nhắc đến chất kích thích / đồ có cồn
### Ám ảnh / Phobia (56)
Jumpscare · Sợ độ cao (acrophobia) · Sợ lỗ / cụm (trypophobia) · Sợ nước sâu (thalassophobia) · Sợ không gian kín (claustrophobia) · Sợ nhện (arachnophobia) · Sợ côn trùng (entomophobia) · Sợ rắn (ophidiophobia) · Sợ chó (cynophobia) · Sợ bóng tối (nyctophobia) · Sợ lửa (pyrophobia) · Sợ búp bê (pediophobia) · Sợ máu (hemophobia) · Sợ chú hề (coulrophobia) · Sợ chết đuối (ablutophobia) · Sợ bị chôn sống (taphophobia) · Hình nhân máy (automatonophobia) · Vật thể khổng lồ (megalophobia) · Vật nhân tạo dưới nước (submechanophobia) · Xác chết (necrophobia) · Ma quỷ (spectrophobia) · Quỷ dữ (demonophobia) · Cá mập (selachophobia) · Vi trùng / ô nhiễm (mysophobia) · Nôn mửa (emetophobia) · Bị nhìn chằm chằm (scopophobia) · Cô lập (monophobia) · Chuột (musophobia) · Dơi (chiroptophobia) · Chim (ornithophobia) · Cá (ichthyophobia) · Bò sát (herpetophobia) · Gián (katsaridaphobia) · Ong (apiphobia) · Sấm sét (astraphobia) · Không gian rộng (agoraphobia) · Đám đông (enochlophobia) · Tuyết / giá lạnh (chionophobia) · Bệnh viện (nosocomephobia) · Vật sắc nhọn (aichmophobia) · Nghẹt thở (pnigophobia) · Sương mù (homichlophobia) · Lốc xoáy / bão (lilapsophobia) · Mưa lớn (ombrophobia) · Mây / trời u ám (nephophobia) · Gió mạnh (ancraophobia) · Cực lạnh (cryophobia) · Ánh nắng gay gắt (heliophobia) · Sóng lớn (cymophobia) · Hồ / nước tĩnh (limnophobia) · Sông / dòng chảy (potamophobia) · Sợ màu sắc / cảnh màu chói (chromophobia) · Sợ màu đỏ / cảnh toàn đỏ (erythrophobia) · Sợ màu vàng (xanthophobia) · Sợ màu trắng / không gian toàn trắng (leukophobia) · Sợ màu đen (melanophobia)
### Sức khỏe tâm thần (17)
Cảnh gây lo âu · Trầm cảm · Rối loạn ăn uống · Sử dụng chất kích thích · Tự hại / tự tử · PTSD · Kim tiêm · Dịch cơ thể · Mang thai / sinh nở kinh dị · Bệnh tật / nhiễm trùng · Lưỡng cực · OCD · Hoảng loạn · Phân ly · Hoang tưởng · Suy nghĩ xâm nhập · Y khoa kinh dị
### Hiện tượng tâm lý — xã hội (22)
Tự kỷ / thần kinh đa dạng · ADHD / rối loạn tập trung · Hikikomori / ẩn dật xã hội · NEET (không học không làm) · Lo âu xã hội · Cô lập xã hội / cô đơn · Tâm thần phân liệt / loạn thần · Burnout / kiệt sức · Mặc cảm sống sót · Bị bỏ rơi / sang chấn · Quan hệ parasocial · Gaslighting / thao túng · Hội chứng Stockholm · Nghiện game / cờ bạc · Khủng hoảng hiện sinh · Hội chứng kẻ mạo danh · Khủng hoảng tuổi trung niên · Khủng hoảng tuổi 1/4 · Quấy rối nơi làm việc · Áp lực vai trò giới · Miệt thị ngoại hình (body shaming) · Chuẩn mực ngoại hình phi thực tế
### Internet / Đời sống số (18)
Bắt nạt / quấy rối qua mạng · Doxxing / phơi bày thông tin cá nhân · Trolling / phá game · Văn hóa tẩy chay / bêu rếu công khai · Nghiện mạng xã hội · Lướt tin tiêu cực vô độ (doomscrolling) · Hội chứng sợ bỏ lỡ (FOMO) · Tin giả / thông tin sai lệch · Lừa đảo trực tuyến / phishing · Giả mạo danh tính trên mạng (catfishing) · Deepfake / nội dung giả mạo bằng AI · Theo dõi / rình rập qua mạng · Trào lưu / thử thách nguy hiểm trên mạng · Văn hóa influencer / câu tương tác · Cực đoan hóa qua mạng / buồng vang thông tin · Loot box / cơ chế gacha · Chủ đề AI / trí tuệ nhân tạo · Riêng tư dữ liệu / giám sát diện rộng
### Nội dung nhạy cảm / 18+ (66)
Máu me · 18+ · Trang phục hở hang · Kh*a th*n một phần · Tạo hình nhân vật bị t*nh d*c hóa · Yếu tố fan service · Tư thế / góc quay gợi cảm · Hình ảnh gây khó chịu · B*o h*nh động vật · Trẻ em chịu tác động · B*o h*nh gia đình · Tham chiếu x*m h*i t*nh d*c · Tra tấn · Tôn giáo · Tác động vật lý chiến tranh · Phân biệt đối xử · Tác động vật lý từ chính quyền · Hút thuốc / uống rượu · G*ết người chi tiết · Tà giáo / huyền bí · Thao túng tâm lý · Mất mát / đau buồn · Bắt cóc · Phát ngôn thù hận · Tội ác lịch sử · Nô lệ · Khủng bố · Bắt nạt · Thử nghiệm trên người · Ăn thịt người · Hạt nhân / phóng xạ · Kỳ thị người đồng tính / LGBTQ+ (homophobia) · Kỳ thị người chuyển giới (transphobia) · Bài ngoại (xenophobia) · Cực đoan chính trị · Cực đoan tôn giáo / cuồng tín · Diệt chủng / thanh trừng sắc tộc · Thánh chiến / xung đột tôn giáo · Đại nạn Holocaust · Nội chiến · Xả súng hàng loạt / xả súng trường học · Chủ nghĩa thực dân / đế quốc · Tuyên truyền nhà nước · Nhà nước giám sát / dystopia · Thuyết âm mưu · Kiểm duyệt / cấm phát ngôn · Xung đột sắc tộc / chủng tộc · Khủng hoảng tị nạn · Cách mạng / nổi dậy · Ám sát chính trị · Đảo chính · Toà án dị giáo / săn phù thủy · Lao động cưỡng bức · Chủ nghĩa dân tộc cực đoan · Treo c* / siết c* · Cảnh ch*t đuối · Cảnh thiêu s*ng · Cảnh ngạt th* · Bị trói / cầm tù tra tấn · Cảnh hành quyết công khai · Cảnh chặt đầu · Cảnh đâm xuyên cơ thể · Thương vong hàng loạt · Tác động vật lý bằng phương tiện · Cảnh sử dụng quá liều · Ngã / nhảy từ trên cao
### Kinh dị nặng (12)
Mắt / cụm mắt · Body horror (biến dạng cơ thể) · Mặt biến dạng / cắt xén · Kinh dị vũ trụ · Máu me / phân thây cực độ · Phân hủy, thối rữa, dòi bọ · Cắt xẻo / cụt chi · Liminal space · Analog horror / VHS · Phi thực tế / méo mó · Truy đuổi · Thực thể / SCP
### Thông tin về playstyle (10)
Lần đầu chơi (blind) · Không spoiler trong chat · Chế độ easy / story · Chế độ khó cao · Permadeath / Iron Man · Thử speedrun · 100% completionist · Đang học cơ chế · Chơi lần đầu · Chơi lại / NG+
### Thông tin về gameplay (5)
Dùng mod · Bật cheat / debug · Dùng glitch · Có guide hỗ trợ · Game mục đích giáo dục / tuyên truyền
---
## 4. Bảo trì
Khi thêm mục mới vào bất kỳ file nguồn nào:
1.**Loại video** → thêm vào [`src/config/video-types.ts`](../../../src/config/video-types.ts) VÀ thêm dòng vào mục 1 ở trên.
2.**Thể loại** → thêm vào [`src/config/genres.ts`](../../../src/config/genres.ts) VÀ thêm dòng vào mục 2.
3.**Cảnh báo nội dung** → thêm vào nhóm phù hợp ở [`src/config/content-warning-groups.ts`](../../../src/config/content-warning-groups.ts) VÀ thêm label vào đúng nhóm ở mục 3 — giữ số đếm trong tiêu đề chính xác.
4. Cập nhật cả bản gốc EN tại [`docs/CONTENT-INVENTORY.md`](../../CONTENT-INVENTORY.md) trong cùng PR.
Sai lệch giữa file này và file nguồn được xem là lỗi tài liệu — mở issue hoặc PR.
> **Lưu ý dịch thuật:** Tiếng Anh là phiên bản chính ([`docs/DEVELOPMENT.md`](../../DEVELOPMENT.md)). Bản tiếng Việt này có thể chậm cập nhật một vài commit.
Hướng dẫn này bao gồm cách cài đặt YTDescGen để phát triển cục bộ trên Windows, macOS hoặc Linux. Ứng dụng là một web app Vite/React với tùy chọn vỏ desktop Tauri.
## Cấu hình máy tham chiếu
Cấu hình máy đã dùng để phát triển và phát hành dự án:
| Thành phần | Thông số |
| --- | --- |
| OS | Windows 11 Pro (24H2 trở lên) |
| CPU | x86-64 hiện đại — 6 nhân trở lên có AVX2 (Intel gen 11 / AMD Zen 3 hoặc mới hơn) |
| GPU | Rời hoặc tích hợp — backend WebView2 của Tauri chạy thoải mái trên iGPU |
| RAM | Tối thiểu 16 GB, khuyến nghị 32 GB để chạy song song typecheck + dev server |
| Lưu trữ | 5 GB trống cho `node_modules` + `target/` Cargo sau khi build Tauri đầy đủ |
| Màn hình | Tối thiểu 1920×1080; layout mobile đã test đến 360×640 |
macOS và Linux đều dùng được để phát triển. Build release Tauri được cross-compile hoặc chạy trên CI riêng — xem [PACKAGING.md](../../PACKAGING.md).
## Toolchain
Cài theo thứ tự:
| Công cụ | Phiên bản | Lý do |
| --- | --- | --- |
| **Node.js** | `>= 22.12.0` | Vite 8 yêu cầu Node `^20.19` hoặc `>= 22.12`. Dùng [nvm](https://github.com/nvm-sh/nvm) hoặc [fnm](https://github.com/Schniz/fnm). |
| **npm** | đi kèm Node 22 | Dự án dùng npm; `pnpm` và `yarn` chưa test. |
| **Rust** | stable, `>= 1.78` | Bắt buộc cho build Tauri. Cài qua [rustup](https://rustup.rs/). |
| **Python** | `3.12` | Tùy chọn — chỉ cần cho một số tooling Tauri trên Windows. |
| **Tauri prerequisites** | theo OS | Xem <https://v2.tauri.app/start/prerequisites/>. |
### Windows
- Cài **Visual Studio Build Tools 2022** với workload "Desktop development with C++" (bắt buộc cho `tauri-build`).
- Cài **WebView2 Runtime** (Windows 11 thường đã có sẵn).
- Bật long path: `git config --global core.longpaths true`.
### macOS
- Cài Xcode Command Line Tools: `xcode-select --install`.
### Linux
- Cài Tauri prerequisites theo từng distro — `libwebkit2gtk-4.1-dev`, `libappindicator3-dev`, v.v. Xem docs Tauri ở link trên.
## Cấu hình IDE
Quy trình tham chiếu dùng **JetBrains 2026.x** (WebStorm hoặc RustRover) làm IDE chính, **VS Code** cho chỉnh sửa nhanh.
> **Lưu ý dịch thuật:** Tiếng Anh là phiên bản chính ([`DISCLAIMER.md` ở root](../../../DISCLAIMER.md)). Bản tiếng Việt này có thể chậm cập nhật một vài commit.
## Dự án cá nhân, có sự hỗ trợ của AI
YTDescGen là dự án cá nhân do một người duy trì (`@poli0981`) để dùng cho kênh YouTube [`@SkullMute`](https://www.youtube.com/@SkullMute), và chia sẻ công khai dưới dạng mã nguồn mở. Đây **không phải sản phẩm thương mại** và không có nghĩa vụ hỗ trợ.
Mã nguồn, tài liệu, bản dịch locale, và các quyết định thiết kế trong repo này được **đồng tác giả với sự hỗ trợ của Anthropic's Claude Code (model 4.7 Opus, cửa sổ context 1M)**. Tất cả commit, release, và quyết định kiến trúc được người duy trì xem xét và phê duyệt trước khi merge.
Tuyên bố này áp dụng cho:
- Mã nguồn trong `src/` và `src-tauri/`.
- Tài liệu trong `docs/` và các file markdown ở root.
- File locale trong `src/i18n/locales/`.
- Workflow CI/CD trong `.github/workflows/`.
Xem thêm: [`THIRD_PARTY_NOTICES.md`](../../../THIRD_PARTY_NOTICES.md) § "AI-Assisted Development Disclosure".
## Chất lượng bản dịch
UI ứng dụng hỗ trợ sáu ngôn ngữ. Chất lượng tác giả khác nhau:
| Locale | Tác giả | Ghi chú |
| --- | --- | --- |
| Tiếng Anh (`en`) | Người duy trì + AI | Locale làm việc chính. Chuỗi được review trước khi commit. |
| Tiếng Việt (`vi`) | Người duy trì (bản ngữ) + AI | Review bởi người duy trì là người bản ngữ tiếng Việt. |
| Tiếng Nhật (`ja`) | AI dịch | Không có review bản ngữ. Ngữ pháp và văn phong có thể chưa chuẩn. |
| Tiếng Tây Ban Nha (`es`) | AI dịch | Không có review bản ngữ. Không nhắm cụ thể vào giọng vùng miền (LatAm vs. Castilian). |
| Tiếng Hàn (`ko`) | AI dịch | Không có review bản ngữ. Honorific register chọn ở mức trung tính. |
| Tiếng Trung (`zh`) | AI dịch | Giản thể. Không có review bản ngữ. |
Nếu bạn là người bản ngữ và phát hiện dịch sai, vui lòng mở issue hoặc PR — xem [CONTRIBUTING.md](../../../CONTRIBUTING.md) § "i18n Contributions".
## Giọng văn và phong cách
Template description sinh ra dùng giọng văn được điều chỉnh cho ngách **gameplay no-commentary** trên YouTube, đặc biệt nhấn mạnh game horror / kinh dị (vì đó là nội dung kênh của người duy trì). Output có thể không hợp với mọi kênh hay mọi văn hoá đọc. Ứng dụng dùng template — bạn có thể sửa bất kỳ text sinh ra nào trước khi đăng.
Một số cụm tiếng Việt cố tình giữ từ vay mượn và giọng casual phản ánh cách các creator gameplay Việt thường viết description. Đây không phải "dịch sai" mà là lựa chọn phong cách cho đối tượng đọc.
## Không bảo hành
Phần mềm cung cấp **nguyên trạng, không có bất kỳ bảo hành nào**. Xem [`LICENSE`](../../../LICENSE) (Apache 2.0) §§ 7 và 8 cho đầy đủ điều khoản miễn trừ bảo hành và giới hạn trách nhiệm.
Nói ngắn gọn: nếu ứng dụng crash, làm hỏng draft, sinh ra description khiến video bị YouTube flag, hoặc gây bất kỳ thiệt hại nào — người duy trì không chịu trách nhiệm. Dùng tự chịu rủi ro; back up draft của bạn.
## Không liên kết với YouTube / Anthropic
YTDescGen **không** liên kết, được tài trợ, hay được YouTube, Google LLC, hay Alphabet Inc. xác nhận. Output sinh ra dành để paste vào YouTube Studio editor; ứng dụng này không tương tác với YouTube API.
Việc dùng Claude Code trong quá trình phát triển **không** biến đây thành sản phẩm của Anthropic. Anthropic, Claude, và Claude Code là nhãn hiệu của Anthropic, PBC. Dự án này độc lập.
## Không phải tư vấn pháp lý hay tài chính
Bất kỳ đề cập nào đến GDPR, CCPA, luật bản quyền, chính sách monetization của YouTube, hay các chủ đề tương tự trong tài liệu repo này chỉ để định hướng — **không phải tư vấn pháp lý**. Tham vấn luật sư có chuyên môn ở khu vực của bạn nếu cần câu trả lời chính thống.
<title>YTDescGen — YouTube Title, Description & Tag Generator for Gameplay Channels</title>
<metaname="description"content="Generate YouTube titles, descriptions, and tags for Gameplay No Commentary channels — multilingual templates, profile presets, and a Tauri-based desktop build."/>
<metaname="keywords"content="youtube, gameplay, no commentary, description generator, tags generator, video title, vietnamese, japanese, korean, spanish, chinese, multilingual, tauri, desktop"/>
"description":"Generate YouTube titles, descriptions, and tags for Gameplay No Commentary channels — multilingual templates, profile presets, and a Tauri-based desktop build.",
{"core":{"default_permission":{"identifier":"default","description":"Default core plugins set.","permissions":["core:path:default","core:event:default","core:window:default","core:webview:default","core:app:default","core:image:default","core:resources:default","core:menu:default","core:tray:default"]},"permissions":{},"permission_sets":{},"global_scope_schema":null},"core:app":{"default_permission":{"identifier":"default","description":"Default permissions for the plugin.","permissions":["allow-version","allow-name","allow-tauri-version","allow-identifier","allow-bundle-type","allow-register-listener","allow-remove-listener"]},"permissions":{"allow-app-hide":{"identifier":"allow-app-hide","description":"Enables the app_hide command without any pre-configured scope.","commands":{"allow":["app_hide"],"deny":[]}},"allow-app-show":{"identifier":"allow-app-show","description":"Enables the app_show command without any pre-configured scope.","commands":{"allow":["app_show"],"deny":[]}},"allow-bundle-type":{"identifier":"allow-bundle-type","description":"Enables the bundle_type command without any pre-configured scope.","commands":{"allow":["bundle_type"],"deny":[]}},"allow-default-window-icon":{"identifier":"allow-default-window-icon","description":"Enables the default_window_icon command without any pre-configured scope.","commands":{"allow":["default_window_icon"],"deny":[]}},"allow-fetch-data-store-identifiers":{"identifier":"allow-fetch-data-store-identifiers","description":"Enables the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":["fetch_data_store_identifiers"],"deny":[]}},"allow-identifier":{"identifier":"allow-identifier","description":"Enables the identifier command without any pre-configured scope.","commands":{"allow":["identifier"],"deny":[]}},"allow-name":{"identifier":"allow-name","description":"Enables the name command without any pre-configured scope.","commands":{"allow":["name"],"deny":[]}},"allow-register-listener":{"identifier":"allow-register-listener","description":"Enables the register_listener command without any pre-configured scope.","commands":{"allow":["register_listener"],"deny":[]}},"allow-remove-data-store":{"identifier":"allow-remove-data-store","description":"Enables the remove_data_store command without any pre-configured scope.","commands":{"allow":["remove_data_store"],"deny":[]}},"allow-remove-listener":{"identifier":"allow-remove-listener","description":"Enables the remove_listener command without any pre-configured scope.","commands":{"allow":["remove_listener"],"deny":[]}},"allow-set-app-theme":{"identifier":"allow-set-app-theme","description":"Enables the set_app_theme command without any pre-configured scope.","commands":{"allow":["set_app_theme"],"deny":[]}},"allow-set-dock-visibility":{"identifier":"allow-set-dock-visibility","description":"Enables the set_dock_visibility command without any pre-configured scope.","commands":{"allow":["set_dock_visibility"],"deny":[]}},"allow-tauri-version":{"identifier":"allow-tauri-version","description":"Enables the tauri_version command without any pre-configured scope.","commands":{"allow":["tauri_version"],"deny":[]}},"allow-version":{"identifier":"allow-version","description":"Enables the version command without any pre-configured scope.","commands":{"allow":["version"],"deny":[]}},"deny-app-hide":{"identifier":"deny-app-hide","description":"Denies the app_hide command without any pre-configured scope.","commands":{"allow":[],"deny":["app_hide"]}},"deny-app-show":{"identifier":"deny-app-show","description":"Denies the app_show command without any pre-configured scope.","commands":{"allow":[],"deny":["app_show"]}},"deny-bundle-type":{"identifier":"deny-bundle-type","description":"Denies the bundle_type command without any pre-configured scope.","commands":{"allow":[],"deny":["bundle_type"]}},"deny-default-window-icon":{"identifier":"deny-default-window-icon","description":"Denies the default_window_icon command without any pre-configured scope.","commands":{"allow":[],"deny":["default_window_icon"]}},"deny-fetch-data-store-identifiers":{"identifier":"deny-fetch-data-store-identifiers","description":"Denies the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":[],"deny":["fetch_data_store_identifiers"]}},"deny-identifier":{"identifier":"deny-identifier","description":"Denies the identifier command without any pre-configured scope.","commands":{"allow":[],"deny":["identifier"]}},"deny-name":{"identifier":"deny-name","description":"Denies the name command without any pre-configured scope.","commands":{"allow":[],"deny":["name"]}},"deny-register-listener":{"identifier":"deny-register-listener","description":"Denies the register_listener command without any pre-configured scope.","commands":{"allow":[],"deny":["register_listener"]}},"deny-remove-data-store":{"identifier":"deny-remove-data-store","description":"Deniestheremove_data_storecommandLine truncated
{"core":{"default_permission":{"identifier":"default","description":"Default core plugins set.","permissions":["core:path:default","core:event:default","core:window:default","core:webview:default","core:app:default","core:image:default","core:resources:default","core:menu:default","core:tray:default"]},"permissions":{},"permission_sets":{},"global_scope_schema":null},"core:app":{"default_permission":{"identifier":"default","description":"Default permissions for the plugin.","permissions":["allow-version","allow-name","allow-tauri-version","allow-identifier","allow-bundle-type","allow-register-listener","allow-remove-listener","allow-supports-multiple-windows"]},"permissions":{"allow-app-hide":{"identifier":"allow-app-hide","description":"Enables the app_hide command without any pre-configured scope.","commands":{"allow":["app_hide"],"deny":[]}},"allow-app-show":{"identifier":"allow-app-show","description":"Enables the app_show command without any pre-configured scope.","commands":{"allow":["app_show"],"deny":[]}},"allow-bundle-type":{"identifier":"allow-bundle-type","description":"Enables the bundle_type command without any pre-configured scope.","commands":{"allow":["bundle_type"],"deny":[]}},"allow-default-window-icon":{"identifier":"allow-default-window-icon","description":"Enables the default_window_icon command without any pre-configured scope.","commands":{"allow":["default_window_icon"],"deny":[]}},"allow-fetch-data-store-identifiers":{"identifier":"allow-fetch-data-store-identifiers","description":"Enables the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":["fetch_data_store_identifiers"],"deny":[]}},"allow-identifier":{"identifier":"allow-identifier","description":"Enables the identifier command without any pre-configured scope.","commands":{"allow":["identifier"],"deny":[]}},"allow-name":{"identifier":"allow-name","description":"Enables the name command without any pre-configured scope.","commands":{"allow":["name"],"deny":[]}},"allow-register-listener":{"identifier":"allow-register-listener","description":"Enables the register_listener command without any pre-configured scope.","commands":{"allow":["register_listener"],"deny":[]}},"allow-remove-data-store":{"identifier":"allow-remove-data-store","description":"Enables the remove_data_store command without any pre-configured scope.","commands":{"allow":["remove_data_store"],"deny":[]}},"allow-remove-listener":{"identifier":"allow-remove-listener","description":"Enables the remove_listener command without any pre-configured scope.","commands":{"allow":["remove_listener"],"deny":[]}},"allow-set-app-theme":{"identifier":"allow-set-app-theme","description":"Enables the set_app_theme command without any pre-configured scope.","commands":{"allow":["set_app_theme"],"deny":[]}},"allow-set-dock-visibility":{"identifier":"allow-set-dock-visibility","description":"Enables the set_dock_visibility command without any pre-configured scope.","commands":{"allow":["set_dock_visibility"],"deny":[]}},"allow-supports-multiple-windows":{"identifier":"allow-supports-multiple-windows","description":"Enables the supports_multiple_windows command without any pre-configured scope.","commands":{"allow":["supports_multiple_windows"],"deny":[]}},"allow-tauri-version":{"identifier":"allow-tauri-version","description":"Enables the tauri_version command without any pre-configured scope.","commands":{"allow":["tauri_version"],"deny":[]}},"allow-version":{"identifier":"allow-version","description":"Enables the version command without any pre-configured scope.","commands":{"allow":["version"],"deny":[]}},"deny-app-hide":{"identifier":"deny-app-hide","description":"Denies the app_hide command without any pre-configured scope.","commands":{"allow":[],"deny":["app_hide"]}},"deny-app-show":{"identifier":"deny-app-show","description":"Denies the app_show command without any pre-configured scope.","commands":{"allow":[],"deny":["app_show"]}},"deny-bundle-type":{"identifier":"deny-bundle-type","description":"Denies the bundle_type command without any pre-configured scope.","commands":{"allow":[],"deny":["bundle_type"]}},"deny-default-window-icon":{"identifier":"deny-default-window-icon","description":"Denies the default_window_icon command without any pre-configured scope.","commands":{"allow":[],"deny":["default_window_icon"]}},"deny-fetch-data-store-identifiers":{"identifier":"deny-fetch-data-store-identifiers","description":"Denies the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":[],"deny":["fetch_data_store_identifiers"]}},"deny-identifier":{"identifier":"deny-identifier","description":"Denies the identifier command without any pre-configured scope.","commands":{"allow":[],"deny":["identifier"]}},"deny-name":{"identifier":"deny-name","description":"Denies the name command without any pre-configured scope.","commands":{"allow":[],"deny":["name"]}},"deny-register-listener":{"identifier":"deny-reLine truncated
{"default":{"identifier":"default","description":"Default capabilities for YTDescGen","local":true,"windows":["main"],"permissions":["core:default","dialog:default","dialog:allow-save","dialog:allow-open","fs:default","fs:allow-read-text-file","fs:allow-write-text-file","shell:default"]}}
{"default":{"identifier":"default","description":"Default capabilities for YTDescGen","local":true,"windows":["main"],"permissions":["core:default","dialog:default","dialog:allow-save","dialog:allow-open","fs:default","fs:allow-read-text-file","fs:allow-write-text-file","shell:default","opener:default"]}}
Loaded 100 of 303 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.