파일 구성 가이드

아래 구조를 꼭 따를 필요는 없습니다. 지금 가진 이미지 폴더와 ZIP도 그대로 열리지만, 표지 파일을 따로 두고 회차 이름을 맞춰 두면 작품을 더 정확하게 알아봅니다.

01 · 웹툰과 회차형 만화

작품 폴더 아래에 회차를 나눕니다

작품명 폴더의 최상위에 표지와 메타데이터를 두고, 각 회차는 하위 폴더나 CBZ 같은 압축파일로 구성합니다. 회차는 이름 순서대로 표시되며, 숫자는 1, 2, 10처럼 크기 순으로 정렬합니다.

권장 폴더 구조

내 웹툰/
├─ cover.jpg
├─ readme.txt
├─ 001화/
│  ├─ 001.jpg
│  ├─ 002.jpg
│  └─ 003.jpg
├─ 002화.cbz
└─ 003화/
   ├─ 001.webp
   └─ 002.webp

회차 이름은 001화, 제2화, ch03, vol.04처럼 일관되게 작성합니다.
회차가 두 개 이상 있어야 하나의 작품으로 잘 묶입니다.
각 회차 안의 이미지도 파일 이름 순서대로 읽습니다.
최상위의 표지 이미지는 본문 페이지에서 제외됩니다.

02 · 텍스트 소설

표지 한 장과 TXT 본문을 ZIP에 담습니다

이미지가 없거나 한 장뿐이고 본문 TXT가 하나 이상이면 텍스트 소설로 인식합니다. 본문은 전체.txt 한 파일로 작성해도 되고, 1부.txt, 2부.txt처럼 여러 파일로 나눠도 됩니다. 여러 TXT는 파일 이름 순서대로 이어 붙여 한 권처럼 읽습니다.

본문을 한 파일로 관리할 때

내 소설.zip
├─ cover.jpg
├─ readme.txt
└─ 전체.txt

본문을 여러 부로 나눌 때

내 소설.zip
├─ cover.jpg
├─ readme.txt
├─ 1부.txt
└─ 2부.txt

readme.txt는 메타데이터이므로 본문에서 제외됩니다.
이미지가 두 장 이상 들어 있으면 만화책으로 인식될 수 있습니다.
압축하지 않은 폴더에 TXT만 있으면 TXT 파일이 각각 한 권으로 보입니다. 여러 TXT를 한 권으로 묶으려면 ZIP으로 묶어 주세요.
본문 파일은 UTF-8로 저장하는 것이 좋습니다. EUC-KR 같은 예전 인코딩도 자동으로 알아봅니다.
본문은 파일 하나에 32MB, 한 권 전체 64MB까지 열 수 있습니다.

03 · 작품 메타데이터

readme에 작품 정보를 기록합니다

작품 최상위의 readme.txt 또는 readme.md 맨 앞에 아래처럼 적습니다. YAML과 비슷해 보이지만, 한 줄에 key: value 하나씩 쓰는 간단한 형식입니다.

모든 필드는 선택 사항입니다. 필요한 항목만 적으면 됩니다. 적지 않은 항목은 앱에 저장된 값이 그대로 유지되고, 잘못 쓴 값이나 모르는 항목은 그냥 건너뜁니다.

readme.txt 예시

---
tags: 판타지, 성장, 모험
rating: 5
status: reading
author: 홍길동
publisher: 좋아출판
source_url: https://example.com/books/1
note: 다시 읽고 싶은 작품
---

tags쉼표로 구분한 태그

rating0부터 5까지의 정수

statusreading · completed · dropped · on_hold

author저자 또는 작가

publisher출판사 또는 연재처

source_urlhttp 또는 https 원문·구매 링크

note작품 메모

readme는 책 정보 화면을 열 때 가져오며, 기본 설정은 자동 적용입니다. 파일과 앱의 값이 다르면 파일이 우선합니다. 압축파일 안의 readme는 처음 한 번만 자동으로 가져오므로, 나중에 고쳤다면 책 정보 화면의 readme 다시 가져오기를 눌러 주세요.

앱에서 고친 정보는 readme.txt에도 저장됩니다

책 정보나 책장 일괄 편집에서 평가·상태·태그·메모 등을 바꾸면, 설정의 바꾼 책 정보를 readme.txt에 저장이 켜져 있을 때(기본값) 다음 위치에 함께 저장됩니다.

폴더로 된 책: 폴더의 readme 파일에 저장합니다.
소설 ZIP(표지 + 본문 TXT): ZIP 안의 readme.txt에 저장합니다.
만화 압축파일과 단독 TXT: 파일은 그대로 두고 앱 안에만 저장합니다.

참고: title, ComicInfo.xml, info.json은 현재 메타데이터로 가져오지 않습니다. 앱이 readme에 저장할 때는 --- 사이의 내용을 앱의 값으로 새로 쓰므로, 지원하지 않는 필드와 그 안의 주석은 사라집니다. --- 아래의 본문은 그대로 남습니다.

온라인에서 책 정보 가져오기

설정의 온라인 정보 가져오기를 켜면 책 정보 화면에서 한 권씩 저자·연재처·태그를 검색해 채울 수 있습니다. 이 기능은 기본으로 꺼져 있으며, 켜면 책 제목이 MangaDex로 전송됩니다. 결과를 적용하면 폴더로 된 책에는 readme.txt를 쓰고, 단독 TXT는 본문과 readme를 담은 소설 ZIP으로 바꿉니다. 표지는 기기에서 직접 선택할 수 있습니다.

04 · 표지

cover 파일은 작품 최상위에 둡니다

cover.jpg, cover.jpeg, cover.png, cover.webp, cover.gif를 대소문자 구분 없이 인식합니다. 회차 폴더 안이 아니라 작품 폴더나 압축파일의 최상위에 둡니다.

표지는 아래 순서로 정합니다.

앱에서 직접 지정한 표지(표지 변경, 표지 일괄 설정)
최상위의 cover.*
소설처럼 이미지가 한 장뿐인 구조라면 그 이미지
정렬된 첫 번째 본문 이미지

표지를 찾지 못한 책은 제목 타일로 표시합니다. 책이 아닌 일반 폴더는 안에 든 작품 표지를 최대 4개까지 모자이크로 보여 줍니다.

참고: cover.*를 본문 페이지에서 빼는 동작은 폴더와 ZIP·CBZ에 적용됩니다. RAR·CBR, 7z·CB7에서는 표지 파일이 첫 페이지로 함께 보일 수 있습니다.

05 · 정리 요령

다른 앱에서도 알아보기 쉽게 정리합니다

회차와 페이지 번호는 001, 002처럼 자릿수를 맞춥니다.
작품 폴더 안에는 한 작품의 회차만 보관합니다.
ZIP·CBZ 안의 __MACOSX 같은 macOS 보조 파일은 자동으로 무시됩니다. 다른 형식이나 압축을 푼 폴더에서는 미리 지워 주세요.
페이지 이미지는 JPG, PNG, WebP, GIF를 사용합니다.
암호가 걸린 압축파일은 지원하지 않으며, 손상된 압축파일은 열리지 않을 수 있습니다.