lalomorales22/toonkit-shorts

ToonKit Shorts: configuración

Todo aquí es $0. El renderizado no necesita cuentas en absoluto. La subida necesita la cuenta de Google del propio usuario.

1. Stack de renderizado (sin cuentas)

1. Necesitas: python3 3.10+, ffmpeg con libass (brew install ffmpeg / sudo apt install ffmpeg), Node 18+ solo para subidas.
2. Desde la raíz del plugin: ./setup.sh (o SKIP_YTKIT=1 ./setup.sh solo para renderizado). Crea toonkit/.venv, instala toonkit/requirements.txt, descarga todas las voces de Piper nombradas en toonkit/look.yaml y toonkit/looks/*.yaml dentro de toonkit/voices/ (desde huggingface.co/rhasspy/piper-voices), guarda en caché faster-whisper small.en, ejecuta npm install en YtKit, y crea toonkit/look.yaml desde el preset mort-and-blitz si no existe.
3. Verifica: ./test.sh (renderiza el episodio de muestra sin conexión, luego una subida DRY_RUN). Debe imprimir ALL TESTS PASSED.

2. Subidas a YouTube (opcional, la cuenta de Google del propio usuario)

Guía al usuario a través de esto en su navegador. Nunca le pidas que pegue secretos en el chat.

1. https://console.cloud.google.com → crea un proyecto (ej. ytkit). "Sin organización" está bien para cuentas personales.
2. APIs y Servicios → Biblioteca → habilita YouTube Data API v3.
3. Plataforma de Google Auth (pantalla de consentimiento OAuth) → Marca: completa TODOS los campos: Nombre de la aplicación, Correo electrónico de soporte al usuario, Página de inicio de la aplicación, Enlace de política de privacidad (cualquier página pública que posean, ej. su perfil/repositorio de GitHub, funciona para una aplicación personal). La publicación está bloqueada hasta que se llenen estos campos.
4. Audiencia → Tipo de usuario Externo → haz clic en PUBLICAR APLICACIÓN (pásala a En producción). Esto es crítico: mientras la aplicación esté en Pruebas, los tokens de actualización de Google CADUCAN CADA 7 DÍAS y la subida diaria se rompe silenciosamente cada semana. La advertencia de "aplicación no verificada" es esperada para una aplicación personal; no se necesita verificación para tu propio canal.
5. Clientes → Crear cliente → Aplicación de escritorio → descarga el JSON → guárdalo como ~/.ytkit/client_secret.json (nunca lo subas al repositorio).
6. cd ytkit && npx tsx src/cli.ts auth → se abre el navegador → en "Google no ha verificado esta aplicación" haz clic en Avanzado → Ir a (nombre de la aplicación) → elige el canal correcto (los canales de marca aparecen por separado) → permite todos los ámbitos. El token se guarda en ~/.ytkit/token.json.
7. npx tsx src/cli.ts whoami debe imprimir el título del canal.
8. Lista de reproducción opcional: npx tsx src/cli.ts playlist ensure "Mi Show" luego configura upload.playlist en look.yaml.

Solución de problemas: invalid_grant = token caducado/revocado (generalmente la aplicación aún estaba en Pruebas): publica la aplicación, vuelve a ejecutar auth. Las miniaturas personalizadas necesitan un canal verificado por teléfono; thumbnail set con código de salida 3 significa "aún no elegible" y la subida sigue funcionando correctamente.