Communitygithub.com

video2ppt

Extraction intelligente des images de diapositives à partir d'une vidéo ou d'un enregistrement d'écran, puis génération d'une présentation PPTX ou d'un PDF (une image par page). Utilisez cette compétence lorsque l'utilisateur fournit une vidéo, un enregistrement d'écran, un cours enregistré ou un replay de réunion et souhaite obtenir des diapositives/PPT/PDF. Convient également pour transformer un dossier d'images en PPT ou PDF en lot. Prend en charge la coupure temporelle, la déduplication d'images par SSIM, la capture retardée avec sélection de la meilleure netteté, le recadrage des bords noirs et la compression PDF.

Qu'est-ce que video2ppt ?

Cette compétence permet d'extraire automatiquement les images de diapositives d'une vidéo (conférence, réunion, enregistrement d'écran) et de les assembler en un fichier PPTX (une image par diapositive) ou PDF. Elle est conçue pour fonctionner sur les postes de travail (macOS, Linux, Windows) sans nécessiter d'API ni d'accès réseau. La compétence propose quatre scripts principaux : un pipeline tout-en-un qui extrait les images et génère directement le PPTX/PDF, un script d'extraction d'images avec paramètres réglables (seuil de similarité SSIM, intervalle de capture, recadrage, etc.), un script pour assembler un dossier d'images en PPTX, et un autre pour le PDF avec compression optionnelle. Les commandes s'exécutent dans le répertoire racine de la compétence ; le pipeline `video2ppt.py` est le point d'entrée recommandé pour les utilisateurs finaux. En cas d'erreur, les scripts fournissent des codes de sortie explicites et des logs dédiés. L'utilisateur peut ajuster de nombreux paramètres pour améliorer la qualité des extractions (sensibilité de déduplication, nombre d'images de délai pour éviter les transitions, recadrage des bords noirs, etc.).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/knoyuuki/skills-video2ppt/tree/HEAD/video2ppt

Demander à votre IA préférée

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

Documentation

Que fait video2ppt ?

Extrayez les images de diapositives d'une vidéo pour les assembler en un fichier PPTX (une image par page) ou PDF. Les trois capacités peuvent être utilisées séparément ou enchaînées en un clic :

ScriptRôleScénario typique
scripts/video2ppt.pyPipeline tout-en-un : vidéo → images → PPTX/PDFL'utilisateur ne veut que le PPT/PDF final (à utiliser en priorité)
scripts/video_to_frames.pyExtraction intelligente des images d'une vidéo, sortie d'une séquence d'imagesL'utilisateur a besoin de captures d'écran ou veut trier manuellement avant l'assemblage
scripts/images_to_pptx.pyDossier d'images → PPTXL'utilisateur a déjà des captures/images et veut créer une présentation
scripts/images_to_pdf.pyDossier d'images → PDFL'utilisateur a déjà des captures/images et veut créer un PDF

Toutes les commandes s'exécutent depuis le répertoire racine de cette compétence (celui contenant ce fichier) ; les scripts écrivent aussi des logs sur stderr, vous pouvez utiliser --json pour lire le résumé lisible par machine sur stdout.

0. Préparation de l'environnement (première utilisation)

python scripts/check_env.py
  • Code de retour 0 : dépendances complètes ; code 3 : dépendances obligatoires manquantes.
  • En cas de dépendances manquantes : python -m pip install -r scripts/requirements.txt
  • Obligatoires : opencv-python, numpy, python-pptx, Pillow ; optionnelles améliorées : scikit-image (déduplication SSIM), img2pdf (assemblage PDF en flux, bascule automatique vers Pillow si absent).
  • Les scripts ne lisent aucune clé API ou variable d'environnement, aucun identifiant codé en dur.

1. Pipeline tout-en-un (point d'entrée recommandé)

python scripts/video2ppt.py -i <fichier vidéo/répertoire/wildcard> [-o <répertoire de sortie>] --formats pptx,pdf --json

-o peut être omis : la sortie est placée par défaut dans le répertoire de la première vidéo (pas mélangée avec le répertoire racine de la compétence).

Exemples :

# Vidéo entière → PPT + PDF
python scripts/video2ppt.py -i lecture.mp4 -o ./out --json

# Traitement uniquement de 00:05:00 à 00:40:00, sortie avec mise à l'échelle sans déformation
python scripts/video2ppt.py -i lecture.mp4 -o ./out --start 00:05:00 --end 00:40:00 --fit fit

# Traitement par lot de tous les fichiers vidéo dans un répertoire, génération uniquement du PPTX
python scripts/video2ppt.py -i ./videos -o ./out --formats pptx

Produits : <outdir>/frames/ (images extraites), <outdir>/<nom>.pptx, <outdir>/<nom>.pdf. --name permet de spécifier le nom de base du fichier de sortie, par défaut le nom du premier fichier vidéo. Par exemple, video/2_1.mp4 sans -o produit video/frames/, video/2_1.pptx, video/2_1.pdf.

2. Exécution pas à pas

2.1 Extraction d'images vidéo

python scripts/video_to_frames.py -i <vidéo/répertoire> [-o <répertoire d'images>] [paramètres] --json
  • -o peut être omis, la sortie par défaut est frames/ dans le répertoire de la première vidéo.
  • Paramètres clés : --start / --end (secondes ou HH:MM:SS), --similarity (par défaut 0.8), --skip (par défaut 15), --crop all (suppression des bords noirs).
  • Les noms de fichiers de sortie sont de la forme <nom_vidéo>_ppt_001_frame_000123.png, triés naturellement par numéro de page.

2.2 Images → PPTX

python scripts/images_to_pptx.py -i <répertoire d'images> -o <sortie.pptx> --fit fit --json
  • --fit stretch (par défaut, étirement plein écran) ou --fit fit (maintien du ratio, centrage avec marges).
  • Optionnel : --title nom_cours, --slide-width/--slide-height (pouces, par défaut 16×9), --bg 255,255,255.

2.3 Images → PDF

python scripts/images_to_pdf.py -i <répertoire d'images> -o <sortie.pdf> --json
  • Compression activée par défaut (--max-width 1920, --jpeg-quality 85) ; utilisez --no-compress pour conserver la qualité d'origine.
  • --max-width 0 signifie pas de redimensionnement.

3. Guide de réglage des paramètres

ProblèmeAjustement
Trop peu de pages extraitesAugmentez --similarity (0.8 → 0.85~0.9), réduisez --skip et --min-interval
Trop de pages en doubleRéduisez --similarity (0.8 → 0.7~0.75), augmentez --skip / --min-interval
Capture d'animations de transition / images flouesAugmentez --delay-frames (par ex. 8~12), gardez la vérification de stabilité activée
L'image est jugée instable en permanenceRéduisez --stable-threshold (0.95 → 0.9) ou ajoutez --no-stable-check
Sortie avec bords noirs--crop all ; si le bruit perturbe la détection, utilisez --crop-mode fixed avec les paramètres de marge
Contenu 4:3 mais sortie déforméeUtilisez --fit fit lors de l'assemblage
PDF trop volumineuxGardez la compression activée, réduisez --jpeg-quality (85→60) ou --max-width (1920→1280)
Traitement trop lentAugmentez --skip (par ex. 25), réduisez --resize (480→320), désactivez --verbose

La table complète des paramètres se trouve dans references/parameters.md (à lire uniquement si vous avez besoin de réglages fins).

4. Vérification des résultats et gestion des erreurs

  1. Vérifiez d'abord le code de retour : 0 succès ; 1 aucun résultat produit (0 images / entrée vide) ; 2 erreur de paramètres ; 3 dépendances manquantes ; 130 interruption.
  2. Avec --json, analysez stdout (les logs sont sur stderr), champs clés :
    • Extraction d'images : frames_saved, output_dir, errors
    • Pipeline : frames, outputs.pptx.slides, outputs.pdf.pages, errors
  3. Après succès, vérifiez que le fichier de sortie existe et a une taille > 0, puis rapportez à l'utilisateur le nombre de pages et le chemin absolu.
  4. Échecs courants :
    • Impossible d'ouvrir la vidéo : chemin contenant des caractères spéciaux ou encodage non supporté. Transcodez d'abord avec ffmpeg en H.264 MP4 : ffmpeg -i in.mov -c:v libx264 -c:a aac out.mp4.
    • frames_saved = 0 : Augmentez la sensibilité de similarité selon la section 3, puis réessayez.
    • Erreur OpenBLAS / allocation mémoire lors de l'import cv2/numpy : Le script définit déjà OPENBLAS_NUM_THREADS / OMP_NUM_THREADS à 1 pour éviter les échecs d'allocation de tampon de thread courants ; si l'erreur persiste, recréez l'environnement virtuel (python -m venv .venv puis réinstallez requirements.txt), ou python -m pip install --force-reinstall numpy opencv-python. check_env.py et le script d'extraction utilisent une détection isolée en sous-processus et signalent le problème par un code de retour 3 plutôt qu'un crash direct.
    • Chemins/logs chinois mal encodés : Le script force la sortie UTF-8 ; si le terminal affiche toujours des caractères illisibles, exécutez d'abord export PYTHONIOENCODING=utf-8 (Windows : set PYTHONIOENCODING=utf-8).
  5. N'utilisez pas l'interface graphique pour interagir avec les paramètres des fichiers ; tous les scripts de cette compétence sont sans interface et exécutables de manière répétée.

5. Variables d'environnement

Aucune variable d'environnement obligatoire ; les scripts ne contiennent pas de clés, mots de passe ou jetons codés en dur, et n'accèdent pas au réseau (sauf pip nécessaire lors de la première installation des dépendances).

Optionnel : OPENBLAS_NUM_THREADS, OMP_NUM_THREADS — le script les définit par défaut à 1 pour éviter les échecs d'allocation de tampon de thread OpenBLAS sur certaines machines Windows lors de import numpy/cv2 ; si la machine est stable, vous pouvez les augmenter (par ex. 8).

Skills associés