CommunityImagegithub.com

shootpack

Traite un dossier de prise de vue immobilière (DJI drone et/ou appareil photo comme le Sony A1 II, mixte accepté) en livrables client en une seule étape — photos HDR à partir des bracketing RAW (LightCraft), sélection/alternatives, et une vidéo de 60 s étalonnée Rec.709. Utilisez-le lorsque l'utilisateur pointe un dossier de prise de vue (« traite ce dossier », « prépare Maginot », « lance shootpack sur ~/Desktop/X »).

Qu'est-ce que shootpack ?

shootpack est une pipeline automatisée pour les photographes et vidéastes immobilières qui transforme un dossier brut de prise de vue (DJI Mavic 4 Pro, Sony A1 II, Fujifilm X-E4, DJI Osmo 360 II) en livrables clients complets : photos HDR, sélection d'images (picks/alternatives) et une vidéo de 60 secondes étalonnée en Rec.709. Le pipeline détecte automatiquement chaque appareil via les métadonnées EXIF et applique des profils spécifiques (correction des couleurs, développement RAW, courbes log). Il gère les bracketing multi-exposition, les vidéos à courbes log (D-Log, S-Log3, F-Log), les fichiers 360° et les enregistrements double carte. L'utilisateur lance simplement `shootpack <dossier>` et reçoit les livrables dans un dossier `Deliverables/`, avec un rapport de synthèse. Le système gère également la sélection automatique (cull), mais demande une validation visuelle pour détecter les problèmes de cadre, les personnes ou les doublons. Pour les vidéos, il génère une storyboard, permet de remplacer des plans et d'ajuster la musique (Epidemic Sound) avec des coupes calées sur les temps forts. L'étalonnage utilise les LUT officielles des fabricants ou des LUT maison, en appliquant l'exposition avant la LUT pour éviter les écrasements. Le tout est suivi par des mises à jour de progression (manifest.json, pages web, comparaisons vidéo). La pipeline est conçue pour les utilisateurs avancés qui manipulent des dossiers de prise de vue bruts et veulent un résultat professionnel sans interventions manuelles répétitives.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattgiss/shootpack/tree/main/skill

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait shootpack ?

La pipeline vit dans ~/shootpack (dépôt git). Point d'entrée : shootpack <dossier> [--ceiling M] [--picks N] [--length S] [--log COURBE] [--latlon LAT,LON] [--plan]. Lancez de nouvelles prises de vue avec --plan (inventaire, sélection et plan d'édition, sans exportations).

Appareils

L'appareil de chaque fichier est détecté (EXIF Make/Model, tags encodeur/modèle vidéo, sidecars) et lu avec son profil dans devices/<id>.json ; les appareils inconnus utilisent devices/generic.json. La première ligne du log liste ce qui a été trouvé (appareils : DJI Mavic 4 Pro (200 photos, 8 clips), Sony A1 II (...)) — vérifiez-la.

  • DJI Mavic 4 Pro (dji_mavic4pro) : géométrie drone XMP → détection solaire, sélection basée sur le cadrage, drapeaux de plafond, vidéo altitude ; télémétrie SRT, proxies LRF.
  • Sony A1 II (sony_a1ii, EXIF Model ILCE-1M2) : bracketing ARW (+ paires JPG/HEIF, également entre cartes) groupés par correction d'exposition + mode drive ; sidecars XML des clips (C0001M01.XML) donnent l'heure de début, la fréquence d'images, le gamma et le gamut ; SUB/proxies. Pas de géométrie d'appareil : pas de profil solaire automatique (définissez "sun" dans cull.json manuellement), la sélection se fait par contenu d'image (images quasi identiques = doublons) et nomme les plans par objectif (24mm, 70mm-portrait).
  • Fujifilm X-E4 (fujifilm_xe4, EXIF Model X-E4 sur RAF, JPG et MP4) : images uniques, paires RAF + JPG. Le JPG est le rendu de la recette (Classic Chrome etc. ; la recette est dans l'EXIF du RAF, voir photo.recipe_tags) ; le développement RAF propre à LightCraft est sombre et plat et l'ignore, donc adaptez un profil de développement au JPEG de l'appareil avant d'exporter. Les clips dans le même dossier DCIM, pas de sidecars ; les clips avec simulation de film sont Rec.709 (look uniquement, pas de LUT technique), le F-Log est détecté à partir du signal. Déchargement : shootpack offload <carte> --appareil XE4 (dossier Drops/XE4/). Développement : recipe_fit.py fit LUT.npz RAF=JPG,... sur les paires de la prise de vue (associez RAF et JPG par heure de capture : les numéros peuvent différer d'un), puis fuji_develop.py batch LUT.npz cull.json <rép. DCIM> Deliverables/Photos (les clés de cull.json sont le numéro JPEG -> {raf, jpg, name}). L'horloge de l'appareil peut être sur l'heure du domicile (un mariage : -06:00, local = +8 h). Les clips d'événement avec son live : clip_edit.py edits/<spec>.json Video/<name>_4K.mp4 (pas de musique, coupe audio en L ; stabilisation désactivée sauf si motion.py prouve qu'elle aide). Voir agent-docs/photos/fuji-recipe.md.
  • DJI Osmo 360 II (dji_osmo360ii, .OSV trouvé par le tag Encodeur MP4 Osmo 360 II) : deux flux fisheye, donc ses clips sont mis de côté (le log dit "N clip(s) 360 ... traitez-les avec osmo360.py") et n'atteignent jamais l'édition immobilière. osmo360.py CLIP.OSV Deliverables/Video écrit un recadrage plat étalonné (mouvement keyframe) et un équirectangulaire 360 étalonné. L'assemblage n'est pas calibré et l'horizon n'est pas nivelé ; les lentilles sont assorties en gain dans le chevauchement. Le mode couleur est lu à partir du signal dans les cercles d'image (Normal vs D-Log M, vérifié sur des vrais clips des deux). D-Log M reçoit une LUT provisoire adaptée au propre proxy de l'appareil (luts/interim_dlogm_to_709_osmo360ii.cube) jusqu'à ce que la LUT DJI Osmo 360 D-Log M soit dans luts/official/. --spec edits/osmo_car_v1.json rend un extrait keyframé d'un long clip (un recadrage serré et relevé en exposition du conducteur dans le test voiture). Un recadrage plat a 18.6 x h_fov pixels réels : 4K d'un recadrage serré est upscalé (agent-docs/video/osmo360.md). L'appareil a un stockage interne et une carte SD (deux volumes). Déchargement : shootpack offload <carte> se trouve lui-même (Drops/Osmo360/).
  • Enregistrement double slot : les fichiers identiques sur les deux cartes sont détectés (nom + heure de capture + taille, puis hash) et la copie du slot-1 est utilisée ; le log indique combien ont été ignorés.
  • Pas de GPS nulle part (prise de vue appareil uniquement) : les sessions sont nommées par l'heure de l'horloge locale (Matin < 10:00, Midi < 15:00, Après-midi < 17:30, Soir), et l'étalonnage suit le nom (Midi/Après-midi : look midi ; sinon look doré). Passez --latlon pour les nommer d'après le soleil à la place. Les plans Sony n'ont pas de géométrie, donc les plans de soleil n'obtiennent pas de profil solaire automatique : définissez "sun": {"G18": "A"} dans cull.json manuellement (le développement automatique remonte un cadre sombre avec un filtre solaire).
  • Un nouvel appareil : copiez le profil le plus proche, modifiez detect.models, capteur/FOV, règle de bracketing et courbes log.

Étapes

  1. Lancez-le. shootpack "<dossier>" --ceiling <plafond LAANC/espace aérien de l'utilisateur, défaut 120> en arrière-plan (photos ≈ 25 s par bracketing, vidéo ≈ 4 min). Il met tout en cache dans <dossier>/Deliverables/_shootpack/.
  2. Vérifiez visuellement la sélection — ouvrez Deliverables/_shootpack/<session>/all_stations.jpg et chaque Deliverables/Photos/<session>/Picks_contact_sheet.jpg. La sélection automatique ne voit pas le contenu, donc vérifiez et corrigez :
    • la maison coupée au bord du cadre → déplacez-la dans les rejets
    • une personne (souvent le pilote en hi-vis) dans le cadre → alternatives, notez "PERSON-IN-FRAME"
    • quasi-doublons / répétitions ennuyeuses → alternatives ; les bonnes images laissées dans les alternatives → sélections
    • les images au-dessus du plafond sont déjà signalées dans les alternatives — mentionnez-les, ne les cachez pas Modifiez <session>/cull.json (clés G01… ; valeurs = noms courts), supprimez les sorties affectées, relancez avec --only photos. Plans de soleil sont détectés automatiquement (soleil dans le cadre par géométrie solaire + encore écrêté dans le bracket le plus sombre) et développés avec un profil solaire : A = le soleil est le sujet (-1,9 stops vs auto), C = la maison est le sujet (-0,6 stops, la maison reste lumineuse). Surchargez par image dans cull.json : "sun": {"G21": "A", "G07": "off"}. Starbursts : si une image du bracket montre des rayons de diffraction nets autour d'un disque solaire visible (regardez le soleil dans chaque image), ajoutez "starburst": {"G21": "0209"} (numéro d'image) et relancez --only photos --redo ; jamais pour les soleils derrière un nuage (ces rayons sont des faisceaux de lumière et survivent déjà à la fusion). Vérifiez les plans de soleil pour les nuages roses écrêtés.
  3. Vérifiez la vidéo — ouvrez Deliverables/Video/*_storyboard.jpg (une image toutes les 3 s). Remplacez les plans qui sont décollage/atterrissage, le pilote, trop sombres ou répétitifs en éditant Deliverables/_shootpack/edit.json (clip, début, longueur, vitesse, exposition en stops) et relancez --only video. Utilisez les proxies des clips (DJI .LRF, Sony SUB/) et les DJI .SRT (rel_alt, position) pour trouver de meilleurs moments. Les clips d'appareil photo n'ont pas de télémétrie, donc le recadrage de décollage/atterrissage et les bandes d'altitude ne s'appliquent pas ; les clips 24p/30p ne sont jamais ralentis (seuls le 50p+ peuvent alimenter le slow motion).
  4. Étalonnez — avec la LUT officielle DJI dans ~/shootpack/luts/official/ (Maginot : "DJI Mavic 4 Pro D-Log to Rec.709 V1.cube"), chaque plan reçoit la LUT DJI comme base technique plus notre look créatif par-dessus : luts/looks/dlog_golden_* (heure dorée : plus chaud, bleu plus calme, ombres ouvertes) ou dlog_midday_* (plus de contraste/dynamisme). luts/looks/make_looks.sh les reconstruit (build_look.py : _input.cube = LUT officielle avec l'exposition appliquée en log, pour le slot Input de FilmCraft ; _look.cube = Rec.709→Rec.709 pour le slot Creative ; _composed.cube = les deux, pour ffmpeg). Mettez les corrections d'exposition AVANT la LUT officielle (--pre-exposure, stops en log) : la LUT DJI est plus sombre que ses propres JPEG, et corriger après écrête les ciels (la version 5 de Maginot était 30-50% trop sombre à cause de cela). Sans LUT officielle, les warm_print_v6 / warm_print_midday_v2 basées sur les courbes sont utilisées. Vérifiez toujours qu'une nouvelle LUT officielle correspond au profil de la vidéo (voir ci-dessous).
  5. Musique (bande-annonce) — Epidemic Sound via le connecteur OAuth de l'utilisateur (jamais de clé API). Cherchez des pistes instrumentales "build" dont la longueur de mesure correspond aux coupes du montage (75 BPM = mesures de 3,2 s) et lisez la courbe d'énergie de chaque forme d'onde : vous voulez une intro calme, une longue montée et une grosse chute. DownloadRecording (WAV, FULL) dans Deliverables/Music/, puis music.analyze(wav, bpm_donné) : vérifiez que la chute tombe sur un downbeat (la phase on/off-beat de la grille vient de la kick/basse, la phase de mesure du plus grand saut de basses). Choisissez des sauts X→Y où la similarité bar_chroma de la mesure Y à la mesure X+1 est >= 0,9 (mêmes accords, pas de coupure audible). Chronométrez l'image en frames entières sur la grille de mesure (modèle : edits/make_trailer_v7.py) : coupes sur les downbeats, final sur la chute, carte de fin sur la release. trailer.py muxe spec["music"] dans chaque sortie ; --music-only réédite et remuxe sans re-rendu ; --size 1920x1080 fait une vérification de timing de 5 minutes (mesurez les coupes contre les beats avant le rendu 6K). Goût client (shoot de référence, v8-v11) : plein 16:9 sans letterbox ("letterbox": null), pas de cartes de texte, pas de fondus ou de noir, coupes dures sur le beat, fin sur le dernier plan (un "end_fade" de 1 s sous la queue de la musique est correct). Lissez les plans avec "stabilize" : un nombre = sigma gaussien en s (1-2), {"poly": 2} = un mouvement régulier. Sans letterbox, chaque correction verticale coûte du zoom, donc gardez sigma modéré (le final du shoot de référence : 1,25 = 6,6% de zoom, 2,0 serait 12%) ; "reframe_y" n'aide qu'avec un letterbox. Pour garder plus de la maison à la fin d'un mouvement, ralentissez le plan pour qu'il se termine plus tôt. Mesurez le tremblement sur le rendu (stabilize.track sur l'aperçu) avant et après ; un arrêt-reprise du drone ne peut être qu'adouci (sigma plus lourd + 0,85x), pas supprimé. Le EditRecording d'Epidemic n'a jamais retourné d'édition quand requiredRegionsAtOffsets était défini, et son édition non contrainte de 60 s a supprimé la chute (Oct 2026), donc nous coupons la piste nous-mêmes. Le travail client nécessite un plan commercial Epidemic ; demandez.
  6. Livrez — envoyez les planches-contact des sélections, l'aperçu 720p (<30 Mo) et la storyboard avec SendUserFile ; résumez à partir de Deliverables/SUMMARY.md (comptes, drapeaux, ce qui est provisoire). Validez toute modification de code réutilisable dans le dépôt.

Afficher la progression

Pour chaque changement, donnez un avant/après : mettez à jour review_site/<shoot>/progress/*/manifest.json (étalonnage / photos / détail / coupe / musique) et reconstruisez avec progress_page.py (progress_music.py dessine le graphique d'adéquation musicale) ; envoyez une feuille adaptée au mobile ou une vidéo de comparaison empilée avec SendUserFile.

Faits importants

  • Développez toujours à partir des raws (DJI DNG, Sony ARW) ; les JPG ne sont que métadonnée/référence. Les images sans ARW obtiennent un JPEG de référence extrait du raw dans _shootpack/previews/. LightCraft rend les ARW avec un look adapté au propre JPEG de Sony (pas le neutre muet par défaut) mais n'a pas de profils d'objectif Sony : distorsion/vignetage restent tels quels. Sa fusion HDR des ARW écrit un DNG sans matrice de couleur ni balance des blancs (rend vert) : la pipeline écrit la calibration de l'appareil (ColorMatrix1 de la table Adobe dérivée de LibRaw via rawpy, AsShotNeutral du plan) et développe ce fichier, donc les fichiers HDR_DNG/ des brackets Sony s'ouvrent avec la bonne couleur dans tout éditeur raw.
  • LightCraft écrit *-HDR.dng à côté de sa source ; la pipeline les déplace dans Deliverables/HDR_DNG/. Ne modifiez jamais les originaux.
  • Les MP4 DJI sont stockés pivotés (rotation=-90) ; ffprobe rapporte des dimensions portrait mais ils se lisent en paysage.
  • Cartes Sony : copiez l'arborescence entière DCIM/ + PRIVATE/ par slot (le Finder ne peut pas monter un appareil en mode MTP — utilisez un lecteur de carte ou USB Mass Storage) ; sans les sidecars M01.XML, le gamma/gamut des clips retombe sur le seul signal.
  • SRT DiffTime: 16ms = 59,94p → conformez à moitié vitesse à 29,97 pour les orbites fluides.
  • Les courbes log sont décidées par clip à partir du signal : la distribution des valeurs de code de luminance d'environ 10 images (p95 = où se situent les blancs) est vérifiée par rapport à la bande de chaque courbe dans le profil, puis à l'étiquette de l'appareil (DJI SRT color_md, Sony XML CaptureGammaEquation), puis à --log. Ordre de confiance : un --log explicite, puis le signal, puis l'étiquette. Tout désaccord est un AVERTISSEMENT dans le log et dans SUMMARY.md — lisez-le avant de rendre. D-Log vs D-Log M : en plein jour, D-Log maintient les blancs autour de 0,55 code (super-blancs au-dessus pour ciel/soleil ; Maginot p95 0,44-0,69) ; D-Log M les met autour de 0,8+. Une LUT D-Log M sur une vidéo D-Log rend les blancs en ~50% gris (plat, terne) — Maginot était D-Log. Trop sombre (nuit) ou entre bandes = non concluant → l'étiquette décide. _shootpack/log/*.json met en cache les stats.
  • Correspondance LUT par appareil/courbe/gamut : LUT officielles dans luts/official/ par tokens de nom de fichier normalisés ("D-Log M" compte comme D-Log M ; une LUT Mavic 4 Pro l'emporte sur les autres LUT DJI). DJI sans LUT officielle : étalonnages chauds basés sur les courbes. Sony S-Log3 : builtin:slog3-sgamut3cine-to-rec709 intégré de FilmCraft (ou -sgamut3-, d'après le CaptureColorPrimaries du XML), exporté dans luts/builtin/ ; nos looks D-Log sont recomposés dessus comme luts/looks/slog3_*_composed.cube, avec la pré-exposition adaptée pour que le gris 18% tombe là où la LUT d'entrée DJI le met (les éditions mixtes DJI + Sony correspondent). Les clips S-Cinetone/Rec.709/HLG n'ont pas besoin de décodage : le _look.cube seul.
  • L'exposition dans edit.json est corrigée en valeurs de code par stop de la courbe du clip (lift : D-Log 67, S-Log3 79).
  • Plans de soleil LightCraft : gardez light.whites à 0 et light.highlights à -60 ou plus doux ; une récupération plus forte ou une teinte magenta tire les nuages écrêtés en dessous du blanc et ils deviennent roses.
  • Rendu 6K : trailer.py rend par sections (coupure aux coupes dures et aux noirs) — 14 décodages 6K parallèles épuisent la mémoire sur 16 Go.
  • Surveillez l'espace disque libre : chaque DNG HDR ≈ 300 Mo ; la pipeline s'arrête sous 5 Go libres.

Skills associés