Skip to main content

Pellipop

PyPI - Version PyPI - Python Version

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.

Metadata

Release files for pellipop 0.9.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pellipop 0.9.3
File Size Uploaded
pellipop-0.9.3.tar.gz 52.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pellipop 0.9.3
File Interpreter ABI Platform
pellipop-0.9.3-py3-none-any.whl Python 3 none any Details

Total release size: 105.9 kB

Release files / pellipop-0.9.3.tar.gz

Download URL pellipop-0.9.3.tar.gz
Size 52.9 kB
Tags Source
SHA-256 checksum
How to use checksums
7bca89453d0284ad4eadfe5b4ee3856763f938b172ccfb67fca2efe4906c6c66
BLAKE2b-256 checksum
How to use checksums
57d9ee8b50d039545c3f18179e9bbfc029c8d0e8fa504a3019125d51f70097f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release files / pellipop-0.9.3-py3-none-any.whl

Download URL pellipop-0.9.3-py3-none-any.whl
Size 53.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
173db05a85f0088a8c1c6fa8fc79805caf4b9a70b651dfec7539de6fb8899cd7
BLAKE2b-256 checksum
How to use checksums
c172ef701a277bca99d4069927d4d593c63b6d2747287fe2589ed3e7216ed76c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release history Release notifications | RSS feed

This release

0.9.3 This release

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.18

2 release files

0.8.17

2 release files

0.8.16

2 release files

0.8.15

2 release files

0.8.14

2 release files

0.8.11

2 release files

0.8.10

2 release files

0.8.9

2 release files

0.8.8

2 release files

0.8.7

2 release files

0.8.6

2 release files

0.8.5

2 release files

0.8.4

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.9

2 release files

0.6.8

2 release files

0.6.7

2 release files

0.6.6

2 release files

0.6.5

2 release files

0.6.4

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.4.15

2 release files

0.4.9

2 release files

0.4.8

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page