pellipop 0.8.12

A graphical and command-line tool to extract key frames from videos along with their retranscription. It uses the Whisper API to transcribe the audio. It also generates a CSV file with the extracted key frames and their corresponding text.

Pellipop

This readme is also available in English

Table des matières

1. Description
2. Installation
   1. PyPi
   2. Exécutable
   3. Développement
3. Usage
   1. Interface graphique
   2. Ligne de commande
4. License

Description

Pellipop est un outil de découpe de vidéos en images fixes, avec extraction de texte et audio. Il permet de découper des vidéos en images fixes, en extrayant le texte et l'audio des vidéos. Il permet également d'obtenir un fichier csv contenant les informations des images extraites et facilitant l'exportation des données dans des logiciels de traitement de corpus d'image, comme Panoptic.

Il prend en entrée les formats suivants:

• ".mov"
• ".avi"
• ".mp4"
• ".flv"
• ".wmv"
• ".webm"
• ".mkv"
• ".svf"

Installation

PyPi

Pellipop est disponible sur PyPi, vous pouvez l'installer avec pip à l'aide de la commande suivante:

pip install pellipop

Vous pouvez ensuite vérifier que l'installation s'est bien passée en lançant la commande pellipop --version Une fois installé, vous pouvez lancer l'interface graphique avec la commande pellipop.

Exécutable

Des exécutables sont disponibles pour Windows, MacOS et Linux sur la page de releases. Vous pouvez télécharger l'exécutable correspondant à votre système d'exploitation, et lancer l'interface graphique en double-cliquant dessus.

Développement

Pour installer Pellipop en mode développement, vous pouvez cloner le dépôt git et installer les dépendances avec pip:

git clone https://github.com/CERES-Sorbonne/Pellipop.git.
cd Pellipop
pip install -e .

Usage

Interface graphique

Elle se lance avec pellipop, sans aucun argument, pour ouvrir l'interface graphique.

Alternativement, vous pouvez télécharger l'executable correspondant à votre système d'exploitation sur la page de releases.

Ligne de commande

La cli se lance avec pellipop dans un terminal, par défaut les vidéos sont cherchées dans le dossier où la commande est lancée, et les images créées sont également stockées au même endroit. Les paramètres peuvent toutefois être changés:

• --input : pour spécifier le dossier d'entrée où chercher les vidéos (recursif)

• --output : pour spécifier l'endroit où stocker les images en sortie

• --interval : intervalle de temps (en secondes) à laquelle réaliser des captures d'écran

• --i-frame-mode : permet de supprimer les doublons d'images pour un même film en utilisant les images clés ( keyframes) de la vidéo

• --keep-audio : permet de garder les fichiers audio extraits des vidéos

• --whisper-config : pour préciser le chemin vers le fichier de configuration de l'API Whisper, au lieu du chemin par défaut (~\.whisperrc)

• --frames-only : permet de ne pas extraire le texte des vidéos

• --reduce : permet de réduire le nom des fichiers de sortie à un certain nombre de caractères du nom original

• --offset : permet de décaler le début du nom des fichiers de sortie de n caractères

• --parents-in-name : permet d'ajouter le nom des dossiers parents dans le nom des fichiers de sortie, séparés par des _

• -g ou --gui : permet d'utiliser l'interface graphique

• -v ou --version : affiche la version de l'installation actuelle de Pellipop

Note: Le temps de découpe de chaque vidéo dépend de la qualité de la vidéo découpée, de la fréquence de découpe, de la durée de la vidéo et de la puissance de l'ordinateur.

Exemple d'usage:

pellipop --input C:\Users\Utilisateur\Videos\Captures --output D:\Users\Bureau\Output --i-frame-mode

License

Ce projet est sous licence MPL-2.0 - voir le fichier LICENSE pour plus de détails.