yojuhsu/video-cut

Que fait video-cut ?

Transformez automatiquement votre photothèque macOS en courtes vidéos montées, sous-titrées et avec musique de fond, en utilisant les données GPS et temporelles de vos trajets.

Description

yojuhsu/video-cut est une compétence pour Claude Code qui permet de créer des courts métrages à partir de votre photothèque macOS. En analysant les données GPS et les horodatages de vos photos, elle reconstitue fidèlement vos itinéraires de voyage (par exemple, un séjour de 3 jours à Tokyo), sélectionne les meilleures photos, les assemble chronologiquement, ajoute des transitions fluides, génère des sous-titres informatifs (noms de lieux, dates) et intègre une bande sonore générée par IA via Suno.

Fonctionnalités

• Analyse automatique : Parcourt la photothèque Photos.app pour identifier les photos et vidéos selon des filtres (type de média, date).
• Reconstitution d'itinéraire : Utilise les métadonnées GPS et temporelles pour créer un récit de voyage cohérent.
• Montage vidéo : Assemble les images en séquence avec des transitions personnalisées (fondu, zoom, etc.).
• Sous-titres intelligents : Ajoute des légendes avec noms de lieux et dates extraits des métadonnées.
• Bande sonore IA : Génère une musique de fond adaptée via l'API Suno pour une ambiance immersive.
• Sortie MP4 : Exporte le résultat en vidéo haute résolution, prête au partage.

Prérequis

• macOS 12 ou ultérieur
• Claude Code avec accès à la ligne de commande
• Une photothèque macOS synchronisée (locale ou iCloud)
• (Optionnel) Clé API Suno pour la musique générée

Installation

1. Clonez le dépôt :

   git clone https://github.com/yojuhsu/video-cut.git
   cd video-cut
   

2. Installez les dépendances (si nécessaire) :

   pip install -r requirements.txt  # ou npm install selon le langage principal
   

3. Configurez vos API keys dans un fichier .env :

   SUNO_API_KEY=votre_cle_ici
   

Utilisation

Lancez la compétence depuis Claude Code en utilisant une commande similaire à :

claude run video-cut --trip "Tokyo" --max-duration 60

Les paramètres disponibles incluent :

• --trip : Nom ou période de voyage (ex: "Tokyo 2024-03-01 2024-03-05")
• --max-duration : Durée maximale de la vidéo en secondes
• --media-type : "image" ou "video" pour filtrer le type de média
• --output : Chemin du fichier de sortie (par défaut : output.mp4)

Exemple :

claude run video-cut --trip "Paris 2023-09-10" --max-duration 30 --media-type image

Comment ça marche

1. Scan de la photothèque : La compétence utilise osascript pour accéder à Photos.app et extraire les métadonnées (GPS, date, orientation).
2. Regroupement par voyage : Les photos sont regroupées par segments temporels et spatiaux pour identifier les voyages.
3. Sélection des meilleures images : Un algorithme de scoring évalue la netteté, l'exposition et la composition.
4. Montage : Utilisation de ffmpeg pour l'encodage vidéo, avec des transitions personnalisées.
5. Sous-titres : Génération de sous-titres basée sur les noms de lieux (via reverse geocoding) et les dates.
6. Musique : Appel à l'API Suno pour générer une bande sonore adaptée au thème du voyage.
7. Export : Assemblage final en MP4 avec résolution configurable.

Exemple de sortie

Après exécution, vous obtiendrez un fichier comme :

output.mp4

Contenant une vidéo de 30 secondes montrant vos photos de Paris avec des sous-titres "Tour Eiffel - 10/09/2023", "Louvre - 11/09/2023" et une musique de fond douce.

Dépannage

• Erreur d'accès à la photothèque : Vérifiez que Photos.app a les autorisations nécessaires dans Réglages Système > Confidentialité > Photos.
• Aucune photo trouvée : Assurez-vous que la période spécifiée correspond à des données dans votre photothèque.
• Musique non générée : Vérifiez votre clé API Suno et votre quota.

Licence

MIT (ou autre selon le projet original)

---

Créé par yojuhsu - Transformez vos souvenirs en vidéos avec Claude Code.