Que fait cli-anything-openscreen ?
Une interface en ligne de commande avec état pour éditer des enregistrements d'écran. Transformez des captures brutes en vidéos de démonstration soignées avec des effets de zoom, des ajustements de vitesse, du rognage, des annotations et de magnifiques arrière-plans.
Installation
pip install cli-anything-openscreen
Prérequis :
- Python 3.10+
- ffmpeg doit être installé sur votre système
Utilisation
Commandes de base
cli-anything-openscreen --help
cli-anything-openscreen # Mode REPL
cli-anything-openscreen project new -v enregistrement.mp4 -o projet.openscreen
cli-anything-openscreen --json project info
Mode REPL
Exécutez cli-anything-openscreen sans arguments pour entrer en mode interactif.
Tapez help pour les commandes disponibles, quit pour quitter.
Groupes de commandes
project
Créez, ouvrez, sauvegardez et configurez des projets.
| Commande | Description |
|---|---|
project new [-v VIDEO] [-o CHEMIN] | Créer un nouveau projet avec vidéo optionnelle |
project open <chemin> | Ouvrir un projet .openscreen existant |
project save [-o CHEMIN] | Sauvegarder le projet dans un fichier |
project info | Afficher les métadonnées du projet et le nombre de régions |
project set-video <chemin> | Définir le fichier vidéo source |
project set <clé> <valeur> | Définir un paramètre d'éditeur (padding, fond, etc.) |
zoom
Gérer les régions de zoom — effets de zoom fluides sur des zones temporelles spécifiques.
| Commande | Description |
|---|---|
zoom list | Lister toutes les régions de zoom |
zoom add --start MS --end MS [--depth 1-6] [--focus-x 0-1] [--focus-y 0-1] | Ajouter un zoom |
zoom remove <id> | Supprimer une région de zoom |
Profondeurs de zoom : 1=1,25x, 2=1,5x, 3=1,8x, 4=2,2x, 5=3,5x, 6=5,0x
speed
Gérer les régions de vitesse — accélérer les temps morts, ralentir les moments importants.
| Commande | Description |
|---|---|
speed list | Lister toutes les régions de vitesse |
speed add --start MS --end MS [--speed 0,25-2,0] | Ajouter un changement de vitesse |
speed remove <id> | Supprimer une région de vitesse |
Vitesses valides : 0,25, 0,5, 0,75, 1,25, 1,5, 1,75, 2,0
trim
Gérer les régions de rognage — couper des sections de l'enregistrement.
| Commande | Description |
|---|---|
trim list | Lister toutes les régions de rognage |
trim add --start MS --end MS | Couper une section |
trim remove <id> | Supprimer une région de rognage |
crop
Définir la zone visible de l'enregistrement.
| Commande | Description |
|---|---|
crop get | Afficher la région de recadrage actuelle |
crop set --x 0-1 --y 0-1 --width 0-1 --height 0-1 | Définir le recadrage (normalisé) |
annotation
Ajouter des superpositions de texte à l'enregistrement.
| Commande | Description |
|---|---|
annotation list | Lister toutes les annotations |
annotation add-text --start MS --end MS --text "..." [--x 0-1] [--y 0-1] | Ajouter du texte |
annotation remove <id> | Supprimer une annotation |
media
Inspecter et valider les fichiers médias.
| Commande | Description |
|---|---|
media probe <chemin> | Afficher les métadonnées vidéo (résolution, durée, codec) |
media check <chemin> | Valider un fichier vidéo |
media thumbnail <entrée> <sortie> [-t TEMPS] | Extraire une image |
export
Rendre la vidéo finale soignée.
| Commande | Description |
|---|---|
export presets | Lister les préréglages d'exportation disponibles |
export render <chemin_sortie> | Rendre le projet en fichier vidéo |
preview
Capturer des bundles de vérification fidèles depuis le projet Openscreen actuel.
| Commande | Description |
|---|---|
preview recipes | Lister les recettes de prévisualisation disponibles |
preview capture --recipe quick | Rendre un bundle de prévisualisation basse résolution |
preview latest [--recipe quick] | Retourner le dernier bundle existant |
La prévisualisation actuelle est statique plutôt qu'en direct. Un bundle quick contient typiquement :
- un clip de prévisualisation basse résolution
- des images échantillonnées
- une image
heropour inspection rapide summary.jsonavec les faits de rognage/zoom/vitesse
La capture du bundle écrit ou met également à jour un trajectory.json stable au niveau de la recette à côté de la racine de prévisualisation, permettant aux agents de reconstruire l'historique des prévisualisations au fil du temps.
Commandes de visualisation :
cli-hub previews inspect /chemin/vers/bundle
cli-hub previews html /chemin/vers/bundle -o page.html
cli-hub previews open /chemin/vers/bundle
session
Gérer l'état de la session avec annulation/rétablissement.
| Commande | Description |
|---|---|
session status | Afficher les informations de session |
session undo | Annuler la dernière opération |
session redo | Rétablir la dernière opération annulée |
session save | Sauvegarder l'état de la session sur le disque |
session list | Lister toutes les sessions sauvegardées |
Gestion de l'état
- Annuler/Rétablir: Jusqu'à 50 niveaux d'historique d'annulation
- Persistance du projet: Fichiers JSON
.openscreen - Suivi de session: suivi automatique des modifications
Formats de sortie
- Lisible par l'humain (par défaut) : paires clé-valeur formatées
- Lisible par machine (
--json) : sortie JSON structurée
Paramètres de l'éditeur
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
aspectRatio | string | "16:9" | 16:9, 9:16, 1:1, 4:3, 4:5 |
wallpaper | string | "gradient_dark" | Préréglage d'arrière-plan |
padding | int | 50 | 0-100, espacement autour de la vidéo |
borderRadius | int | 12 | Rayon des coins en pixels |
shadowIntensity | float | 0 | 0-1, force de l'ombre portée |
motionBlurAmount | float | 0 | 0-1, flou de mouvement pendant le zoom |
exportQuality | string | "good" | medium, good, source |
exportFormat | string | "mp4" | mp4, gif |
Pour les agents IA
- Utilisez toujours
--jsonpour une sortie parseable - Vérifiez les codes de retour — 0 = succès, non-nul = erreur
- Analysez stderr pour les messages d'erreur en mode non-JSON
- Utilisez des chemins de fichiers absolus
- Après
export render, vérifiez que la sortie existe et sondez-la - Les temps sont en millisecondes pour toutes les commandes de régions
- Les coordonnées (focus, recadrage, position) sont normalisées 0-1
- Utilisez
preview capture --jsonpour valider visuellement le zoom, le rognage, les annotations et le timing - Lisez les chemins des artefacts du bundle retournés depuis la charge utile JSON ; les images et les clips résident sur le disque
- Utilisez
cli-hub previews ...uniquement pour inspecter/ouvrir des bundles existants
Version
1.0.0