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, voirphoto.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(dossierDrops/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), puisfuji_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,.OSVtrouvé par le tag Encodeur MP4Osmo 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 dansluts/official/.--spec edits/osmo_car_v1.jsonrend un extrait keyframé d'un long clip (un recadrage serré et relevé en exposition du conducteur dans le test voiture). Un recadrage plat a18.6 x h_fovpixels 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
--latlonpour 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
- 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/. - Vérifiez visuellement la sélection — ouvrez
Deliverables/_shootpack/<session>/all_stations.jpget chaqueDeliverables/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.
- 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 éditantDeliverables/_shootpack/edit.json(clip, début, longueur, vitesse, exposition en stops) et relancez--only video. Utilisez les proxies des clips (DJI.LRF, SonySUB/) 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). - É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) oudlog_midday_*(plus de contraste/dynamisme).luts/looks/make_looks.shles 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, leswarm_print_v6/warm_print_midday_v2basé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). - 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) dansDeliverables/Music/, puismusic.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_chromade 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.pymuxespec["music"]dans chaque sortie ;--music-onlyréédite et remuxe sans re-rendu ;--size 1920x1080fait 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.tracksur 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é. LeEditRecordingd'Epidemic n'a jamais retourné d'édition quandrequiredRegionsAtOffsetsé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. - 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 dansDeliverables/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 sidecarsM01.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 XMLCaptureGammaEquation), puis à--log. Ordre de confiance : un--logexplicite, 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/*.jsonmet 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-rec709intégré de FilmCraft (ou-sgamut3-, d'après le CaptureColorPrimaries du XML), exporté dansluts/builtin/; nos looks D-Log sont recomposés dessus commeluts/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.cubeseul. - 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 etlight.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.pyrend 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.