README.md

ACaGCView (AI 그림 채널 뷰어)

ACaGCView는 AI가 생성한 이미지를 포함한 다양한 이미지 파일을 효율적으로 탐색하고, 이미지에 포함된 메타데이터를 상세하게 분석하여 표시해주는 PySide6 기반의 이미지 뷰어입니다. EXIF 정보, PNG 텍스트 청크는 물론, NovelAI와 같은 AI 이미지 생성 도구에서 사용되는 "스텔스" 메타데이터까지 추출하여 사용자에게 유용한 정보를 제공합니다.

✨ 주요 기능

• 다양한 이미지 형식 지원: PNG, JPG, JPEG, JFIF, BMP, WebP, AVIF 등 널리 사용되는 이미지 형식을 지원합니다.
• 포괄적인 메타데이터 추출:
  • 표준 EXIF 데이터 (카메라 정보, 촬영 설정 등)를 추출합니다.
  • PNG 이미지의 텍스트 청크 정보를 파싱합니다.
  • sd-parsers 라이브러리를 활용하여 AI 생성 이미지(예: NovelAI)에 내장된 "스텔스" 메타데이터(프롬프트, 설정 등)를 전문적으로 추출합니다.
• 직관적인 사용자 인터페이스:
  • 깔끔하고 반응성이 뛰어난 PySide6 기반의 GUI를 제공합니다.
  • 드래그 앤 드롭: 이미지 파일 또는 폴더를 애플리케이션 창으로 드래그 앤 드롭하여 쉽게 로드할 수 있습니다.
  • 키보드 단축키:
    • ← / →: 이전 / 다음 이미지 보기
    • Home / End: 폴더의 첫 / 마지막 이미지로 이동
    • Tab: 현재 이미지의 모든 메타데이터 정보 보기 (토글)
• Windows 컨텍스트 메뉴 통합: 지원되는 이미지 파일에 대해 마우스 오른쪽 클릭 메뉴에 "ACaGCView로 열기" 옵션을 쉽게 추가하거나 제거할 수 있습니다 (관리자 권한 필요).
• 메타데이터 관리: 추출된 메타데이터를 쉽게 복사하거나 텍스트 파일로 저장할 수 있습니다.
• 환영 화면: 애플리케이션 시작 시 유용한 키보드 단축키와 제작자 정보를 표시합니다.

🚀 설치 및 실행

의존성

이 프로젝트는 Python 3.x 환경에서 다음 라이브러리들을 필요로 합니다:

• PySide6
• Pillow (PIL)
• sd-parsers

다음 명령어를 사용하여 필요한 라이브러리를 설치할 수 있습니다:

pip install PySide6 Pillow sd-parsers

실행

1. 소스 코드 실행:

   python main.py

   특정 이미지 파일이나 폴더를 바로 열려면 인자로 경로를 전달할 수 있습니다:

   python main.py "C:\path\to\your\image.png"
   python main.py "C:\path\to\your\image_folder"

2. 실행 파일 (PyInstaller 빌드) 실행: PyInstaller를 사용하여 빌드된 실행 파일이 있다면, 해당 실행 파일을 직접 실행합니다.

💡 사용법

1. 이미지 로드:
   • ACaGCView를 실행한 후, 이미지 파일이나 이미지가 포함된 폴더를 애플리케이션 창으로 드래그 앤 드롭합니다.
   • 실행 시 명령줄 인자로 이미지 파일 또는 폴더 경로를 지정할 수도 있습니다.
2. 이미지 탐색:
   • ← (왼쪽 화살표) 키를 눌러 이전 이미지를 봅니다.
   • → (오른쪽 화살표) 키를 눌러 다음 이미지를 봅니다.
   • Home 키를 눌러 현재 폴더의 첫 번째 이미지로 이동합니다.
   • End 키를 눌러 현재 폴더의 마지막 이미지로 이동합니다.
3. 메타데이터 확인:
   • Tab 키를 눌러 현재 이미지의 메타데이터 정보를 표시하는 대화 상자를 열거나 닫습니다.
   • 메타데이터 대화 상자에서 "복사", "저장", "다른 이름으로 저장" 버튼을 사용하여 메타데이터를 관리할 수 있습니다.
4. Windows 컨텍스트 메뉴:
   • 환영 화면에 있는 "윈도우 우클릭 메뉴에 추가" 버튼을 클릭하여 지원되는 이미지 파일에 대한 컨텍스트 메뉴 항목을 추가할 수 있습니다. (관리자 권한으로 실행해야 합니다.)
   • "윈도우 우클릭 메뉴에서 제거" 버튼을 클릭하여 추가된 컨텍스트 메뉴 항목을 제거할 수 있습니다.

👨‍💻 제작자

AI그림채널 @아주커마니커

---