Que fait cli-anything-kdenlive ?
Une interface en ligne de commande avec état pour l'édition vidéo, suivant les mêmes modèles que le Blender CLI. Utilise un format de projet JSON avec génération MLT XML pour Kdenlive/melt.
Installation
Cette CLI est installée dans le cadre du paquet cli-anything-kdenlive :
pip install cli-anything-kdenlive
Prérequis :
- Python 3.10+
- kdenlive doit être installé sur votre système
Utilisation
Commandes de base
# Afficher l'aide
cli-anything-kdenlive --help
# Démarrer le mode REPL interactif
cli-anything-kdenlive
# Créer un nouveau projet
cli-anything-kdenlive project new -o project.json
# Exécuter avec sortie JSON (pour consommation par un agent)
cli-anything-kdenlive --json project info -p project.json
Mode REPL
Lorsqu'elle est invoquée sans sous-commande, la CLI entre dans une session REPL interactive :
cli-anything-kdenlive
# Entrez les commandes de manière interactive avec autocomplétion et historique
Groupes de commandes
Projet
Commandes de gestion de projet.
| Commande | Description |
|---|---|
new | Créer un nouveau projet |
open | Ouvrir un projet existant |
save | Enregistrer le projet actuel |
info | Afficher les informations du projet |
profiles | Lister les profils vidéo disponibles |
json | Afficher le JSON brut du projet |
Groupe Bin
Commandes de gestion du bac multimédia.
| Commande | Description |
|---|---|
import | Importer un clip dans le bac multimédia |
remove | Supprimer un clip du bac |
list | Lister tous les clips du bac |
get | Obtenir des informations détaillées sur un clip |
Timeline
Commandes de gestion de la timeline.
| Commande | Description |
|---|---|
add-track | Ajouter une piste à la timeline |
remove-track | Supprimer une piste |
add-clip | Ajouter un clip sur une piste |
remove-clip | Supprimer un clip d'une piste |
trim | Rogner les points d'entrée/sortie d'un clip |
split | Diviser un clip à un décalage temporel |
move | Déplacer un clip vers une nouvelle position |
list | Lister toutes les pistes |
Groupe Filtre
Commandes de gestion des filtres/effets.
| Commande | Description |
|---|---|
add | Ajouter un filtre à un clip |
remove | Supprimer un filtre d'un clip |
set | Définir un paramètre de filtre |
list | Lister les filtres d'un clip |
available | Lister tous les filtres disponibles |
Transition
Commandes de gestion des transitions.
| Commande | Description |
|---|---|
add | Ajouter une transition entre pistes |
remove | Supprimer une transition |
set | Définir un paramètre de transition |
list | Lister toutes les transitions |
Guide
Commandes de gestion des guides/marqueurs.
| Commande | Description |
|---|---|
add | Ajouter un guide à une position (secondes) |
remove | Supprimer un guide |
list | Lister tous les guides |
Export
Commandes d'exportation et de rendu.
| Commande | Description |
|---|---|
xml | Générer du XML Kdenlive/MLT |
presets | Lister les préréglages de rendu disponibles |
Session
Commandes de gestion de session.
| Commande | Description |
|---|---|
status | Afficher l'état de la session |
undo | Annuler la dernière opération |
redo | Rétablir la dernière opération annulée |
history | Afficher l'historique des annulations |
Exemples
Créer un nouveau projet
Crée un nouveau fichier de projet kdenlive.
cli-anything-kdenlive project new -o myproject.json
# Ou avec sortie JSON pour une utilisation programmatique
cli-anything-kdenlive --json project new -o myproject.json
Session REPL interactive
Démarrer une session interactive avec support d'annulation/rétablissement.
cli-anything-kdenlive
# Entrez les commandes de manière interactive
# Utilisez 'help' pour voir les commandes disponibles
# Utilisez 'undo' et 'redo' pour la navigation dans l'historique
Exporter le projet
Exporte le projet vers un format de sortie final.
cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite
Gestion de l'état
La CLI maintient l'état de la session avec :
- Annulation/Rétablissement : Jusqu'à 50 niveaux d'historique
- Persistance du projet : Enregistrer/charger l'état du projet au format JSON
- Suivi de session : Suivre les modifications et les changements
Formats de sortie
Toutes les commandes prennent en charge deux modes de sortie :
- Lisible par l'humain (par défaut) : Tableaux, couleurs, texte formaté
- Lisible par machine (drapeau
--json) : JSON structuré pour consommation par un agent
# Sortie humaine
cli-anything-kdenlive project info -p project.json
# Sortie JSON pour les agents
cli-anything-kdenlive --json project info -p project.json
Pour les agents IA
Lorsque vous utilisez cette CLI de manière programmatique :
- Utilisez toujours le drapeau
--jsonpour une sortie analysable - Vérifiez les codes de retour - 0 pour succès, non nul pour erreurs
- Analysez stderr pour les messages d'erreur en cas d'échec
- Utilisez des chemins absolus pour toutes les opérations sur fichiers
- Vérifiez que les sorties existent après les opérations d'exportation
Plus d'informations
- Documentation complète : Voir README.md dans le paquet
- Couverture de test : Voir TEST.md dans le paquet
- Méthodologie : Voir HARNESS.md dans le paquet cli-anything-plugin
Version
1.0.0