¿Qué hace shootpack?
El pipeline vive en ~/shootpack (repositorio git). Punto de entrada: shootpack <carpeta> [--ceiling M] [--picks N] [--length S] [--log CURVE] [--latlon LAT,LON] [--plan]. Inicia nuevas sesiones con --plan (inventario, selección y plan de edición, sin exportaciones).
Dispositivos
La cámara de cada archivo se detecta (Make/Model en EXIF, etiquetas de códec/video, sidecars) y se lee con su perfil en devices/<id>.json; las cámaras desconocidas usan devices/generic.json. La primera línea del log lista lo que se encontró (dispositivos: DJI Mavic 4 Pro (200 fotos, 8 clips), Sony A1 II (...)) — verifícalo.
- DJI Mavic 4 Pro (
dji_mavic4pro): Geometría de dron desde XMP → detección de sol, selección consciente del encuadre, banderas de techo, video con altitud consciente; telemetría SRT, proxies LRF. - Sony A1 II (
sony_a1ii, EXIF Model ILCE-1M2): Brackets ARW (pares JPG/HEIF, también entre tarjetas) agrupados por sesgo de exposición + modo de disparo; sidecars XML de clips (C0001M01.XML) proporcionan hora de inicio, velocidad de fotogramas, gamma y gama; SUB/proxies. Sin geometría de cámara: sin perfil de sol automático (establece"sun"en cull.json manualmente), la selección se basa en el contenido de la imagen (fotogramas casi idénticos = duplicados) y nombra las tomas por el objetivo (24mm,70mm-portrait). - Fujifilm X-E4 (
fujifilm_xe4, EXIF Model X-E4 en RAF, JPG y MP4): Fotogramas individuales, pares RAF + JPG. El JPG es la interpretación de la receta (Classic Chrome, etc.; la receta está en el EXIF del RAF, verphoto.recipe_tags); el revelado RAF propio de LightCraft es oscuro y plano y lo ignora, por lo que se ajusta un perfil de revelado al JPEG de la cámara antes de exportar. Clips en la misma carpeta DCIM, sin sidecars; los clips con simulación de película son Rec.709 (solo apariencia, sin LUT técnica), F-Log se detecta desde la señal. Descarga:shootpack offload <tarjeta> --device XE4(carpeta de descargaDrops/XE4/). Revelado:recipe_fit.py fit LUT.npz RAF=JPG,...en los pares de la sesión (empareja RAF y JPG por hora de captura: los números pueden diferir en uno), luegofuji_develop.py batch LUT.npz cull.json <dir DCIM> Deliverables/Photos(las claves de cull.json son el número del JPEG -> {raf, jpg, name}). El reloj de la cámara puede estar en hora local (una sesión de boda: -06:00, local = +8 h). Clips de eventos con sonido en vivo:clip_edit.py edits/<spec>.json Video/<name>_4K.mp4(sin música, L-cut de audio; la estabilización permanece desactivada a menos que motion.py demuestre que ayuda). Ver agent-docs/photos/fuji-recipe.md. - DJI Osmo 360 II (
dji_osmo360ii,.OSVencontrado por la etiqueta del codificador MP4Osmo 360 II): dos flujos ojo de pez, por lo que sus clips se separan (el log dice "N clip(s) 360 ... reprodúcelos con osmo360.py") y nunca llegan a la edición de bienes raíces.osmo360.py CLIP.OSV Deliverables/Videoescribe un reencuadre plano graduado (movimiento con fotogramas clave) y un equirectangular 360 graduado. La costura no está calibrada y el horizonte no está nivelado; las lentes están igualadas en ganancia en la superposición. El modo de color se lee de la señal dentro de los círculos de imagen (Color Normal vs D-Log M, verificado en clips reales de ambos). D-Log M obtiene un LUT provisional ajustado al proxy de la cámara (luts/interim_dlogm_to_709_osmo360ii.cube) hasta que el LUT oficial DJI Osmo 360 D-Log M esté enluts/official/.--spec edits/osmo_car_v1.jsonrenderiza un extracto con fotogramas clave de un clip largo (un recorte ajustado y con exposición elevada del conductor en la prueba del coche). Un recorte plano tiene18.6 x h_fovpíxeles reales a lo ancho: 4K de un recorte ajustado se reescala (agent-docs/video/osmo360.md). La cámara tiene almacenamiento interno y una tarjeta SD (dos volúmenes). Descarga:shootpack offload <tarjeta>lo encuentra por sí mismo (Drops/Osmo360/). - Grabación de doble ranura: los archivos idénticos en ambas tarjetas se detectan (nombre + hora de captura + tamaño, luego hash) y se usa la copia de la ranura 1; el log dice cuántos se omitieron.
- Sin GPS (solo cámara): las sesiones se nombran por la hora del reloj local (Mañana < 10:00, Mediodía < 15:00, Tarde < 17:30, Atardecer), y el grado sigue el nombre (Mediodía/Tarde: look de mediodía; si no, dorado). Pasa
--latlonpara nombrarlas según el sol. Las tomas Sony no tienen geometría, por lo que las tomas de sol no reciben perfil de sol automático: establece"sun": {"G18": "A"}en cull.json manualmente (el revelado automático levanta un fotograma oscuro con sol a través del vidrio plano). - Una cámara nueva: copia el perfil más cercano, cambia
detect.models, sensor/FOV, regla de bracketing y curvas de log.
Pasos
- Ejecútalo.
shootpack "<carpeta>" --ceiling <techo LAANC/espacio aéreo del usuario, por defecto 120>en segundo plano (fotos ≈ 25 s por bracket, video ≈ 4 min). Almacena en caché todo en<carpeta>/Deliverables/_shootpack/. - Revisa la selección visualmente — abre
Deliverables/_shootpack/<sesión>/all_stations.jpgy cadaDeliverables/Photos/<sesión>/Picks_contact_sheet.jpg. El auto-recorte no puede ver el contenido, así que verifica y corrige:- la casa recortada en el borde del fotograma → muévela a rechazados
- una persona (a menudo el piloto con chaleco reflectante) en el encuadre → alternativas, nota "PERSONA-EN-CUADRO"
- casi duplicados / repeticiones aburridas → alternativas; tomas fuertes que quedaron en alternativas → selecciones
- las tomas sobre el techo ya están marcadas en alternativas — menciónalas, no las ocultes
Edita
<sesión>/cull.json(claves G01…; valores son nombres cortos), elimina los resultados afectados, ejecuta de nuevo con--only photos. Tomas de sol se detectan automáticamente (sol dentro del fotograma por geometría solar + aún recortado en el bracket más oscuro) y se revelan con un perfil de sol:A= el sol es el sujeto (-1.9 stops vs automático),C= la casa es el sujeto (-0.6 stops, la casa se mantiene brillante). Anula por toma en cull.json:"sun": {"G21": "A", "G07": "off"}. Estrellas: si un fotograma del bracket muestra rayos de difracción nítidos alrededor de un disco solar visible (mira el sol en cada fotograma), agrega"starburst": {"G21": "0209"}(número de fotograma) y ejecuta de nuevo--only photos --redo; nunca para soles detrás de nubes (esos rayos son haces de luz y ya sobreviven a la fusión). Verifica las tomas de sol en busca de nubes recortadas rosadas.
- Revisa el video — abre
Deliverables/Video/*_storyboard.jpg(un fotograma cada 3 s). Reemplaza las tomas que son despegue/aterrizaje, el piloto, demasiado oscuras o repetitivas editandoDeliverables/_shootpack/edit.json(clip, inicio, duración, velocidad, exposición en stops) y ejecuta de nuevo--only video. Usa los proxies de los clips (DJI.LRF, SonySUB/) y DJI.SRT(rel_alt, posición) para encontrar mejores momentos. Los clips de cámara no tienen telemetría, por lo que el recorte de despegue/aterrizaje y las bandas de altitud no se aplican; los clips a 24p/30p nunca se ralentizan (solo 50p+ pueden alimentar cámara lenta). - Grado — con el LUT oficial de DJI en
~/shootpack/luts/official/(Maginot: "DJI Mavic 4 Pro D-Log to Rec.709 V1.cube"), cada toma obtiene el LUT de DJI como base técnica más nuestro look creativo encima:luts/looks/dlog_golden_*(hora dorada: más cálido, azul más tranquilo, sombras abiertas) odlog_midday_*(más contraste/impacto).luts/looks/make_looks.shlos reconstruye (build_look.py:_input.cube= LUT oficial con la exposición aplicada en log, para la ranura de Entrada de FilmCraft;_look.cube= Rec.709→Rec.709 para la ranura Creativa;_composed.cube= ambos, para ffmpeg). Coloca los aumentos de exposición ANTES del LUT oficial (--pre-exposure, stops en log): el LUT de DJI es más oscuro que sus propios JPEG, y aumentar después recorta los cielos (la v5 de Maginot salió 30-50% demasiado oscura por eso). Sin un LUT oficial se usanwarm_print_v6/warm_print_midday_v2basados en curvas. Siempre verifica que un nuevo LUT oficial coincida con el perfil del metraje (ver más abajo). - Música (tráiler) — Epidemic Sound a través del conector OAuth del usuario (nunca una clave de API). Busca pistas instrumentales "build" cuya duración de compás coincida con los cortes del montaje (75 BPM = compases de 3.2 s) y lee la curva de energía de cada forma de onda: quieres una introducción tranquila, un build largo y un gran drop.
DownloadRecording(WAV, FULL) enDeliverables/Music/, luegomusic.analyze(wav, bpm_dado): verifica que el drop caiga en un downbeat (la fase on/off-beat del grid proviene del kick/bajo, la fase del compás del salto más grande en bajas frecuencias). Elige saltos X→Y donde la similitud debar_chromadel compás Y con el compás X+1 sea >= 0.9 (mismos acordes, sin empalme audible). Sincroniza la imagen en fotogramas enteros en la cuadrícula de compases (plantilla:edits/make_trailer_v7.py): cortes en downbeats, final en el drop, tarjeta final en la liberación.trailer.pymultiplexaspec["music"]en cada salida;--music-onlyre-edita y re-multiplexa sin volver a renderizar;--size 1920x1080hace una verificación de sincronización de 5 minutos (mide cortes contra los beats antes del renderizado 6K). Gusto del cliente (sesión de referencia, v8-v11): 16:9 completo sin letterbox ("letterbox": null), sin tarjetas de texto, sin disolvencias o cortes a negro, cortes duros en el beat, termina en la última toma (un"end_fade"de 1 s bajo la cola de la música está bien). Suaviza tomas con"stabilize": un número = sigma gaussiana en s (1-2),{"poly": 2}= un movimiento uniforme. Sin el letterbox, cada corrección vertical cuesta zoom, así que mantén la sigma moderada (el final de la sesión de referencia: 1.25 = 6.6% de zoom, 2.0 sería 12%);"reframe_y"solo ayuda con un letterbox. Para mantener más de la casa al final de un movimiento, ralentiza la toma para que termine antes en el movimiento. Mide la vibración en el renderizado (stabilize.tracken la vista previa) antes y después; el propio stop-and-reverse de un dron solo puede suavizarse (sigma más pesada + 0.85x), no eliminarse. ElEditRecordingde Epidemic no devolvió ninguna edición cada vez que se estableciórequiredRegionsAtOffsets, y su edición sin restricciones de 60 s eliminó el drop por completo (Oct 2026), por lo que cortamos la pista nosotros mismos. El trabajo para clientes necesita un plan comercial de Epidemic; pregunta. - Entrega — envía las hojas de contacto de selecciones, la vista previa 720p (<30 MB) y el storyboard con SendUserFile; resume desde
Deliverables/SUMMARY.md(recuentos, banderas, qué es provisional). Confirma cualquier cambio de código reutilizable en el repositorio.
Mostrar progreso
Para cada cambio, da un antes/después: actualiza review_site/<sesión>/progress/*/manifest.json (grado / fotos / detalle / corte / música) y reconstruye con progress_page.py (progress_music.py dibuja el gráfico de ajuste musical); envía una hoja apta para móvil o un video comparativo apilado con SendUserFile.
Hechos importantes
- Siempre revela desde los RAW (DJI DNG, Sony ARW); los JPG son solo metadatos/referencia. Las tomas solo ARW obtienen un JPEG de referencia extraído del RAW en
_shootpack/previews/. LightCraft renderiza ARW con un look ajustado al JPEG propio de Sony (no el predeterminado neutro apagado) pero no tiene perfiles de lente Sony; la distorsión/viñeteado se mantienen como en la toma. Su fusión HDR de ARW escribe un DNG sin matriz de color ni balance de blancos (revela verde): el pipeline escribe la calibración de la cámara (ColorMatrix1 de la tabla derivada de Adobe de LibRaw a través de rawpy, AsShotNeutral de la toma) y revela ese archivo, por lo que los archivos HDR_DNG/ de los brackets Sony se abren con color correcto en cualquier editor RAW. - LightCraft escribe
*-HDR.dngjunto a su fuente; el pipeline los mueve aDeliverables/HDR_DNG/. Nunca modifiques los originales. - Los MP4 de DJI se almacenan rotados (
rotation=-90); ffprobe reporta dimensiones de retrato pero se reproducen en paisaje. - Tarjetas Sony: copia los árboles completos
DCIM/+PRIVATE/por ranura (Finder no puede montar una cámara en modo MTP — usa un lector de tarjetas o almacenamiento masivo USB); sin los sidecarsM01.XML, la gamma/gama de los clips se reduce solo a la señal. - SRT
DiffTime: 16ms= 59.94p → conformado a media velocidad a 29.97 para órbitas suaves. - Las curvas de log se deciden por clip desde la señal: la distribución de valores de código de luma de ~10 fotogramas (p95 = dónde están los blancos) se verifica contra la banda de cada curva en el perfil, luego la etiqueta de la cámara (DJI SRT
color_md, Sony XMLCaptureGammaEquation), luego--log. Orden de confianza: un--logexplícito, luego la señal, luego la etiqueta. Cada desacuerdo es una ADVERTENCIA en el log y en SUMMARY.md — léelo antes de renderizar. D-Log vs D-Log M: a la luz del día, D-Log mantiene los blancos alrededor de 0.55 de código (superblancos arriba para cielo/sol; Maginot p95 0.44-0.69); D-Log M los sitúa cerca de 0.8+. Un LUT D-Log M en metraje D-Log renderiza los blancos como ~50% gris (plano, aburrido) — Maginot era D-Log. Demasiado oscuro (noche) o entre bandas = no concluyente → la etiqueta decide._shootpack/log/*.jsonalmacena en caché las estadísticas. - Emparejamiento de LUT por dispositivo/curva/gama: LUTs oficiales en
luts/official/por tokens de nombre de archivo normalizados ("D-Log M" cuenta como D-Log M; un LUT de Mavic 4 Pro gana sobre otros LUTs de DJI). DJI sin LUT oficial: grados de impresión cálida basados en curvas. Sony S-Log3:builtin:slog3-sgamut3cine-to-rec709integrado de FilmCraft (o-sgamut3-, de CaptureColorPrimaries del XML), exportado aluts/builtin/; nuestros looks D-Log se recomponen sobre él comoluts/looks/slog3_*_composed.cube, con la pre-exposición igualada para que el 18% gris aterrice donde el LUT de entrada de DJI lo coloca (las ediciones mixtas DJI + Sony coinciden). Los clips S-Cinetone/Rec.709/HLG no necesitan decodificación: solo el_look.cube. - La exposición en edit.json se eleva en valores de código por stop de la curva del clip (
lift: D-Log 67, S-Log3 79). - Tomas de sol de LightCraft: mantén
light.whitesen 0 ylight.highlightsen -60 o más suave; una recuperación más fuerte o un tinte magenta arrastra la nube recortada por debajo del blanco y se renderiza rosa. - Renderizados 6K:
trailer.pyrenderiza en secciones (divide en cortes duros y cortes a negro) — 14 decodificaciones paralelas 6K se quedan sin memoria en 16 GB. - Vigila el disco libre: cada DNG HDR ≈ 300 MB; el pipeline se detiene por debajo de 5 GB libres.