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, vejaphoto.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 dropDrops/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), depoisfuji_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,.OSVencontrado pela tag de codificador MP4Osmo 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/Videoescreve 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 emluts/official/.--spec edits/osmo_car_v1.jsonrenderiza 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 tem18.6 x h_fovpixels 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
--latlonpara 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
- 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/. - Revise a curadoria visualmente — abra
Deliverables/_shootpack/<session>/all_stations.jpge cadaDeliverables/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.
- 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 editandoDeliverables/_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, SonySUB/) e.SRTda 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). - 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) oudlog_midday_*(mais contraste/intensidade).luts/looks/make_looks.shos 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 curvaswarm_print_v6/warm_print_midday_v2são usadas. Sempre verifique se uma nova LUT oficial corresponde ao perfil do material (veja abaixo). - 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) emDeliverables/Music/, depoismusic.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 similaridadebar_chromada 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.pymultiplexaspec["music"]em cada saída;--music-onlyre-edita e re-multiplexa sem re-renderizar;--size 1920x1080faz 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.trackna 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. OEditRecordingda Epidemic não retornou edição sempre querequiredRegionsAtOffsetsfoi 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. - 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.dngao lado de sua fonte; o pipeline os move paraDeliverables/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 sidecarsM01.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 XMLCaptureGammaEquation), depois--log. Ordem de confiança: um--logexplí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/*.jsonarmazena 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-rec709embutido do FilmCraft (ou-sgamut3-, do CaptureColorPrimaries do XML), exportado paraluts/builtin/; nossos looks D-Log são recombinados sobre ele comoluts/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.whitesem 0 elight.highlightsem -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.pyrenderiza 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.