Files
2nd/10_Wiki/Topics/Comfyui/exiftool.md
T
2026-05-19 18:08:09 +09:00

58 lines
4.9 KiB
Markdown

---
id: exiftool
title: "exiftool"
category: "10_Wiki/Topics"
status: "draft"
verification_status: "conceptual"
canonical_id: ""
aliases: []
duplicate_of: ""
source_trust_level: "B"
confidence_score: 0.85
created_at: 2026-05-19
updated_at: 2026-05-19
review_reason: ""
merge_history: []
tags: ["research", "Comfyui workflow json 생성 방법"]
raw_sources: ["NotebookLM Synthesis"]
applied_in: ["ComfyUI.config"]
github_commit: ""
---
# [[exiftool]]
## 🎯 한 줄 통찰 (One-line insight)
`exiftool`은 미디어 파일의 메타데이터 청크 내에 임베딩된 ComfyUI 워크플로 JSON 데이터를 추출, 삽입 및 복구하기 위한 표준 명령줄 유틸리티이다. [1], [2]
## 🧠 핵심 개념 (Core concepts)
1. **메타데이터 추출 (Metadata Extraction):** PNG 파일의 `tEXt` 또는 `zTXt` 청크와 같은 바이너리 태그에서 직렬화된 워크플로 JSON을 독립된 파일로 분리한다. [3], [1]
2. **워크플로 복구 (Workflow Recovery):** 이미지 편집기(예: GIMP) 사용으로 인해 삭제된 메타데이터를 원본 파일에서 추출하여 재삽입함으로써 워크플로의 무결성을 유지한다. [4], [2]
3. **비표준 태그 정의 (Non-standard Tag Definition):** ComfyUI 워크플로 데이터는 비표준 태그에 저장되므로, 쓰기 작업을 수행할 때는 해당 태그를 허용하는 구성 설정이 필요하다. [2]
## 🧩 추출된 패턴 (Extracted patterns)
- **바이너리 출력 패턴:** `-b` 플래그를 사용하여 특정 태그(`-workflow`)의 원시 데이터를 캡처하고 리다이렉션(`>`)을 통해 JSON 파일로 저장하는 전략을 사용한다. [1], [2]
- **설정 기반 삽입 패턴:** `exiftool`이 등록되지 않은 태그 쓰기를 거부하는 문제를 해결하기 위해 `%unreg` 지시어를 포함한 설정 파일을 참조하여 비표준 태그에 데이터를 주입한다. [2]
## 📖 세부 내용 (Details)
`exiftool`은 ComfyUI 워크플로 관리 및 디지털 포렌식에서 핵심적인 역할을 수행하는 도구이다. [1] ComfyUI는 이미지 생성 시 `Save Image` 노드를 통해 워크플로(Frontend 포맷)와 프롬프트(API 포맷) 정보를 PNG 메타데이터에 주입하는데, `exiftool`은 이러한 바이너리 태그를 읽고 쓰는 데 최적화되어 있다. [5], [3], [1]
구체적인 기술적 상세는 다음과 같다:
- **추출 메커니즘:** 대규모 이미지 저장소에서 드래그 앤 드롭 방식의 수동 추출이 비효율적일 때, `exiftool -b -workflow input.png > workflow.json` 명령을 통해 워크플로를 일괄적으로 격리할 수 있다. [1] 이는 이미지 내부의 직렬화된 JSON 데이터를 보존하면서 파일 시스템으로 인출하는 표준적인 방법이다. [1]
- **삽입 및 복사:** 단순한 추출을 넘어, 한 이미지의 워크플로를 다른 미디어(PNG, WebP, MP4 등)로 복사하거나 재삽입하는 것이 가능하다. [4] 단, 워크플로 태그는 표준 규격이 아니므로, `exiftool`은 기본적으로 이 태그에 대한 수정을 거부할 수 있다. 이를 해결하기 위해 사용자는 태그를 미등록(`%unreg`) 상태로 정의하는 별도의 설정 파일을 활용해야 한다. [2]
- **대안 도구와의 관계:** `Comfy_UI_prompt_extractor``comfymeta` 등 특정 목적을 가진 CLI 및 UI 도구들이 존재하지만, `exiftool`은 가장 원형적인 유틸리티로서 워크플로 삽입 및 복사 기능을 구현하는 기반 기술로 언급된다. [2]
## ⚖️ 모순 및 업데이트 (Contradictions & updates)
- **데이터 휘발성:** `exiftool`의 성능과 관계없이, 메타데이터 자체가 취약하다는 점이 지적된다. 소셜 미디어 플랫폼이나 표준 이미지 압축 유틸리티는 파일 크기 절감 및 프라이버시 보호를 위해 워크플로 JSON이 포함된 비필수 메타데이터를 제거하는 경우가 많으므로, 원본 파일이 아닐 경우 `exiftool`을 통한 추출이 불가능할 수 있다. [6], [7], [3]
## 🛠️ 적용 사례 (Applied in summary)
- **ComfyUI.config 활용:** 워크플로 데이터를 비표준 태그에 추가하기 위해 `exiftool` 설정 파일에서 해당 태그를 `%unreg`로 정의하여 사용한 사례가 보고되었다. [2]
- **CLI 워크플로 추출:** `exiftool -b -workflow input.png > workflow.json` 명령어를 통해 PNG 파일에서 워크플로 데이터를 직접 추출하여 JSON 파일로 변환하는 방식이 표준으로 사용된다. [1], [2]
## ✅ 검증 상태 및 신뢰도
- **상태:** draft
- **검증 단계:** conceptual (실제 명령어와 설정 파일 적용 방식이 소스 내에 기술됨)
- **출처 신뢰도:** B (Official Documentation 및 GitHub Issue 기반 기술 명세)
- **중복 검사 결과:** 신규 생성 (New discovery)
## 📝 변경 이력 (Change history)
- 2026-05-19: Initial draft generated via Datacollector_MAC P-Reinforce engine.