poli0981andClaude Opus 5.5 a2715f9c69 feat(ui): redesign — design system, app shell, command palette, every page
A new, compact interface on Radix primitives, Motion, cmdk and sonner.

Design system
- Tokens for surfaces, text, accent and states in dark and light, used
  everywhere (no more hard-coded red/yellow/pink); Inter and JetBrains
  Mono self-hosted; compact controls that grow to 44px on touch screens.
- Primitives rebuilt on Radix: Button, IconButton (cannot render without
  a name), Field/Input/Select/Textarea (labels wired to controls; the ten
  selects that shared id="type" are gone), Switch, Checkbox, Tabs,
  SegmentedControl, Accordion (closed content is inert), Dialog,
  AlertDialog, Sheet, Popover, Tooltip, Card, Badge, Banner, EmptyState,
  PageHeader, NumberField.
- Animated icons (copy→check, sun↔moon, hover micro-motion on the nav)
  that follow the OS reduce-motion setting.

App shell
- Collapsible sidebar with grouped pages and a sliding active marker;
  top bar with the command palette, output/interface language, theme
  and donate; on phones a bottom bar with four pages plus "More".
- Ctrl/⌘+K command palette: go anywhere, copy title/description/tags,
  apply a profile/preset/template, switch theme or languages.
- Skip link, one h1 per page, <main> focusable; toasts no longer share a
  corner with three other floating elements.

Pages
- Editor: two columns with a sticky live preview (tabs, counters, copy)
  or a sheet on phones; sections reordered so video type and game come
  first; genres are a searchable picker instead of a wall of 42 chips;
  expand/collapse all; a button to the Output page.
- Output: a YouTube preview (what search results and the "…more" fold
  show), language tabs, Copy All in the header (floating on phones).
- Profiles/presets/templates share one card with Apply + Undo; History,
  Logs, Batch, Social, Playlist, Settings, About, Legal, the consent
  screen and the error pages all use the same primitives.

Fixes
- Ctrl/⌘+Shift+C ignored the YouTube limits and Strict Mode.
- Number settings clamped on every keystroke; they now save on blur.
- Hard-coded English on Playlist, Batch, Logs, Profiles and Settings.
- Flags as language icons (Windows shows letters) → native name + code.
- The consent screen could not change language or theme.
- About: dead Discord invite removed; contact addresses by purpose.
- Desktop window is resizable (1280×820, min 960×640).

Initial load 262 KB gzip (budget 280): the command palette, the genre
list and the Output page load on demand.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 20:42:43 +07:00
2026-05-14 15:45:16 +07:00
2026-05-14 15:45:16 +07:00

🎮 YTDescGen

YouTube Gameplay Description Generator — an offline-first template engine for Gameplay No Commentary YouTube channels.

Generate YouTube titles, descriptions, and tags in eight languages with one click. Save channel, rig, and game presets to skip repetitive data entry. Works in the browser (GitHub Pages), as a small native desktop app (Windows / macOS / Linux — the installers are 2-5 MB), or as an installable Android APK — all from one Tauri 2 codebase.

License Node Latest release Last commit


What is YTDescGen

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 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

  • 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.
  • 8 UI languages — English, Vietnamese, Japanese, Spanish, Korean, Chinese, Portuguese (Brazil), Indonesian. (VI authored by a native speaker; JA / ES / KO / ZH / PT-BR / ID AI-translated — see 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. The Windows, macOS and deb/rpm installers are 2-5 MB; the self-contained Linux AppImage is larger.
  • 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 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.

Quick Start

git clone https://github.com/poli0981/youtube-generator.git
cd yt-desc-gen
npm install
npm run dev        # web dev server at http://localhost:5173

Desktop build (Windows / macOS / Linux):

npm run tauri:build
# Output: src-tauri/target/release/bundle/{msi,deb,dmg,app}

Android build (.apk) — requires the Android SDK + NDK + a JDK:

cargo tauri android init          # one-time; generates src-tauri/gen/android
cargo tauri android build --apk
# Output: src-tauri/gen/android/app/build/outputs/apk/universal/release/

See docs/PACKAGING.md for the SDK/NDK setup and signing steps.

Full development setup, IDE config, and troubleshooting: see docs/DEVELOPMENT.md. Vietnamese version: 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.

Tech Stack

React 19 · TypeScript (strict) · Vite 8 · Tailwind CSS 4 · Zustand 5 · i18next 26 · Tauri 2 (Rust stable).

Architecture overview: docs/ARCHITECTURE.md.

Documentation

Document What's in it
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.
Development Guide Toolchain, IDE setup, build commands, troubleshooting. (Also: Vietnamese.)
Architecture Layer model, data flow, engine design.
Features Full feature matrix.
Content Inventory Every video type, genre, and content warning the editor surfaces. (Also: Vietnamese.)
Roadmap Development phases.
Tech Spec Implementation details and configs.
i18n Guide Adding new locales.
Packaging Tauri desktop + Android release builds and signing.
Contributing PR process, commit conventions, auto-ignore rules.
Security Reporting vulnerabilities.
Privacy Data handling (TL;DR: none).
Disclaimer AI-assistance and translation-quality disclosure. (Also: Vietnamese.)
Terms of Use Acceptable use and license compliance.
Code of Conduct Contributor Covenant v2.1.
Maintainers Who runs this.
Third-Party Notices Dependency attribution.
Changelog Per-release notes.

Contributing

PRs welcome — read CONTRIBUTING.md first. Native-speaker corrections to AI-translated locales (JA / ES / KO / ZH) are especially appreciated.

License

Licensed under the Apache License 2.0. See NOTICE for the copyright statement and THIRD_PARTY_NOTICES.md for dependency licenses.

AI Disclosure

This project was co-authored with Anthropic's Claude Code (Opus-class models; most recently Opus 5). 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 for the full disclosure.

Channel & Socials

Reference channel and maintainer links:

S
Description
No description provided
Readme Apache-2.0
5 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 95.4%
Rust 2.1%
CSS 0.8%
HTML 0.7%
JavaScript 0.6%
Other 0.4%