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 :
| Script | Rôle | Scénario typique |
|---|---|---|
scripts/video2ppt.py | Pipeline tout-en-un : vidéo → images → PPTX/PDF | L'utilisateur ne veut que le PPT/PDF final (à utiliser en priorité) |
scripts/video_to_frames.py | Extraction intelligente des images d'une vidéo, sortie d'une séquence d'images | L'utilisateur a besoin de captures d'écran ou veut trier manuellement avant l'assemblage |
scripts/images_to_pptx.py | Dossier d'images → PPTX | L'utilisateur a déjà des captures/images et veut créer une présentation |
scripts/images_to_pdf.py | Dossier d'images → PDF | L'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
-opeut être omis, la sortie par défaut estframes/dans le répertoire de la première vidéo.- Paramètres clés :
--start/--end(secondes ouHH: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-compresspour conserver la qualité d'origine. --max-width 0signifie pas de redimensionnement.
3. Guide de réglage des paramètres
| Problème | Ajustement |
|---|---|
| Trop peu de pages extraites | Augmentez --similarity (0.8 → 0.85~0.9), réduisez --skip et --min-interval |
| Trop de pages en double | Réduisez --similarity (0.8 → 0.7~0.75), augmentez --skip / --min-interval |
| Capture d'animations de transition / images floues | Augmentez --delay-frames (par ex. 8~12), gardez la vérification de stabilité activée |
| L'image est jugée instable en permanence | Ré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ée | Utilisez --fit fit lors de l'assemblage |
| PDF trop volumineux | Gardez la compression activée, réduisez --jpeg-quality (85→60) ou --max-width (1920→1280) |
| Traitement trop lent | Augmentez --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
- Vérifiez d'abord le code de retour :
0succès ;1aucun résultat produit (0 images / entrée vide) ;2erreur de paramètres ;3dépendances manquantes ;130interruption. - 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
- Extraction d'images :
- 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.
- É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 .venvpuis réinstallezrequirements.txt), oupython -m pip install --force-reinstall numpy opencv-python.check_env.pyet 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).
- 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 :
- 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).