Community이미지github.com

shootpack

부동산 촬영 폴더(DJI 드론 및/또는 Sony A1 II 같은 카메라, 혼합 가능)를 한 번에 클라이언트 납품 자료로 가공합니다 — 로우 브라켓에서 HDR 사진(LightCraft), 선별된 사진/대안, 그리고 60초 Rec.709 그레이딩 비디오. 사용자가 촬영 폴더를 가리키며 "이 촬영 처리해줘", "Maginot 패키징", "~/Desktop/X에 shootpack 실행"이라고 말할 때 사용합니다.

shootpack란 무엇인가요?

shootpack은 부동산 촬영 폴더(드론 및 미러리스 카메라 혼용 가능)를 한 번의 명령어로 처리하여 클라이언트에게 바로 전달할 수 있는 완전한 파이프라인입니다. DJI Mavic 4 Pro, Sony A1 II, Fujifilm X-E4, DJI Osmo 360 II 등 다양한 기기를 지원하며, 기기별 EXIF 정보를 분석하여 자동으로 프로필을 적용하고 로우 파일에서 HDR 사진(LightCraft 사용)과 Rec.709 그레이딩 비디오를 생성합니다. 주요 기능으로는 자동 큐레이션(중복 제거, 촬영 한도 초과 감지, 태양 샷 자동 감지), DJI 공식 LUT 또는 맞춤형 LUT 기반 색 보정, Epidemic Sound와 연동한 음악 자동 선택 및 믹싱, 6K 렌더링 등이 있습니다. 모든 과정은 캐싱되고 점진적으로 재실행 가능하며, 진행 상황을 시각적으로 확인할 수 있는 리뷰 사이트와 요약 파일을 생성합니다.

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

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

shootpack은(는) 무엇을 하나요?

파이프라인은 ~/shootpack (git 저장소)에 있습니다. 진입점: shootpack <폴더> [--ceiling M] [--picks N] [--length S] [--log CURVE] [--latlon LAT,LON] [--plan]. 새 촬영은 --plan으로 시작합니다(목록 작성, 큐레이션 및 편집 계획, 내보내기 없음).

장치

모든 파일의 카메라는 감지되고(EXIF 제조사/모델, 비디오 인코더/모델 태그, 사이드카) devices/<id>.json의 프로필로 읽힙니다. 알 수 없는 카메라는 devices/generic.json을 사용합니다. 첫 번째 로그 줄은 발견된 것을 나열합니다(devices: DJI Mavic 4 Pro (200 photos, 8 clips), Sony A1 II (...)) — 확인하세요.

  • DJI Mavic 4 Pro (dji_mavic4pro): XMP 드론 지오메트리 → 태양 감지, 프레임 인식 큐레이션, 천장 한도 플래그, 고도 인식 비디오; SRT 원격 측정, LRF 프록시.
  • Sony A1 II (sony_a1ii, EXIF Model ILCE-1M2): 노출 편차 + 드라이브 모드별로 그룹화된 ARW 브라켓(+ JPG/HEIF 쌍, 카드 간에도 있음); 클립 XML 사이드카(C0001M01.XML)는 시작 시간, 프레임 속도, 감마 및 색역을 제공합니다. SUB/ 프록시. 카메라 지오메트리 없음: 자동 태양 프로필 없음(cull.json에서 "sun" 수동 설정), 큐레이션은 이미지 내용(거의 동일한 프레임 = 중복)으로 진행되며 렌즈별로 샷 이름을 지정합니다(24mm, 70mm-portrait).
  • Fujifilm X-E4 (fujifilm_xe4, EXIF Model X-E4 on RAF, JPG and MP4): 단일 프레임, RAF + JPG 쌍. JPG는 레시피 렌더링입니다(Classic Chrome 등, 레시피는 RAF의 EXIF에 있음, photo.recipe_tags 참조). LightCraft 자체의 RAF 디벨롭은 어둡고 평탄하며 이를 무시하므로, 내보내기 전에 카메라 JPEG에 맞춰 디벨롭 프로필을 피팅합니다. 같은 DCIM 폴더의 클립, 사이드카 없음; 필름 시뮬레이션 클립은 Rec.709(룩만 있고 기술 LUT 없음), F-Log는 신호에서 감지됩니다. 오프로드: shootpack offload <카드> --device XE4 (드롭 폴더 Drops/XE4/). 디벨롭: 촬영 자체의 쌍에서 recipe_fit.py fit LUT.npz RAF=JPG,... 실행(RAF와 JPG를 촬영 시간별로 짝짓기: 번호가 하나 다를 수 있음), 그런 다음 fuji_develop.py batch LUT.npz cull.json <DCIM dir> Deliverables/Photos (cull.json 키는 JPEG 번호 -> {raf, jpg, name}). 카메라 시계는 홈 타임존일 수 있음(웨딩 촬영 하나: -06:00, 로컬 = +8 h). 라이브 사운드가 있는 이벤트 클립: clip_edit.py edits/<spec>.json Video/<name>_4K.mp4 (음악 없음, L-컷 오디오; motion.py가 도움이 된다고 증명하지 않는 한 안정화는 꺼짐). agent-docs/photos/fuji-recipe.md 참조.
  • DJI Osmo 360 II (dji_osmo360ii, MP4 Encoder 태그 Osmo 360 II로 .OSV 발견): 두 개의 어안 스트림, 따라서 클립은 따로 설정됩니다(로그에 "N 360 clip(s) ... render them with osmo360.py"라고 표시됨) 그리고 부동산 편집에 도달하지 않습니다. osmo360.py CLIP.OSV Deliverables/Video는 그레이딩된 평면 리프레임(키프레임 이동)과 그레이딩된 등장방형 360을 작성합니다. 스티치는 보정되지 않았으며 수평이 맞춰지지 않았습니다. 렌즈는 오버랩에서 게인이 일치됩니다. 색상 모드는 이미지 원 내부의 신호에서 읽힙니다(일반 색상 vs D-Log M, 둘 다의 실제 클립에서 확인됨). D-Log M은 DJI의 Osmo 360 D-Log M LUT가 luts/official/에 있을 때까지 카메라 자체 프록시에 맞춰진 임시 LUT(luts/interim_dlogm_to_709_osmo360ii.cube)를 얻습니다. --spec edits/osmo_car_v1.json은 긴 클립의 키프레임 발췌를 렌더링합니다(자동차 테스트에서 운전자의 타이트한, 노출이 올려진 크롭). 평면 크롭은 가로로 18.6 x h_fov 실제 픽셀을 가집니다: 타이트한 크롭의 4K는 업스케일됩니다(agent-docs/video/osmo360.md). 카메라에는 내부 저장소와 SD 카드(두 볼륨)가 있습니다. 오프로드: shootpack offload <카드>가 자체적으로 찾습니다(Drops/Osmo360/).
  • 듀얼 슬롯 녹화: 두 카드의 동일한 파일이 감지되고(이름 + 촬영 시간 + 크기, 그 다음 해시) 슬롯 1 사본이 사용됩니다. 로그는 몇 개가 건너뛰어졌는지 알려줍니다.
  • GPS 없음(카메라 전용 촬영): 세션은 로컬 시계 시간으로 이름이 지정됩니다(아침 < 10:00, 정오 < 15:00, 오후 < 17:30, 저녁), 그레이딩은 이름을 따릅니다(정오/오후: 정오 룩, 그 외: 골든). --latlon을 전달하면 태양 대신 이름을 지정합니다. Sony 샷에는 지오메트리가 없으므로 태양 샷은 자동 태양 프로필을 얻지 못합니다: cull.json에서 수동으로 "sun": {"G18": "A"} 설정(자동 디벨롭은 어두운 태양-유리 프레임을 평탄하게 들어올림).
  • 새 카메라: 가장 가까운 프로필을 복사하고, detect.models, 센서/FOV, 브라켓 규칙 및 로그 곡선을 변경합니다.

단계

  1. 실행. 백그라운드에서 shootpack "<폴더>" --ceiling <사용자의 LAANC/항공 공간 천장, 기본값 120> (사진 ≈ 브라켓당 25초, 비디오 ≈ 4분). 모든 것을 <폴더>/Deliverables/_shootpack/에 캐시합니다.
  2. 큐레이션을 시각적으로 검토 — Deliverables/_shootpack/<세션>/all_stations.jpg와 각 Deliverables/Photos/<세션>/Picks_contact_sheet.jpg를 엽니다. 자동 큐레이션은 내용을 볼 수 없으므로 다음을 확인하고 수정합니다:
    • 프레임 가장자리에서 잘린 집 → 거부로 이동
    • 프레임 내 사람(종종 형광 조끼를 입은 조종사) → 대안, "PERSON-IN-FRAME" 메모
    • 거의 중복 / 지루한 반복 → 대안; 대안에 강한 샷 남음 → 선택
    • 천장 위의 샷은 이미 대안에 플래그 지정됨 — 언급하고 숨기지 마십시오 <세션>/cull.json 편집(키 G01…; 값은 짧은 이름), 영향을 받은 출력 삭제, --only photos로 재실행. 태양 샷은 자동으로 감지됩니다(태양 기하학에 의해 프레임 내부의 태양 + 가장 어두운 브라켓에서도 클리핑됨) 그리고 태양 프로필로 디벨롭됩니다: A = 태양이 피사체(자동 대비 -1.9스톱), C = 집이 피사체(-0.6스톱, 집이 밝게 유지됨). cull.json에서 샷별로 재정의: "sun": {"G21": "A", "G07": "off"}. 별 폭발: 브라켓 프레임이 눈에 보이는 태양 원반 주위에 선명한 회절 광선을 보여주면(각 프레임에서 태양 확인), "starburst": {"G21": "0209"}(프레임 번호)를 추가하고 --only photos --redo로 재실행; 구름 뒤에 있는 태양에는 절대 하지 마십시오(그 광선은 햇살이며 이미 병합에서 살아남습니다). 분홍색 클리핑된 구름이 있는지 태양 샷을 확인하십시오.
  3. 비디오 검토 — Deliverables/Video/*_storyboard.jpg 열기(3초당 한 프레임). 이륙/착륙, 조종사, 너무 어둡거나 반복적인 샷을 Deliverables/_shootpack/edit.json(클립, 시작, 길이, 속도, 스톱 단위 노출)을 편집하고 --only video로 재실행하여 교체하십시오. 클립의 프록시(DJI .LRF, Sony SUB/) 및 DJI .SRT(rel_alt, position)를 사용하여 더 나은 순간을 찾으십시오. 카메라 클립에는 원격 측정이 없으므로 이륙/착륙 트리밍 및 고도 대역이 적용되지 않습니다. 24p/30p 클립은 절대 느려지지 않습니다(50p+만 슬로우 모션을 제공할 수 있음).
  4. 그레이딩 — ~/shootpack/luts/official/에 DJI 공식 LUT가 있으면(Maginot: "DJI Mavic 4 Pro D-Log to Rec.709 V1.cube"), 모든 샷은 DJI의 LUT를 기술 베이스로 사용하고 그 위에 창의적인 룩을 추가합니다: luts/looks/dlog_golden_* (골든 아워: 더 따뜻하고, 더 차분한 파란색, 열린 그림자) 또는 dlog_midday_* (더 많은 대비/펀치). luts/looks/make_looks.sh가 이를 재구축합니다(build_look.py: _input.cube = 노출이 로그에 적용된 공식 LUT, FilmCraft의 Input 슬롯용; _look.cube = Rec.709→Rec.709, Creative 슬롯용; _composed.cube = 둘 다, ffmpeg용). 노출 리프트를 공식 LUT 전에 배치하십시오(--pre-exposure, 로그 스톱): DJI의 LUT는 자체 JPEG보다 어둡고, LUT 이후에 리프트하면 하늘이 클리핑됩니다(Maginot v5는 그 때문에 30-50% 너무 어둡게 나왔습니다). 공식 LUT가 없으면 곡선 기반 warm_print_v6 / warm_print_midday_v2가 사용됩니다. 항상 새 공식 LUT가 푸티지의 프로필과 일치하는지 확인하십시오(아래 참조).
  5. 음악(트레일러) — 사용자의 OAuth 커넥터를 통한 Epidemic Sound(API 키 절대 안 됨). 몽타주 컷(75 BPM = 3.2초 마디)과 일치하는 마디 길이의 악기 "빌드" 트랙을 검색하고 각 파형의 에너지 곡선을 읽으십시오: 조용한 인트로, 긴 빌드, 하나의 큰 드롭이 필요합니다. DownloadRecording (WAV, FULL)를 Deliverables/Music/에 다운로드한 다음, music.analyze(wav, given_bpm): 드롭이 다운비트에 맞는지 확인하십시오(그리드의 온/오프 비트 위상은 킥/베이스에서 오고, 마디 위상은 가장 큰 저음역 점프에서 옵니다). bar_chroma 유사도가 0.9 이상인 점프 X→Y를 선택하십시오(같은 코드, 들을 수 있는 접합 없음). 마디 그리드에서 전체 프레임 단위로 그림 시간을 맞추십시오(템플릿: edits/make_trailer_v7.py): 다운비트에서 컷, 드롭에서 피날레, 릴리스에서 엔드 카드. trailer.py는 spec["music"]을 모든 출력에 먹싱합니다. --music-only는 재렌더링 없이 재편집 및 재먹싱합니다. --size 1920x1080는 5분 타이밍 확인을 만듭니다(6K 렌더링 전에 비트에 대한 컷 측정). 클라이언트 취향(참조 촬영, v8-v11): 레터박스 없는 전체 16:9("letterbox": null), 텍스트 카드 없음, 디졸브 또는 딥 투 블랙 없음, 비트에 하드 컷, 마지막 샷으로 끝(음악 테일 아래 1초 "end_fade"는 괜찮음). "stabilize"로 부드러운 샷: 숫자 = 가우시안 시그마(초 단위, 1-2), {"poly": 2} = 균일한 움직임. 레터박스가 없으면 모든 수직 보정이 줌을 희생하므로 시그마를 보통으로 유지하십시오(참조 촬영 피날레: 1.25 = 6.6% 줌, 2.0은 12%가 됨); "reframe_y"는 레터박스가 있을 때만 도움이 됩니다. 움직임 끝에 집을 더 많이 유지하려면 샷을 느리게 하여 움직임에서 더 일찍 끝나게 하십시오. 렌더링에서 흔들림을 측정하십시오(stabilize.track on the preview) 전후; 드론 자체의 정지-역전은 부드럽게만 할 수 있고(더 무거운 시그마 + 0.85x), 제거할 수는 없습니다. Epidemic의 EditRecording은 requiredRegionsAtOffsets가 설정될 때마다 편집을 반환하지 않았으며, 제약 없는 60초 편집은 드롭을 완전히 떨어뜨렸습니다(2026년 10월), 그래서 우리가 직접 트랙을 컷합니다. 클라이언트 작업에는 상업용 Epidemic 플랜이 필요합니다. 물어보십시오.
  6. 전달 — 선택 연락처 시트, 720p 프리뷰(<30MB) 및 스토리보드를 SendUserFile로 보내십시오. Deliverables/SUMMARY.md에서 요약하십시오(개수, 플래그, 임시 사항). 재사용 가능한 코드 변경 사항을 저장소에 커밋하십시오.

진행 상황 표시

모든 변경 사항에 대해 전후를 제공하십시오: review_site/<shoot>/progress/*/manifest.json 업데이트(grade / photos / detail / cut / music) 및 progress_page.py로 재구축(progress_music.py는 음악 맞춤 차트를 그림); SendUserFile로 모바일 친화적인 시트 또는 스택 비교 비디오를 보내십시오.

중요한 사실

  • 항상 로우 파일(DJI DNG, Sony ARW)에서 디벨롭하십시오. JPG는 메타데이터/참조용일 뿐입니다. ARW 전용 샷은 _shootpack/previews/에 로우에서 추출한 참조 JPEG를 얻습니다. LightCraft는 Sony 자체 JPEG(음소거된 중립 폴백이 아님)에 맞춰진 룩으로 ARW를 렌더링하지만 Sony 렌즈 프로필은 없습니다: 왜곡/비네팅은 촬영된 그대로 유지됩니다. ARW의 HDR 병합은 색상 매트릭스나 화이트 밸런스가 없는 DNG를 씁니다(녹색으로 디벨롭됨): 파이프라인은 카메라의 보정을 씁니다(rawpy를 통한 LibRaw의 Adobe 파생 테이블의 ColorMatrix1, 샷의 AsShotNeutral) 그리고 그 파일을 디벨롭하므로 Sony 브라켓의 HDR_DNG/ 파일은 모든 로우 편집기에서 올바른 색상으로 열립니다.
  • LightCraft는 소스 옆에 *-HDR.dng를 씁니다. 파이프라인은 이를 Deliverables/HDR_DNG/로 이동합니다. 원본을 절대 수정하지 마십시오.
  • DJI MP4는 회전되어 저장됩니다(rotation=-90). ffprobe는 세로 크기를 보고하지만 가로로 재생됩니다.
  • Sony 카드: 슬롯당 전체 DCIM/ + PRIVATE/ 트리를 복사하십시오(Finder는 MTP 모드에서 카메라를 마운트할 수 없음 — 카드 리더기 또는 USB 대용량 저장소 사용); M01.XML 사이드카가 없으면 클립의 감마/색역이 신호만으로 폴백됩니다.
  • SRT DiffTime: 16ms = 59.94p → 부드러운 궤도를 위해 하프 스피드 컨폼을 29.97로.
  • 로그 곡선은 신호에서 클립별로 결정됩니다: ~10프레임의 휘도 코드 값 분포(p95 = 흰색이 있는 위치)는 프로필의 각 곡선 대역과 비교된 다음, 카메라 레이블(DJI SRT color_md, Sony XML CaptureGammaEquation), 그 다음 --log와 비교됩니다. 신뢰 순서: 명시적 --log, 그 다음 신호, 그 다음 레이블. 모든 불일치는 로그와 SUMMARY.md에서 WARNING입니다 — 렌더링하기 전에 읽으십시오. D-Log vs D-Log M: 일광에서 D-Log는 흰색을 약 0.55 코드로 유지합니다(하늘/태양을 위한 슈퍼 흰색 위; Maginot p95 0.44-0.69); D-Log M은 이를 0.8+ 근처에 둡니다. D-Log 푸티지에 D-Log M LUT를 적용하면 흰색이 ~50% 회색(평탄하고 둔함)으로 렌더링됩니다 — Maginot은 D-Log였습니다. 너무 어둡거나(야간) 대역 사이 = 결정 불가 → 레이블이 결정합니다. _shootpack/log/*.json이 통계를 캐시합니다.
  • 장치/곡선/색역별 LUT 일치: 정규화된 파일 이름 토큰으로 luts/official/의 공식 LUT("D-Log M"은 D-Log M으로 계산됨; Mavic 4 Pro LUT는 다른 DJI LUT보다 우선). 공식 LUT가 없는 DJI: 곡선 기반 웜 프린트 그레이드. Sony S-Log3: FilmCraft 내장 builtin:slog3-sgamut3cine-to-rec709(또는 -sgamut3-, XML의 CaptureColorPrimaries에서), luts/builtin/으로 내보냄; 우리의 D-Log 룩은 luts/looks/slog3_*_composed.cube로 그 위에 재구성되며, 사전 노출이 일치되어 18% 그레이가 DJI의 입력 LUT가 넣는 곳에 도달합니다(혼합 DJI + Sony 편집 일치). S-Cinetone/Rec.709/HLG 클립은 디코딩이 필요 없음: _look.cube만 사용.
  • edit.json의 노출은 클립 곡선의 스톱당 코드 값으로 리프트됩니다(lift: D-Log 67, S-Log3 79).
  • LightCraft 태양 샷: light.whites를 0으로 유지하고 light.highlights를 -60 또는 더 부드럽게 유지하십시오. 더 강한 복구 또는 마젠타 색조는 클리핑된 구름을 흰색 아래로 끌어내리고 분홍색으로 렌더링합니다.
  • 6K 렌더링: trailer.py는 섹션으로 렌더링합니다(하드 컷과 딥 투 블랙에서 분할) — 14개의 병렬 6K 디코드는 16GB 메모리에서 메모리 부족이 발생합니다.
  • 여유 디스크 확인: 각 HDR DNG ≈ 300MB; 파이프라인은 5GB 미만에서 중지됩니다.

관련 스킬