Communitygithub.com

mting314/proyectos-de-subtitulacion

Úsalo al finalizar un ProSeka AfterTalk (o similar) `_translated.ass` para su publicación, tras la revisión de texto QC: los pasos de diseño y publicación en un solo lugar: (1) aplicar estilos posicionales PiP/desplazamiento de canción, (2) detectar y corregir líneas que se renderizan en 3+ filas, (3) encontrar segmentos de subtítulos quemados (recortando el retraso inicial, PV, visualización de la historia y canción/2DMV), y (4) redactar el título y la descripción de YouTube. Autocontenido: ejecuta `apply_positional_styles.py`, `detect_long_lines.py`, `find_segments.py` y `hardsub_trim.sh`, e incluye las reglas de estilo del texto de YouTube. Los scripts se encuentran en `scripts/` en la raíz del repositorio de proyectos. Se compone con la habilidad `aegisub-ass` para verificación de renderizado.

¿Qué es proyectos-de-subtitulacion?

Esta habilidad automatiza los pasos finales de publicación de subtítulos para videos de ProSeka AfterTalk, ayudando a preparar un archivo `_translated.ass` para su lanzamiento en YouTube. Consta de cuatro pasos principales: aplicar estilos posicionales (PiP o desplazamiento de canción) para evitar que los subtítulos cubran contenido en pantalla, detectar y corregir líneas que se renderizan en tres o más filas, identificar los segmentos de charla del anfitrión que deben conservarse para quemar los subtítulos (recortando intros, PV, visualizaciones de historia y canciones/MV), y generar el título y la descripción de YouTube siguiendo reglas de estilo específicas. Incluye guías detalladas de verificación mediante renderizado y se integra con la habilidad `aegisub-ass` para confirmar la posición final de los subtítulos. Es útil para cualquier persona que trabaje en la publicación de videos traducidos de ProSeka AfterTalk u otros videos similares.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mting314/subtitling-projects/tree/HEAD/.claude/skills/aftertalk-launch

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Lanzamiento de AfterTalk (posicionamiento → subtítulos quemados → publicación)

El pase final en un _translated.ass, después de la revisión de texto QC de cuatro dimensiones (que está en subtitle_review_guide.md). Cuatro pasos, cada uno respaldado por un script determinista en scripts/ en la raíz del repositorio de proyectos, por lo que esta habilidad solo proporciona juicio. Ejecute todo desde la raíz del repositorio de proyectos (las rutas a continuación son scripts/…).

  1. Estilos posicionales — reposiciona los subtítulos para que no cubran el contenido en pantalla.
  2. Longitud de línea — marca y corrige cualquier línea que se renderice en 3+ filas (hacer después del posicional, ya que las líneas PiP/Lado-Canción envuelven más estrecho y son las principales infractoras).
  3. Segmentos de subtítulos quemados — encuentra los rangos de charla del anfitrión para conservar y quemarlos.
  4. Título y descripción de YouTube — escribe el texto de publicación.

1. Estilos posicionales (PiP / desplazamiento de canción)

Reposiciona los subtítulos para que nunca se superpongan al contenido en pantalla. El pipeline preasigna los nombres de estilo a los rangos de línea correctos, pero normalmente los envía como copias simples del estilo principal (márgenes incorrectos) sin \pos en las líneas PiP. El script corrige ambos, copiando el diseño de una referencia conocida; esta habilidad resuelve los nombres de estilo por episodio en roles (difieren por personaje).

RolCuándoEstilo de referencia (Colors of Pure Sense)¿Recibe \pos?
pipla cámara del anfitrión / el arte de la tarjeta llena el cuadro; los subtítulos se colocan en medio del cuadroPiP (Alineación 8, márgenes 100/800/50)sí — {\pos(650,750)} por línea
shiftun MV 2D/3D se reproduce en la parte inferior derecha; desplaza los subtítulos a la izquierda para despejarloDefaultOnibe - Shifted (Alineación 2, márgenes 100/730/60)no — los márgenes del estilo lo hacen

Descubra los estilos posicionales del objetivo, luego infiera el rol de los tokens del nombre (PiP→pip; Shifted/Side Song/Shift→shift) y confirme con el usuario:

f="projects/Project Sekai/Aftertalk/<event>/<name>_translated.ass"
grep -oE "^Dialogue: [0-9]+,[^,]+,[^,]+,[^,]+" "$f" | awk -F, '{print $4}' | sort | uniq -c
grep "^Style:" "$f"

Aplique (copia solo Alineación + MarginL/R/V — color/fuente conservados; omite líneas Comment: y ya posicionadas; idempotente, --dry-run):

python3 scripts/apply_positional_styles.py "projects/Project Sekai/Aftertalk/<event>/<name>_translated.ass" \
  --reference "projects/Project Sekai/Events/Colors of Pure Sense/Colors of Pure Sense_translated.ass" \
  --pip   "<Char> - PiP:PiP:650,750" \
  --shift "<Char> - Side Song:DefaultOnibe - Shifted" \
  --dry-run

Mapeo: TARGET_STYLE:REF_STYLE[:X,Y]; --pip/--shift repetible por personaje. Confirme que el objetivo y la referencia comparten el mismo PlayResX/Y.

Verifique renderizando (delegue a la habilidad aegisub-ass): reajuste el tiempo de una línea pip y una línea shift a 0:00:00.00–0:00:05.00, renderice un fotograma sobre gris plano y confirme que el texto pip se encuentra en medio del cuadro y el texto shift despeja la parte inferior derecha.


2. Longitud de línea (máximo 2 filas en pantalla)

3+ filas es una mala práctica (barrido ocular, espacio en pantalla). El recuento de filas depende del ajuste real de libass bajo el estilo de cada línea, por lo que se mide renderizando. Ejecute después del posicional (PiP envuelve ~1020px, Side-Song ~1090px frente a principal ~1320px — las estrechas son las infractoras) y después de cualquier edición de texto (un cambio de redacción altera el ajuste).

Detecta (renderiza cada línea bajo su estilo sobre negro, cuenta filas por proyección):

uv run --with pillow --with numpy python3 scripts/detect_long_lines.py \
  "projects/Project Sekai/Aftertalk/<event>/<name>_translated.ass"

Para cada línea marcada, ofrezca al usuario ambas correcciones y aplique su elección:

  • Dividir en dos eventos en un límite de cláusula (coma, and/but/so, that, final de oración) con scripts/split_subtitle_line.py --line N --before "<clause>" --transcript <t.json>. Establece la división de tiempo en una respiración real: estimación proporcional por longitud, luego ajusta a la brecha de palabra más grande dentro de ±1s de ella (rechazando pausas intermedias distantes y cualquier ajuste que deje una mitad demasiado corta para leer). Conserva la redacción exacta + \pos.
  • Redactar más corto, conservando el significado + el estilo casual.

Prefiera la división para dos cláusulas/oraciones reales o una pausa natural de ...; redacte de nuevo para una sola respiración. Renderice cada corrección candidata y confirme ≤2 filas antes de presentar/aplicar, luego vuelva a ejecutar el detector — el objetivo es 0 marcadas. (Requiere pillow + numpy a través de uv run --with.)


3. Segmentos de subtítulos quemados (encontrar rangos a conservar → quemar)

Un AfterTalk intercala charla del anfitrión (conservar) con visualizaciones (cortar): retraso inicial, un PV/digest de apertura, la visualización de la historia del juego y la canción/2DMV. Las regiones de corte son líneas Comment: (o nada) que no se renderizan, por lo que aparecen como huecos en la línea de tiempo Dialogue renderizada. find_segments.py los encuentra y, con --transcript, informa si cada hueco es silencioso (seguro) o audio de visualización.

python3 scripts/find_segments.py "projects/Project Sekai/Aftertalk/<event>/<name>_translated.ass" \
  --transcript "projects/Project Sekai/Aftertalk/<event>/<name>_transcript.json" \
  --hardsub "projects/Project Sekai/Aftertalk/<event>/<name>.mkv:projects/Project Sekai/Aftertalk/<event>/<name>_final.mp4"

Lea las regiones CUT: ~0 words = silencioso (seguro de eliminar); muchas palabras = una visualización de historia/canción que está cortando intencionalmente (su propio audio, no charla del anfitrión). Confirme el plan de corte con el usuario antes de renderizar — cortar es una decisión editorial, y el renderizado es costoso. Registre los rangos en el notes.md del proyecto "Segments".

Límites conscientes de fundidos: pasar --mkv (o --hardsub, que reutiliza su MKV) hace que ejecute blackdetect cerca de cada límite y saque el corte justo fuera de cualquier fundido de origen. Las visualizaciones/MV se funden a/desde negro en sus bordes; el relleno puede empujar un corte hacia un fundido, y dos medios fundidos adyacentes al corte que se encuentran en una unión de concatenación producen un destello negro. Emite límites de subsegundos — no se pierden subtítulos (la región de relleno está libre de subtítulos). El script informa, por ejemplo, end 0:51:00->0:50:59.69 (source fade).

Luego queme los subtítulos (el flag --hardsub imprime este comando; debe quemar los subtítulos antes de recortar — recortar invalida las marcas de tiempo de .ass):

uv run python scripts/hardsub_trim.py "<name>.mkv" "<name>_translated.ass" "<name>_hardsubbed.mp4" \
  0:01:37 0:05:27  0:10:53 0:27:40  0:36:05 0:51:00  0:52:25 1:00:09

Maneja la codificación GPU paralela (h264_nvenc), la composición automática de superposiciones popups.json VA/gachapin, transiciones suaves de 0.4 s de video + audio de fundido de entrada/salida en los límites de los segmentos y la concatenación en el video final.


4. Título y descripción de YouTube

Escríbalos en el notes.md del proyecto (## YouTube Title, ## YouTube Blurb).

Título — [ENG SUB] <Event Title> Aftertalk feat. <VA Name> (<Character>'s VA) ej. [ENG SUB] Gazing Upon the Night Sky's Fading Stars Aftertalk feat. Karin Isobe (Saki's VA).

Texto — dos párrafos, casual y entusiasta, voz de resumen (fans que quieren un resumen, no un adelanto). Reglas de estilo:

  1. Sin guiones largos (—). Use comas, paréntesis o cláusulas separadas. Escanee el borrador y reemplace cualquier — antes de guardar.
  2. Comience con el marco de la serie: This episode of ProSeka AfterTalk has <VA name> (voice of <character>) covering <event/topic>.... Es una serie recurrente, así que "this episode of," no "in the AfterTalk."
  3. Entreteja la personalidad en el contenido. La columna vertebral es la cobertura sustancial (historia, arte de tarjeta, canción, grabación); empareje cada tema con un detalle de personalidad de ese mismo tema (por ejemplo, discutiendo la canción y "2DMV" torpe). No relegue las partes tontas a su propio párrafo.
  4. Sin frases de gancho ("Bonus:", "Don't miss...", "Plus:"). Mantenga la voz descriptiva de resumen en todo momento.

Termine con Original video: <url>.

Estructura a reflejar: el párrafo 1 identifica VA + evento + marco (anfitrión solo/en dúo, lo que ella ve); el párrafo 2 cubre la historia/grabación, ilustraciones de tarjetas y la canción/MV, con personalidad entretejida. Vea Grow Glorious Glow Aftertalk/notes.md o Gazing Upon the Night Sky's Fading Stars Aftertalk/notes.md para ejemplos trabajados.


5. Subida a YouTube

Después de quemar los subtítulos y escribir notes.md, ejecute scripts/youtube_upload.py para subir el video terminado:

uv run --script scripts/youtube_upload.py \
  --video "projects/Project Sekai/Aftertalk/<event>/<name>_hardsubbed.mp4" \
  --notes "projects/Project Sekai/Aftertalk/<event>/notes.md"

El script extrae automáticamente el título y la descripción de notes.md, verifica las longitudes, solicita confirmación y sube a través de la API de datos de YouTube v3 (subida reanudable).


Barreras de protección

  • Posicional: solo cambia Alineación + MarginL/R/V; nunca recoloriza; nunca toca líneas Comment: ni sobrescribe un \pos existente.
  • Segmentos: cortar es editorial — confirme antes del (costoso) renderizado; registre los rangos en notes.md; el recuento de palabras de la transcripción le dice por qué un hueco es un corte.
  • Los scripts fallan en estilos/rutas desconocidos — corrija los argumentos en lugar de forzar.

Skills relacionados