CommunityImagemgithub.com

shootpack

Processa uma pasta de fotografia imobiliária (DJI drone e/ou câmera como Sony A1 II, mistura é aceitável) em entregáveis para o cliente em uma única etapa — fotos HDR a partir dos bracktes RAW (LightCraft), seleções/alternativas, e um vídeo de 60 s graduado em Rec.709. Use quando o usuário apontar para uma pasta de trabalho ("processa esta pasta", "empacota Maginot", "roda shootpack em ~/Desktop/X").

O que é shootpack?

shootpack é uma skill avançada de agente de IA projetada para automatizar completamente o fluxo de trabalho de pós-produção de fotografia imobiliária. Ela recebe uma pasta de trabalho contendo fotos RAW (DJI DNG, Sony ARW, Fujifilm RAF) e clipes de vídeo de várias câmeras (DJI Mavic 4 Pro, Sony A1 II, DJI Osmo 360 II, Fujifilm X-E4) e, em um único comando, gera entregáveis para o cliente: fotos HDR de alta qualidade (via LightCraft), uma curadoria automática das melhores imagens, e um vídeo de aproximadamente 60 segundos graduado em Rec.709 com música licenciada (Epidemic Sound). A skill é executada localmente (repositório git em ~/shootpack) e fornece feedback visual através de sites de progresso, contact sheets e storyboards, permitindo que o usuário revise e ajuste curadoria, edição de vídeo, graduação e música antes da entrega final. Ela gerencia automaticamente a detecção de dispositivos (lendo EXIF, sidecars XML, telemetria SRT), aplica LUTs oficiais e looks criativos, e lida com casos complexos como bracketing HDR, fusão de exposição, graduação de cor baseada em sinal, e sincronização de música com cortes. A skill suporta múltiplas câmeras, incluindo drones DJI, câmeras Sony, Fujifilm e câmeras 360°, e oferece opções como `--ceiling` para definir o teto de voo LAANC, `--picks` para número de fotos selecionadas, `--length` para duração do vídeo, e `--log` para escolha da curva log.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que shootpack faz?

O pipeline está em ~/shootpack (repositório git). Ponto de entrada: shootpack <folder> [--ceiling M] [--picks N] [--length S] [--log CURVE] [--latlon LAT,LON] [--plan]. Inicie novas pastas com --plan (inventário, curadoria e plano de edição, sem exportações).

Dispositivos

A câmera de cada arquivo é detectada (EXIF Make/Model, tags de codificador/modelo de vídeo, sidecars) e lida com seu perfil em devices/<id>.json; câmeras desconhecidas usam devices/generic.json. A primeira linha do log lista o que foi encontrado (devices: DJI Mavic 4 Pro (200 fotos, 8 clipes), Sony A1 II (...)) — verifique.

  • DJI Mavic 4 Pro (dji_mavic4pro): geometria de drone XMP → detecção solar, curadoria consciente de enquadramento, flags de teto, vídeo com altitude; telemetria SRT, proxies LRF.
  • Sony A1 II (sony_a1ii, EXIF Model ILCE-1M2): brackets ARW (pares + JPG/HEIF, também entre cartões) agrupados por viés de exposição + modo de disparo; sidecars XML de clipe (C0001M01.XML) fornecem horário de início, taxa de quadros, gama e gamut; SUB/proxies. Sem geometria de câmera: sem perfil solar automático (defina "sun" em cull.json manualmente), a curadoria é baseada no conteúdo da imagem (quadros quase idênticos = duplicatas) e nomeia as fotos pela lente (24mm, 70mm-portrait).
  • Fujifilm X-E4 (fujifilm_xe4, EXIF Model X-E4 em RAF, JPG e MP4): quadros individuais, pares RAF + JPG. O JPG é a renderização da receita (Classic Chrome etc.; a receita está no EXIF do RAF, veja photo.recipe_tags); o desenvolvimento RAF próprio do LightCraft é escuro e sem graça e a ignora, então ajuste um perfil de desenvolvimento ao JPEG da câmera antes de exportar. Clipes na mesma pasta DCIM, sem sidecars; clipes com simulação de filme são Rec.709 (apenas aparência, sem LUT técnica), F-Log é detectado a partir do sinal. Descarregamento: shootpack offload <card> --device XE4 (pasta de drop Drops/XE4/). Desenvolvimento: recipe_fit.py fit LUT.npz RAF=JPG,... nos próprios pares da pasta (emparelhe RAF e JPG por tempo de captura: os números podem diferir em um), depois fuji_develop.py batch LUT.npz cull.json <DCIM dir> Deliverables/Photos (as chaves de cull.json são o número do JPEG -> {raf, jpg, name}). O relógio da câmera pode estar no horário de casa (um casamento: -06:00, local = +8 h). Clipes de eventos com som ao vivo: clip_edit.py edits/<spec>.json Video/<name>_4K.mp4 (sem música, áudio em L-cut; estabilização desligada a menos que motion.py prove que ajuda). Veja agent-docs/photos/fuji-recipe.md.
  • DJI Osmo 360 II (dji_osmo360ii, .OSV encontrado pela tag de codificador MP4 Osmo 360 II): dois fluxos olho de peixe, então seus clipes são separados (o log diz "N clipe(s) 360 ... renderize-os com osmo360.py") e nunca chegam à edição imobiliária. osmo360.py CLIP.OSV Deliverables/Video escreve um reframe plano graduado (movimento com keyframes) e um equirretangular 360 graduado. A costura não é calibrada e o horizonte não é nivelado; as lentes são equalizadas em ganho na sobreposição. O modo de cor é lido a partir do sinal dentro dos círculos de imagem (Cor Normal vs D-Log M, verificado em clipes reais de ambos). D-Log M recebe uma LUT provisória ajustada ao próprio proxy da câmera (luts/interim_dlogm_to_709_osmo360ii.cube) até que a LUT D-Log M oficial do Osmo 360 da DJI esteja em luts/official/. --spec edits/osmo_car_v1.json renderiza um trecho com keyframes de um clipe longo (um corte apertado e com exposição aumentada do motorista no teste do carro). Um corte plano tem 18.6 x h_fov pixels reais: 4K de um corte apertado é upscaled (agent-docs/video/osmo360.md). A câmera tem armazenamento interno e um cartão SD (dois volumes). Descarregamento: shootpack offload <card> encontra por conta própria (Drops/Osmo360/).
  • Gravação em slot duplo: arquivos idênticos em ambos os cartões são detectados (nome + tempo de captura + tamanho, depois hash) e a cópia do slot 1 é usada; o log diz quantos foram pulados.
  • Sem GPS em lugar nenhum (apenas câmera): as sessões são nomeadas pelo horário do relógio local (Manhã < 10:00, Meio-dia < 15:00, Tarde < 17:30, Noite), e a graduação segue o nome (Meio-dia/Tarde: look de meio-dia; senão dourado). Passe --latlon para nomeá-las pelo sol. As fotos Sony não têm geometria, então fotos de sol não recebem perfil solar automático: defina "sun": {"G18": "A"} em cull.json manualmente (o desenvolvimento automático levanta uma moldura escura de sol-através-do-vidro de forma plana).
  • Uma câmera nova: copie o perfil mais próximo, altere detect.models, sensor/FOV, regra de bracket e curvas de log.

Etapas

  1. Execute. shootpack "<folder>" --ceiling <teto LAANC/airspace do usuário, padrão 120> em segundo plano (fotos ≈ 25 s por bracket, vídeo ≈ 4 min). Ele armazena tudo em cache em <folder>/Deliverables/_shootpack/.
  2. Revise a curadoria visualmente — abra Deliverables/_shootpack/<session>/all_stations.jpg e cada Deliverables/Photos/<session>/Picks_contact_sheet.jpg. A curadoria automática não vê conteúdo, então verifique e corrija:
    • a casa cortada na borda do quadro → mova para rejeitados
    • uma pessoa (geralmente o piloto em colete de alta visibilidade) no quadro → alternativas, anote "PESSOA-NO-QUADRO"
    • quase-duplicatas / repetições chatas → alternativas; fotos fortes deixadas em alternativas → seleções
    • fotos acima do teto já estão sinalizadas nas alternativas — mencione-as, não as esconda Edite <session>/cull.json (chaves G01…; valores são nomes curtos), exclua as saídas afetadas, execute novamente com --only photos. Fotos de sol são detectadas automaticamente (sol dentro do quadro por geometria solar + ainda estourado no bracket mais escuro) e desenvolvidas com um perfil de sol: A = sol é o assunto (-1,9 stops vs automático), C = casa é o assunto (-0,6 stops, a casa permanece brilhante). Substitua por foto em cull.json: "sun": {"G21": "A", "G07": "off"}. Starbursts: se um quadro do bracket mostrar raios de difração nítidos em torno de um disco solar visível (olhe para o sol em cada quadro), adicione "starburst": {"G21": "0209"} (número do quadro) e execute novamente --only photos --redo; nunca para sóis atrás de nuvens (esses raios são raios de sol e já sobrevivem à fusão). Verifique fotos de sol quanto a nuvens rosadas estouradas.
  3. Revise o vídeo — abra Deliverables/Video/*_storyboard.jpg (um quadro a cada 3 s). Substitua tomadas que são decolagem/pouso, o piloto, muito escuras ou repetitivas editando Deliverables/_shootpack/edit.json (clipe, início, duração, velocidade, exposição em stops) e execute novamente --only video. Use os proxies dos clipes (DJI .LRF, Sony SUB/) e .SRT da DJI (rel_alt, posição) para encontrar melhores momentos. Clipes de câmera não têm telemetria, então corte de decolagem/pouso e faixas de altitude não se aplicam; clipes 24p/30p nunca são desacelerados (apenas 50p+ podem alimentar câmera lenta).
  4. Graduação — com a LUT oficial da DJI em ~/shootpack/luts/official/ (Maginot: "DJI Mavic 4 Pro D-Log to Rec.709 V1.cube"), cada tomada recebe a LUT da DJI como base técnica mais nosso look criativo por cima: luts/looks/dlog_golden_* (hora dourada: mais quente, azul mais calmo, sombras abertas) ou dlog_midday_* (mais contraste/intensidade). luts/looks/make_looks.sh os reconstrói (build_look.py: _input.cube = LUT oficial com a exposição aplicada em log, para o slot Input do FilmCraft; _look.cube = Rec.709→Rec.709 para o slot Creativo; _composed.cube = ambos, para ffmpeg). Coloque ajustes de exposição ANTES da LUT oficial (--pre-exposure, stops em log): a LUT da DJI é mais escura que seus próprios JPEGs, e ajustar depois estoura os céus (a v5 do Maginot saiu 30-50% muito escura por causa disso). Sem uma LUT oficial, as curvas warm_print_v6 / warm_print_midday_v2 são usadas. Sempre verifique se uma nova LUT oficial corresponde ao perfil do material (veja abaixo).
  5. Música (trailer) — Epidemic Sound através do conector OAuth do usuário (nunca uma chave de API). Pesquise faixas instrumentais de "build" cujo comprimento de batida corresponda aos cortes da montagem (75 BPM = 3,2 s por batida) e leia a curva de energia de cada forma de onda: você quer uma introdução silenciosa, um longo build e uma grande queda. DownloadRecording (WAV, FULL) em Deliverables/Music/, depois music.analyze(wav, given_bpm): verifique se a queda cai em um downbeat (a fase on/off-beat do grid vem do kick/bass, a fase da batida do maior salto de graves). Escolha saltos X→Y onde a similaridade bar_chroma da batida Y com a batida X+1 seja >= 0,9 (mesmos acordes, sem emenda audível). Temporize a imagem em quadros inteiros no grid de batidas (template: edits/make_trailer_v7.py): cortes nos downbeats, final na queda, cartão final no release. trailer.py multiplexa spec["music"] em cada saída; --music-only re-edita e re-multiplexa sem re-renderizar; --size 1920x1080 faz uma verificação de tempo de 5 minutos (meça cortes contra batidas antes da renderização 6K). Gosto do cliente (pasta de referência, v8-v11): full 16:9 sem letterbox ("letterbox": null), sem cartões de texto, sem dissolves ou cortes para preto, cortes secos na batida, terminar no último shot (um "end_fade" de 1 s sob a cauda da música é aceitável). Suavize shots com "stabilize": um número = sigma gaussiano em s (1-2), {"poly": 2} = um movimento uniforme. Sem o letterbox, toda correção vertical custa zoom, então mantenha o sigma moderado (final da pasta de referência: 1,25 = 6,6% zoom, 2,0 seria 12%); "reframe_y" só ajuda com letterbox. Para manter mais da casa no final de um movimento, desacelere o shot para que termine mais cedo no movimento. Meça a trepidação na renderização (stabilize.track na prévia) antes e depois; a própria parada e reversão de um drone só pode ser suavizada (sigma mais pesado + 0,85x), não removida. O EditRecording da Epidemic não retornou edição sempre que requiredRegionsAtOffsets foi definido, e sua edição irrestrita de 60 s descartou completamente a queda (Out 2026), então cortamos a faixa nós mesmos. Trabalho de cliente precisa de um plano comercial da Epidemic; pergunte.
  6. Entregue — envie as contact sheets das seleções, a prévia 720p (<30 MB) e o storyboard com SendUserFile; resuma a partir de Deliverables/SUMMARY.md (contagens, flags, o que é provisório). Envie quaisquer mudanças de código reutilizáveis para o repositório.

Mostrar progresso

Para cada mudança, dê um antes/depois: atualize review_site/<shoot>/progress/*/manifest.json (grade / fotos / detalhe / corte / música) e reconstrua com progress_page.py (progress_music.py desenha o gráfico de ajuste da música); envie uma folha amigável para celular ou vídeo de comparação empilhada com SendUserFile.

Fatos importantes

  • Sempre desenvolva a partir dos raws (DJI DNG, Sony ARW); JPGs são apenas metadados/referência. Fotos apenas ARW recebem um JPEG de referência extraído do raw em _shootpack/previews/. LightCraft renderiza ARW com um look ajustado ao JPEG da própria Sony (não o neutro mudo de fallback), mas não tem perfis de lente Sony: distorção/vinheta permanecem como fotografados. Sua fusão HDR de ARWs escreve um DNG sem matriz de cor ou balanço de branco (desenvolve verde): o pipeline escreve a calibração da câmera (ColorMatrix1 da tabela derivada de Adobe do LibRaw via rawpy, AsShotNeutral do shot) e desenvolve esse arquivo, então arquivos HDR_DNG/ de brackets Sony abrem com cor correta em qualquer editor raw.
  • LightCraft escreve *-HDR.dng ao lado de sua fonte; o pipeline os move para Deliverables/HDR_DNG/. Nunca modifique os originais.
  • MP4s da DJI são armazenados rotacionados (rotation=-90); ffprobe relata dimensões retrato, mas eles tocam paisagem.
  • Cartões Sony: copie toda a árvore DCIM/ + PRIVATE/ por slot (o Finder não pode montar uma câmera em modo MTP — use um leitor de cartão ou USB Mass Storage); sem os sidecars M01.XML, a gama/gamut dos clipes recai apenas no sinal.
  • SRT DiffTime: 16ms = 59,94p → conversão de meia velocidade para 29,97 para órbitas suaves.
  • As curvas de log são decididas por clipe a partir do sinal: a distribuição de valores de código de luminância de ~10 quadros (p95 = onde os brancos estão) é verificada contra a banda de cada curva no perfil, depois o rótulo da câmera (DJI SRT color_md, Sony XML CaptureGammaEquation), depois --log. Ordem de confiança: um --log explícito, depois o sinal, depois o rótulo. Cada discordância é um AVISO no log e em SUMMARY.md — leia antes de renderizar. D-Log vs D-Log M: em luz do dia, D-Log mantém brancos em torno de 0,55 código (super-brancos acima para céu/sol; p95 Maginot 0,44-0,69); D-Log M os coloca perto de 0,8+. Uma LUT D-Log M em material D-Log renderiza brancos como ~50% cinza (plano, sem graça) — Maginot era D-Log. Muito escuro (noite) ou entre bandas = inconclusivo → o rótulo decide. _shootpack/log/*.json armazena em cache as estatísticas.
  • Correspondência de LUT por dispositivo/curva/gamut: LUTs oficiais em luts/official/ por tokens de nome de arquivo normalizados ("D-Log M" conta como D-Log M; uma LUT Mavic 4 Pro vence outras LUTs DJI). DJI sem LUT oficial: grades de impressão quente baseadas em curva. Sony S-Log3: builtin:slog3-sgamut3cine-to-rec709 embutido do FilmCraft (ou -sgamut3-, do CaptureColorPrimaries do XML), exportado para luts/builtin/; nossos looks D-Log são recombinados sobre ele como luts/looks/slog3_*_composed.cube, com a pré-exposição ajustada para que 18% cinza caia onde a LUT de entrada da DJI o coloca (edições misturadas DJI + Sony combinam). Clipes S-Cinetone/Rec.709/HLG não precisam de decodificação: apenas _look.cube.
  • A exposição em edit.json é ajustada em valores de código por stop da curva do clipe (lift: D-Log 67, S-Log3 79).
  • Fotos de sol LightCraft: mantenha light.whites em 0 e light.highlights em -60 ou mais suave; recuperação mais forte ou um tom magenta arrasta a nuvem estourada para abaixo do branco e ela renderiza rosa.
  • Renderizações 6K: trailer.py renderiza em seções (cortadas em cortes secos e cortes para preto) — 14 decodificações 6K paralelas esgotam a memória em 16 GB.
  • Observe o disco livre: cada DNG HDR ≈ 300 MB; o pipeline para com menos de 5 GB livres.

Habilidades Relacionadas