CommunityImagengithub.com

shootpack

Procesa una carpeta de sesión de bienes raíces (DJI drone y/o cámara como la Sony A1 II, mezcla permitida) en entregables para el cliente en un solo paso: fotos HDR desde los brackets RAW (LightCraft), selecciones/alternativas, y un video de 60 s con grado Rec.709. Úsalo cuando el usuario señale una carpeta de sesión ('procesa esta sesión', 'empaqueta Maginot', 'ejecuta shootpack en ~/Desktop/X').

¿Qué es shootpack?

shootpack es una habilidad para agentes de IA especializada en el procesamiento automatizado de sesiones fotográficas de bienes raíces. Su flujo de trabajo integra múltiples dispositivos (DJI Mavic 4 Pro, Sony A1 II, Fujifilm X-E4, DJI Osmo 360 II) y detecta automáticamente el modelo de cámara mediante metadatos EXIF para aplicar perfiles de dispositivo personalizados. Soporta la fusión HDR de brackets RAW (DJI DNG, Sony ARW), la selección inteligente de tomas (con detección de duplicados, personas en cuadro, y tomas sobre el techo de vuelo), y la edición de video con grado de color Rec.709 utilizando LUTs oficiales de DJI y ajustes creativos. Además, permite la planificación inicial de la sesión (inventario, selección y plan de edición sin exportaciones), la revisión visual de contact sheets y storyboards, y la generación de entregables finales como fotos HDR, videos con música de Epidemic Sound (cortes sincronizados con el ritmo) y un resumen detallado en SUMMARY.md. La habilidad se ejecuta mediante el comando `shootpack` con opciones para especificar el techo de vuelo, número de selecciones, duración del video, curva de color, coordenadas geográficas y modo de planificación. Es compatible con plataformas como Claude Code, Cursor y Codex, y requiere que el repositorio del pipeline esté en `~/shootpack`. Su utilidad principal es ahorrar tiempo y reducir errores en flujos de trabajo repetitivos de fotografía inmobiliaria, automatizando tareas complejas como el revelado RAW, la corrección de color, la sincronización de audio y la exportación en múltiples formatos (6K, 720p).

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

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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, ver photo.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 descarga Drops/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), luego fuji_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, .OSV encontrado por la etiqueta del codificador MP4 Osmo 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/Video escribe 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é en luts/official/. --spec edits/osmo_car_v1.json renderiza 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 tiene 18.6 x h_fov pí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 --latlon para 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

  1. 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/.
  2. Revisa la selección visualmente — abre Deliverables/_shootpack/<sesión>/all_stations.jpg y cada Deliverables/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.
  3. 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 editando Deliverables/_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, Sony SUB/) 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).
  4. 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) o dlog_midday_* (más contraste/impacto). luts/looks/make_looks.sh los 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 usan warm_print_v6 / warm_print_midday_v2 basados en curvas. Siempre verifica que un nuevo LUT oficial coincida con el perfil del metraje (ver más abajo).
  5. 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) en Deliverables/Music/, luego music.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 de bar_chroma del 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.py multiplexa spec["music"] en cada salida; --music-only re-edita y re-multiplexa sin volver a renderizar; --size 1920x1080 hace 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.track en 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. El EditRecording de 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.
  6. 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.dng junto a su fuente; el pipeline los mueve a Deliverables/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 sidecars M01.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 XML CaptureGammaEquation), luego --log. Orden de confianza: un --log explí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/*.json almacena 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-rec709 integrado de FilmCraft (o -sgamut3-, de CaptureColorPrimaries del XML), exportado a luts/builtin/; nuestros looks D-Log se recomponen sobre él como luts/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.whites en 0 y light.highlights en -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.py renderiza 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.

Skills relacionados