Communitygithub.com

mting314/projets-sous-titrage

Étapes finales de mise en page et publication pour les AfterTalks de ProSeka (fichiers .ass traduits) : applique les styles positionnels, corrige les lignes sur 3+ lignes, détecte les segments à incruster et génère le titre et la description YouTube.

Qu'est-ce que projets-sous-titrage ?

Cette compétence automatise les étapes finales de publication d'un fichier de sous-titres traduit (`_translated.ass`) pour un AfterTalk de ProSeka (ou projet similaire). Elle orchestre quatre opérations déterministes : (1) l'application de styles positionnels pour que les sous-titres n'empiètent pas sur le contenu vidéo (pip, song-shift), (2) la détection et correction des lignes causant 3+ rangées de texte, (3) la localisation des segments à incruster (host talk uniquement) et le rognage des parties non diffusées (intro, PV, story watchalong, MV), et (4) la génération du titre et de la description YouTube. La compétence est conçue pour fonctionner avec des dépôts de projets existants (scripts dans `scripts/`) et s'intègre à `aegisub-ass` pour la vérification par rendu d'image. Elle utilise des scripts Python (jugeant des décisions, mais exécutant après confirmation) et un script bash pour l'incrustation GPU. L'utilisateur confirme chaque étape éditoriale, et les scripts sont auto-suffisants, l'utilisateur n'ayant qu'à fournir les chemins de fichiers et les décisions de style.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Lancement AfterTalk (positionnement → incrustation → publication)

La passe finale d'un fichier _translated.ass, après la relecture qualité en quatre dimensions (détaillée dans subtitle_review_guide.md). Quatre étapes, chacune soutenue par un script déterministe dans scripts/ à la racine du dépôt du projet afin que cette compétence ne fournisse que le jugement. Exécutez tout depuis la racine du dépôt du projet (les chemins ci-dessous sont scripts/…).

  1. Styles positionnels — repositionne les sous-titres pour qu'ils ne couvrent pas le contenu à l'écran.
  2. Longueur de ligne — signale et corrige toute ligne s'affichant sur 3+ rangées (à faire après le positionnement, car les lignes PiP/Latérale s'enroulent plus étroitement et sont les principales fautives).
  3. Segments incrustés — trouve les plages de discussion de l'hôte à conserver et les incruste.
  4. Titre et description YouTube — rédige le texte de publication.

1. Styles positionnels (PiP / song-shift)

Repositionne les sous-titres pour qu'ils ne chevauchent jamais le contenu à l'écran. Le pipeline pré-assigne les noms de style aux plages de lignes appropriées, mais les livre généralement comme des copies simples du style principal (mauvaises marges) sans \pos sur les lignes PiP. Le script corrige les deux, copiant la mise en page à partir d'une référence connue ; cette compétence résout les noms de style par épisode en rôles (ils diffèrent selon le personnage).

RôleQuandStyle de référence (Colors of Pure Sense)Reçoit \pos ?
pipla caméra de l'hôte / l'art de la carte remplit le cadre ; les sous-titres se placent au milieuPiP (Alignement 8, marges 100/800/50)oui — {\pos(650,750)} par ligne
shiftun MV 2D/3D joue en bas à droite ; décale les sous-titres à gauche pour le libérerDefaultOnibe - Shifted (Alignement 2, marges 100/730/60)non — les marges de style le font

Découvrez les styles positionnels de la cible, puis déduisez le rôle des tokens du nom (PiP→pip ; Shifted/Side Song/Shift→shift) et confirmez avec l'utilisateur :

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"

Appliquez (ne copie que l'Alignement + MarginL/R/V — la couleur et la police sont conservées ; ignore les lignes Comment: et déjà positionnées ; idempotent, --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

Correspondance : STYLE_CIBLE:STYLE_REF[:X,Y] ; --pip/--shift répétables par personnage. Confirmez que la cible et la référence partagent le même PlayResX/Y.

Vérifiez par rendu (déléguez à la compétence aegisub-ass) : retiming d'une ligne pip et d'une ligne shift sur 0:00:00.00–0:00:05.00, rendu d'une image sur fond gris uni, et confirmation que le texte pip est centré dans le cadre et que le texte shift libère le coin inférieur droit.


2. Longueur de ligne (max 2 rangées à l'écran)

3+ rangées est une mauvaise pratique (balayage oculaire, espace écran). Le nombre de rangées dépend du wrapping réel de libass sous le style de chaque ligne, donc mesuré par rendu. À exécuter après le positionnement (PiP s'enroule à ~1020px, Side-Song ~1090px contre ~1320px pour le principal — les étroits sont les fautifs) et après toute modification de texte (un reformatage change le wrapping).

Détection (rend chaque ligne sous son style sur fond noir, compte les rangées par projection) :

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

Pour chaque ligne signalée, proposez à l'utilisateur les deux correctifs et appliquez son choix :

  • Fractionner en deux événements à une frontière de proposition (virgule, and/but/so, that, fin de phrase) avec scripts/split_subtitle_line.py --line N --before "<clause>" --transcript <t.json>. Il définit la césure temporelle sur une vraie respiration : estimation proportionnelle à la longueur, puis ajustement au plus grand écart de mots dans ±1s autour (rejetant les pauses lointaines en milieu de phrase et tout ajustement laissant une moitié trop courte à lire). Conserve le texte exact + \pos.
  • Reformuler plus court, en préservant le sens et le style décontracté.

Préférez le fractionnement pour deux vraies propositions/phrases ou une pause naturelle ... ; reformulez pour une seule respiration. Re-rendez chaque correctif candidat et confirmez ≤2 rangées avant de le présenter/appliquer, puis relancez le détecteur — objectif : 0 signalé. (Nécessite pillow + numpy via uv run --with.)


3. Segments incrustés (trouver les plages à conserver → incruster)

Un AfterTalk alterne discussion de l'hôte (conserver) avec watchalongs (couper) : délai d'intro, PV/digest d'ouverture, watchalong de l'histoire du jeu, et chanson/2DMV. Les régions coupées sont des lignes Comment: non rendues (ou rien), donc elles apparaissent comme des trous dans la timeline Dialogue rendue. find_segments.py les trouve et, avec --transcript, signale si chaque trou est silencieux (sûr) ou audio de watchalong.

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"

Lisez les régions CUT : ~0 mots = silencieux (sûr à supprimer) ; beaucoup de mots = un watchalong d'histoire/chanson que vous coupez intentionnellement (son propre audio, pas de discussion hôte). Confirmez le plan de coupe avec l'utilisateur avant de rendre — couper est une décision éditoriale, et le rendu est coûteux. Enregistrez les plages dans le notes.md du projet, section "Segments".

Limites sensibles aux fondus : en passant --mkv (ou --hardsub, qui réutilise son MKV), il exécute blackdetect près de chaque limite et repousse la coupe juste avant tout fondu source. Les watchalongs/MV fondent au noir à leurs bords ; le padding peut pousser une coupe dans un fondu, et deux demi-fondus adjacents se rencontrant à une jointure de concaténation produisent un flash noir. Il émet des limites inférieures à la seconde — aucune perte de sous-titres (la zone de padding est sans sous-titres). Le script signale par ex. end 0:51:00->0:50:59.69 (source fade).

Ensuite incrustez (le flag --hardsub imprime cette commande ; doit incruster avant le rognage — le rognage invalide les timestamps .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

Gère l'encodage GPU parallèle (h264_nvenc), la composition automatique des overlays popups.json (VA/gachapin), les transitions fondues vidéo+audio de 0,4 s aux limites de segments, et la concaténation en vidéo finale.


4. Titre et description YouTube

Écrivez-les dans le notes.md du projet (## YouTube Title, ## YouTube Blurb).

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

Description — deux paragraphes, ton décontracté et enthousiaste, voix de récapitulatif (fans qui veulent un résumé, pas un teaser). Règles de style :

  1. Pas de tirets cadratins (—). Utilisez des virgules, parenthèses ou propositions séparées. Scannez le brouillon et remplacez tout — avant d'enregistrer.
  2. Commencez par le cadre de la série : This episode of ProSeka AfterTalk has <VA name> (voice of <character>) covering <event/topic>.... C'est une série récurrente, donc "this episode of", pas "in the AfterTalk."
  3. Mêlez personnalité et substance. L'épine dorsale est la couverture substantielle (histoire, art de carte, chanson, enregistrement) ; associez chaque sujet à un détail de personnalité issu de ce même sujet (par ex. discuter de la chanson et tâtonner "2DMV"). Ne reléguez pas les parties amusantes dans un paragraphe séparé.
  4. Pas de phrases d'accroche ("Bonus:", "Don't miss...", "Plus:"). Gardez le ton descriptif et récapitulatif tout du long.

Terminez par Original video: <url>.

Structure à refléter : paragraphe 1 identifie VA + événement + cadre (hôte solo/duo, ce qu'elle regarde) ; paragraphe 2 couvre l'histoire/enregistrement, les illustrations de cartes et la chanson/MV, avec la personnalité intégrée. Voir Grow Glorious Glow Aftertalk/notes.md ou Gazing Upon the Night Sky's Fading Stars Aftertalk/notes.md pour des exemples concrets.


5. Téléchargement YouTube

Après l'incrustation et la rédaction de notes.md, exécutez scripts/youtube_upload.py pour télécharger la vidéo finale :

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

Le script extrait automatiquement le titre et la description de notes.md, vérifie les longueurs, demande confirmation et télécharge via l'API YouTube Data v3 (téléchargement résumable).


Garde-fous

  • Positionnel : seul l'Alignement + MarginL/R/V changent ; jamais de recolorisation ; ne touchez jamais aux lignes Comment: ni n'écrasez un \pos existant.
  • Segments : couper est éditorial — confirmez avant le rendu (coûteux) ; enregistrez les plages dans notes.md ; le nombre de mots du transcript vous indique pourquoi un trou est une coupe.
  • Les scripts signalent une erreur en cas de style/chemin inconnu — corrigez les arguments plutôt que de forcer.

Skills associés