2nd/10_Wiki/Comfyui/PNG Metadata Chunks.md

---
id: png-metadata-chunks
title: "PNG Metadata Chunks"
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-frontend-package/src/scripts/metadata", "exiftool -b -workflow"]
github_commit: ""
---

# [[PNG Metadata Chunks]]

## 🎯 한 줄 통찰 (One-line insight)
PNG 이미지의 표준 데이터 블록에 워크플로우의 시각적 구조와 실행 로직을 동시에 내장하여, 이미지 파일 자체를 **휴대 가능한 독립적 실행 스크립트**로 변모시키는 핵심 메커니즘 [1-3].

## 🧠 핵심 개념 (Core concepts)
- **tEXt 및 zTXt 청크 (Chunks):** ComfyUI가 워크플로우 데이터를 저장하기 위해 활용하는 PNG 표준의 텍스트 데이터 보관 영역이다 [2].
- **메타데이터 주입 (Metadata Injection):** `Save Image` 노드가 실행될 때, 최종 이미지 데이터와 함께 전체 노드 그래프, 레이아웃 설정, 프롬프트를 파일의 숨겨진 영역에 주입하는 프로세스다 [1, 4].
- **데이터 이원화 (Bifurcation):** 하나의 이미지 내에 시각적 편집을 위한 'Frontend 포맷(workflow)'과 프로그래밍 방식의 실행을 위한 'API 포맷(prompt)' 정보를 중복 저장하여 호환성을 확보한다 [2].
- **데이터 취약성 (Data Fragility):** 표준 이미지 편집기, 소셜 미디어 플랫폼, 또는 파일 압축 유틸리티를 거칠 경우 비필수적인 메타데이터 청크가 제거되어 워크플로우 정보가 유실될 위험이 크다 [2, 5].

## 🧩 추출된 패턴 (Extracted patterns)
- **종단 노드 자동 기록 패턴:** 거의 모든 워크플로우가 `Save Image` 노드에서 종료되며, 이 노드가 실행되는 순간 현재 캔버스의 모든 상태를 이미지 메타데이터에 자동으로 동기화한다 [1].
- **드래그 앤 드롭 복구 패턴:** 사용자가 PNG 파일을 ComfyUI 캔버스로 드래그하면, 시스템이 메타데이터 청크를 파싱하여 즉시 노드 레이아웃과 설정을 재현한다 [1, 5, 6].
- **CLI 기반 벌크 추출 패턴:** 다수의 이미지에서 수동 조작 없이 워크플로우를 대량으로 회수하기 위해 `exiftool`과 같은 명령줄 도구를 활용하여 특정 청크 데이터를 추출한다 [7, 8].

## 📖 세부 내용 (Details)
ComfyUI 워크플로우는 전형적인 시각적 프로그래밍의 결과물로, 이를 PNG 파일의 **메타데이터 청크**에 저장함으로써 이동성과 재현성을 극대화한다 [1, 9].

- **청크의 기술적 구성:**
    - 주로 **tEXt** 또는 압축된 형태인 **zTXt** 청크를 사용하여 두 가지 주요 문자열을 저장한다 [2].
    - 하나는 사용자 인터페이스(UI) 상의 노드 위치, 크기, 그룹화 정보를 포함한 **Frontend JSON** 데이터다 [2, 10].
    - 다른 하나는 서버 백엔드에서 즉시 실행 가능한 형태인 **API JSON(Prompt)** 데이터로, 시각적 정보가 제거된 압축된 실행 그래프다 [2, 10, 11].

- **워크플로우 추출 및 분석:**
    - 이미지에서 워크플로우를 추출하기 위해 전용 웹 도구나 Python 라이브러리가 사용되기도 한다 [8, 12].
    - 명령줄 도구인 `exiftool`을 사용할 경우, `-workflow` 태그를 지정하여 바이너리 데이터를 JSON 파일로 분리해낼 수 있다 [7, 8].
    - 공식적인 메타데이터 파싱 로직은 ComfyUI 프론트엔드 패키지의 자바스크립트 컨텍스트 내에서 관리된다 [13].

- **장점 및 한계:**
    - 별도의 JSON 파일을 관리할 필요 없이 이미지 하나로 모든 생성 정보를 공유할 수 있다는 점이 가장 큰 장점이다 [14].
    - 그러나 파일이 온라인에 게시되거나 재가공될 때 메타데이터가 삭제(Stripped)되는 경우가 빈번하며, 매우 복잡하거나 최신 커스텀 노드가 포함된 경우 간혹 일부 노드 정보가 유실될 수 있다는 기술적 한계가 보고되었다 [2, 4, 12].

## ⚖️ 모순 및 업데이트 (Contradictions & updates)
- **저장 안정성 논란:** 첫 번째 저장 방식인 '이미지 메타데이터' 방식은 가장 간편하지만, 소스에 따르면 복잡한 노드나 특정 커스텀 노드를 누락할 가능성이 있어, 보다 확실한 백업을 위해서는 두 번째 방식인 **수동 JSON 파일 저장**이 권장된다 [4].
- **포맷 호환성 이슈:** ComfyUI의 빈번한 업데이트로 인해, 과거 이미지 메타데이터에 내장된 구버전 JSON 형식이 최신 버전의 인터페이스에서 정상적으로 작동하지 않을 수 있다는 점이 지적되었다 [5].

## 🛠️ 적용 사례 (Applied in summary)
- **Exiftool 추출 명령:** `exiftool -b -workflow input.png > workflow.json` 명령어를 통해 PNG의 메타데이터 청크에서 워크플로우 JSON을 격리하여 저장하는 사례가 확인된다 [7, 8].
- **Frontend 파싱 위치:** 공식적인 메타데이터 파싱 로직은 `comfyui-frontend-package` 내부의 `src/scripts/metadata` 경로에서 구현 및 관리되고 있다 [13].
- **커스텀 노드 연동:** `pythongosssss`의 워크플로우 이미지 생성 노드 등을 통해 워크플로우 정보가 포함된 이미지를 생성하고, 이를 다시 `workflow_templates`로 활용하기 위해 JSON을 추출하는 작업 흐름이 존재한다 [15].
- **온라인 추출 도구:** `weirdwonderfulai.art` 등에서 제공하는 워크플로우 추출기는 사용자가 드롭한 PNG의 메타데이터 청크를 분석하여 JSON 파일로 다운로드할 수 있게 한다 [12, 16].

## ✅ 검증 상태 및 신뢰도
- **상태:** draft
- **검증 단계:** conceptual (실제 적용 사례 발견 시 applied/validated로 승격 가능)
- **출처 신뢰도:** B (Official Documentation / Primary Source via NotebookLM)
- **중복 검사 결과:** 신규 생성 (New discovery)

## 📝 변경 이력 (Change history)
- 2026-05-19: Initial draft generated via Datacollector_MAC P-Reinforce engine.