YAML Metadata Warning:empty or missing yaml metadata in repo card

Check out the documentation for more information.

만화 이미지 속 글자를 한 번에 번역합니다. 일본 만화, 한국 웹툰, 서양 코믹스는 물론 흑백·컬러 페이지를 모두 인식할 수 있습니다. 텍스트 검출, OCR, 번역, 인페인팅, 식자를 자동으로 처리하며, 텍스트 상자를 조정할 수 있는 시각 편집기가 내장되어 있습니다.

StoneCandy

📚 문서 안내

아래 상세 문서는 영어 버전이 있으면 영어 문서로, 없으면 중국어 원문으로 연결됩니다.

문서	설명
설치 가이드	상세 설치 절차, 시스템 요구 사항, 분할 압축 안내
사용 가이드	기본 조작, 번역기 선택, 자주 쓰는 설정
명령줄 모드	명령줄 사용법, 인자 설명, 일괄 처리
API 설정	API Key 발급 및 설정 방법
기능 소개	전체 기능 목록, 시각 편집기 상세 설명
작업 흐름	여러 작업 흐름, AI 줄바꿈, 사용자 지정 템플릿
설정 설명	번역기 설정, OCR 모델, 파라미터 상세
디버깅 가이드	디버깅 절차, 조절 가능한 파라미터, 문제 해결
개발자 가이드	프로젝트 구조, 환경 구성, 빌드·패키징

중국어 원문 문서는 doc/ 폴더에서 확인할 수 있습니다.

✨ Showcase

번역 전	번역 후

✨ 핵심 기능

번역 기능

🔍 스마트 텍스트 검출 - 만화 속 글자 영역을 자동으로 인식합니다
📝 다국어 OCR - 일본어, 중국어, 영어 등 여러 언어를 지원합니다
🌐 다양한 번역 엔진 - OpenAI, Gemini, Vertex, Sakura (고품질 모드 포함)
🎯 고품질 번역 - GPT-4o, Gemini 멀티모달 AI 번역을 지원합니다
📚 용어 자동 추출 - AI가 고유명사를 인식·축적해 번역 일관성을 유지합니다
🤖 AI 스마트 줄바꿈 - 가독성을 높이고 줄바꿈을 자동으로 최적화합니다
🎨 스마트 식자 - 번역문을 자동 조판하며 여러 글꼴을 지원합니다
📥 PSD 내보내기 - 원본 / 복원 이미지 / 텍스트가 분리된 편집 가능한 PSD를 내보냅니다
📦 일괄 처리 - 폴더 전체를 한 번에 처리합니다

시각 편집기

✏️ 영역 편집 - 텍스트 상자를 이동, 회전, 변형합니다
📐 텍스트 편집 - 수동 번역과 스타일 조정을 지원합니다
🖌️ 마스크 편집 - 브러시와 지우개 도구를 제공합니다
⏪ 실행 취소 / 다시 실행 - 전체 작업 이력을 지원합니다
⌨️ 단축키 - A / D로 이미지 전환, Q / W / E로 도구 전환, [ / ]로 글꼴 크기 조절, Ctrl+A로 텍스트 상자 전체 선택, Ctrl+Q로 이미지 내보내기
🖱️ 마우스 휠 단축키 - Shift+휠로 브러시 크기 조절

전체 기능 소개 → doc/en/FEATURES.md

📖 사용 가이드

🖥️ Qt UI 모드

설치가 끝나면 사용 가이드를 보고 이미지 번역 방법을 확인하세요.

사용 가이드 → doc/en/USAGE.md

기본 단계:

온라인 번역기를 쓸 경우 API 정보를 입력합니다 → API 설정 가이드
CPU 빌드를 쓰는 경우 GPU 사용을 끕니다
출력 디렉터리를 설정합니다
이미지를 추가합니다
번역기를 선택합니다
- 처음 사용할 때 권장: 고품질 번역 OpenAI 또는 고품질 번역 Gemini
- Google 공식 Key를 따로 관리하려면 고품질 번역 Vertex도 사용할 수 있습니다
- API Key 설정이 필요합니다. API 설정 가이드를 참고하세요
번역을 시작합니다

⌨️ 명령줄 모드

일괄 처리와 자동화 스크립트에 적합합니다.

명령줄 가이드 → doc/en/CLI_USAGE.md

⚠️ 중요: 명령줄을 사용하기 전에 프로젝트 디렉터리에서 가상 환경을 먼저 활성화하세요.
# Windows
conda activate manga-env

# Linux/macOS
conda activate manga-env

빠른 시작:

# Local 모드 (권장, 명령줄 번역)
python -m manga_translator local -i manga.jpg

# 짧은 형식 (기본값은 Local 모드)
python -m manga_translator -i manga.jpg

# 폴더 전체 번역
python -m manga_translator local -i ./manga_folder/ -o ./output/

# Web 서버 모드 (관리 UI와 API 포함)
python -m manga_translator web --host 127.0.0.1 --port 8000 --use-gpu

# 모든 인자 보기
python -m manga_translator --help

📋 작업 흐름

이 프로그램은 여러 작업 흐름을 지원합니다.

일반 번역 - 이미지를 바로 번역합니다
번역 내보내기 - 번역한 뒤 번역문을 TXT 파일로 내보냅니다
원문 내보내기 - 검출과 OCR만 수행한 뒤 원문을 내보내 수동 번역에 사용합니다
번역 가져오기 후 렌더 - TXT 또는 JSON에서 번역 내용을 가져와 다시 렌더합니다

현재 Qt UI에는 JSON만 번역, 채색만, 업스케일만, 인페인트만, 번역 치환 같은 추가 작업 흐름도 있습니다.

작업 흐름 상세 → doc/en/WORKFLOWS.md

🔍 도움이 필요하신가요?

번역 품질이 기대에 미치지 않을 때

설정에서 상세 로그를 켭니다 (설정 → 일반)
result/ 디렉터리의 디버그 파일을 확인합니다
검출기와 OCR 관련 파라미터를 조정합니다
원인 파악이 끝나면 오래된 로그와 디버그 폴더를 정리해 result/가 너무 커지지 않게 합니다

디버깅 가이드 → doc/en/DEBUGGING.md

⭐ Star 추이

🙏 감사의 글

zyddnys/manga-image-translator - 핵심 번역 엔진
bilibili/ailab - Real-CUGAN 초해상도 모델
the-database/MangaJaNai - MangaJaNai / IllustrationJaNai 초해상도 모델
lhj5426/YSG - 모델 지원
huyvux3005/manga109-segmentation-bubble - MangaLens Bubble Segmentation 말풍선 분할 모델
PaddleOCR - OCR 모델 지원
kha-white/manga-ocr - MangaOCR 모델 지원
NopeNopeGuy/hayai-ocr - Hayai OCR v2 모델 지원
PaddlePaddle/PaddleOCR-VL-1.5 - 공식 PaddleOCR-VL-1.5 모델 페이지
모든 기여자와 사용자를 응원합니다

❤️ 제작자 후원

이 프로젝트가 도움이 되었다면, 제작자에게 밀크티 한 잔을 사 주셔도 좋습니다 🧋

💚 위챗 후원

💙 알리페이 후원

후원해주셔서 감사합니다 ✨

📝 라이선스

이 프로젝트는 GPL-3.0 라이선스로 오픈소스입니다.

모델 라이선스 안내

이 프로젝트의 소스 코드는 GPL-3.0 라이선스를 사용합니다.

이 프로젝트는 이미지 초해상도에 MangaJaNai / IllustrationJaNai 모델 가중치를 사용할 수 있습니다. 해당 모델 가중치는 CC BY-NC 4.0(저작자표시-비영리 4.0 국제) 라이선스이며, 비상업적 용도로만 사용할 수 있습니다.

모델 출처: MangaJaNai
모델 라이선스: CC BY-NC 4.0
사용 제한: 비상업적 용도만 허용

⚠️ 특별 고지

이 프로젝트는 기술 시연, 개인 학습, 교류 목적으로만 제공되며 법률, 상업, 컴플라이언스 자문을 구성하지 않습니다.

이 프로젝트와 관련 기능을 설치, 구성, 호출, 배포할 때는 현지 법령, 플랫폼 규칙, 콘텐츠 출처 라이선스, 제3자 서비스 약관을 직접 확인하고 지속적으로 준수해야 합니다.

면책 및 책임 제한

이 프로젝트 사용으로 발생하는 모든 행위와 결과(콘텐츠 처리, 게시, 전파, 재배포, 상업적 이용을 포함하되 이에 한정되지 않음)는 사용자가 단독으로 책임집니다.
이 프로젝트를 불법·규정 위반 용도로 사용해서는 안 됩니다. 여기에는 불법 복제 배포, 무단 대량 수집·전재, 플랫폼 제한 우회, 사기, 명예훼손, 타인의 정당한 권익 침해 등이 포함됩니다.
이 프로젝트는 OCR, 번역, 초해상도 관련 서비스를 포함한 제3자 모델, API, 데이터, 라이브러리에 의존합니다. 가용성, 정확성, 안정성, 요금, 리스크 관리, 컴플라이언스 요구 사항은 해당 제공자가 책임지며, 관련 위험과 비용은 사용자가 부담합니다.
적용 법령이 허용하는 최대 범위에서, 프로젝트 제작자와 기여자는 이 프로젝트의 사용 또는 사용 불능으로 인한 직접·간접 손실(데이터 손실, 업무 중단, 수익 손실, 계정 위험, 제3자 청구를 포함하되 이에 한정되지 않음)에 대해 책임지지 않습니다.
팀이나 조직 환경에서 이 프로젝트를 사용할 경우, 권한 관리, 로그 감사, 콘텐츠 심사, 컴플라이언스 평가를 직접 수행하고 필요한 사람 검토 절차를 마련해야 합니다.

사용 전에 위험을 신중히 평가하세요. 계속 사용하는 것은 위 고지를 읽고 이해했으며 이에 동의하는 것으로 간주됩니다.

Downloads last month: -; Downloads are not tracked for this model. How to track

Inference Providers NEW

This model isn't deployed by any Inference Provider. 🙋 Ask for provider support