GitHub Hot Board

GitHub Hot Board · Repository archive

ucx0204/CarrotMangaTranslator

Open-source desktop OCR, AI translation, editing and inpainting tool for user-provided manga and comic images. (This description comes from the repository itself.)

TypeScript#ai-translation#comic-translation#desktop-app

Data at October 29ucx0204

Best

#205

Underappreciated Gems

100

Total stars

19

Total forks

1

Days on boards (30d)

License: GPL-3.0Last push: October 28Open issues: 0Collected since 2026-10-25; unknown = not yet harvested

README

당근망가번역기

당근망가번역기

만화 원고의 OCR → 번역 → 원문 제거 → 식자·검수 → 출력을 처리하는 데스크톱 앱입니다. OCR은 이미지 속 글자를 읽는 단계, 식자는 번역문을 원고에 배치하는 단계입니다. Gemma 로컬·Codex·Claude Code·OpenAI 호환 API로 번역하고, 앱 안의 채팅이나 외부 AI 앱의 MCP 연결로 보관함 조회·편집·출력을 요청할 수 있습니다.

한국어 · English · 日本語 · 简体中文 · 繁體中文

v3.7.7 다운로드 · 릴리스 노트 · 오류·제안

Windows 10/11 · Apple Silicon macOS 14+ · GPL-3.0-only

새 작업 화면: 보관함, 원고, 도구 모음과 페이지 블록

최근 추가된 기능: Codex·Claude·Grok 채팅, CLI 첫 사용 시 다운로드, 복제 도장·치유 브러시, 패널 크기 조절, 공유 색상 팔레트. 아래 화면은 실제 앱 컴포넌트를 QA 캡처 도구로 촬영한 예시입니다. 촬영 범위

성인용 만화에서 Gemma 4 사용이 어렵다면: OpenCode Go + DeepSeek V4.1 Flash Free

PC 사양이나 실행 환경 때문에 Gemma 4 로컬 번역이 여의치 않다면, OpenCode Go의 DeepSeek V4.1 Flash Free를 대안으로 강력 추천합니다. 특히 수위 높은 성인용 만화에서 대안을 찾는 경우 우선 추천하는 모델입니다.

OpenCode GO 빠른 설정은 v3.2.0부터 사용할 수 있습니다. 이전 설치본을 사용 중이라면 위 다운로드 링크에서 업데이트하세요.

가입 → API 키 발급 → 당근망가번역기 연결 방법 펼치기

1. OpenCode Go 가입과 API 키 발급

  1. OpenCode Go 가입 페이지를 열고 로그인합니다. 계정이 없다면 화면 안내에 따라 계정을 만듭니다.
  2. 사용할 워크스페이스를 선택하고 Go — $10/month 요금제를 구독합니다. 결제 화면에서 월 결제 금액을 확인하세요. Go Plus는 상위 요금제이며, 처음 연결하는 데 필수는 아닙니다.
  3. 구독한 워크스페이스의 콘솔에서 API Keys 항목을 엽니다. 키 생성 기능으로 새 API 키를 만들고, 이름을 입력하는 경우 CarrotMangaTranslator처럼 용도를 알아볼 수 있게 적습니다.
  4. 발급된 API 키 전체를 복사합니다. 아래 당근망가번역기의 API 키 칸에 붙여 넣을 값입니다. OpenCode Go를 구독한 워크스페이스의 키를 사용하세요. 키가 포함된 화면이나 문자열을 이슈·채팅에 공개하지 마세요.

공식 가입 흐름은 콘솔 로그인 → Go 구독 → API 키 복사입니다. 화면 구성이나 버튼 이름은 변경될 수 있습니다. OpenCode Go 공식 안내

2. 당근망가번역기에 연결

  1. 설정 열기 (Ctrl+,) → 번역으로 이동하고 번역 엔진을 API로 선택합니다.
  2. API 제공자 빠른 설정 → OpenCode GO를 선택합니다.
  3. API 키 칸에 앞에서 복사한 키를 붙여 넣습니다. 모델 ID가 **deepseek-v4.1-flash**인지 확인합니다.
  4. 연결 시험을 실행한 뒤 설정을 저장하고, 먼저 한 페이지를 번역해 말풍선별 대사와 결과를 확인합니다.

빠른 설정이 아래 값을 자동으로 채웁니다. 고급 설정을 직접 바꿨거나 환경 백업을 복원했다면 함께 확인하세요.

항목 설정값
Base URL https://opencode.ai/zen/go/v1
모델 ID deepseek-v4.1-flash
대화별 세션 헤더 켜짐
세션 헤더 이름 x-opencode-session
추가 요청 JSON {"response_format":{"type":"json_object"}}

추가 요청 JSON의 json_object 설정은 유지하세요. 이 모델에 JSON Schema 형식을 요구하면 HTTP 400이 발생한 사례가 있어 빠른 설정에 JSON 모드를 넣었습니다. 인증 오류가 나면 키와 구독 워크스페이스를, 사용량 제한이면 콘솔의 남은 한도를 확인하세요. Go의 모델 목록은 앱에서 자동 조회하지 않으므로 모델 ID를 직접 확인합니다.

이 연결은 당근망가번역기가 API를 직접 호출합니다. OpenCode 프로그램을 별도로 설치하거나 실행할 필요는 없습니다. 번역할 페이지 이미지와 OCR·참고 문맥은 외부 API로 전송되며, OCR·원문 제거 엔진은 별도로 설정합니다.

OpenCode Go의 공식 이용 범위는 코딩 에이전트 요청을 중심으로 안내돼 있습니다. 앱에서 연결·번역에 성공한 것과 서비스가 만화 번역 용도를 공식 승인한 것은 별개이므로, 결제 전 공식 이용 범위를 확인하세요. 앱에서는 50작품·50페이지의 연결과 블록 대응을 검증했으며, 이는 모든 작품의 번역 품질이나 무검열을 보장하는 검사는 아닙니다. 실제 검증 범위

작업 설명
설치·설정 시작하기 · 설치 · 번역 엔진 · OCR·이미지·하드웨어
원고·번역 가져오기·보관함 · 페이지 작업 · 채팅으로 번역 · 영역 번역
편집 작업 화면 · 텍스트·배치·서식 · 폰트·프리셋·블록 재사용
이미지 원문 제거·수동 보정 · 효과음 · 전송 이미지 가리기
일관성·검수 용어·인물·기억 · 조건부 일괄 편집 · 모아보기·검수표
저장·연결 이미지·PSD 출력 · 자동 저장 · 작업 공유 · 환경 백업 · MCP
도움말 단축키 · 문제 해결 · 개발·라이선스

시작하기

  1. 앱을 설치하고 설정 → 번역에서 원문·번역 언어와 엔진을 선택합니다.
  2. OCR, 이미지 · 원문 제거에서 모델을 정한 뒤 확인 · 업데이트 → OCR/모델 확인을 실행합니다.
  3. 새 원본 추가로 원고를 가져오고 화를 엽니다.
  4. 번역 설정… (T)에서 한 페이지와 실행할 작업을 선택합니다.
  5. 원문·번역문을 교정하고 원문 제거·배치·서식을 확인합니다.
  6. 결과물 출력 (Ctrl+E)으로 저장합니다. 결과가 맞으면 나머지 페이지를 처리합니다.

설치

환경 설치 방법
Windows 10/11 릴리스의 Setup EXE 실행 → 데이터 폴더 선택
Apple Silicon Mac arm64 DMG 또는 ZIP 다운로드 → 응용 프로그램으로 이동. macOS 14 이상, Intel Mac 미지원

실행 경고가 나오면 해당 릴리스의 서명 상태와 체크섬을 확인하세요. macOS 첫 실행 승인은 시스템 설정 → 개인정보 보호 및 보안에서 할 수 있습니다. 서명 정책

Codex·Claude·Grok 실행 파일은 새 설치 패키지에 포함하지 않습니다. 처음 연결할 때 필요한 실행 파일만 공식 배포처에서 내려받고 검증한 뒤 로그인을 이어갑니다. 내려받은 파일은 데이터 폴더의 cli-runtimes에 보관하여 재사용합니다. 기존 앱에 남아 있는 호환 Codex·Claude 실행 파일도 우선 사용합니다. 구버전 업데이트 과정에서 기존 내장 파일이 제거되면 첫 연결 시 한 번 다시 내려받지만 계정 정보는 별도 위치에 유지됩니다.

앱 채팅에서 Grok을 선택할 수 있습니다. 설정 → AI 앱 연결(MCP) → 앱 채팅 · Grok 계정에서 공식 Grok 로그인을 연결하세요. 이미지 첨부와 기존 당근 MCP 도구를 통한 보관함 조회·번역·편집 요청을 지원합니다. Grok 연결 및 검증 기록

모델·런타임은 별도로 내려받습니다. 첫 준비에는 인터넷과 여유 저장 공간이 필요합니다. 로컬 Gemma·OCR·인페인팅은 준비 후 PC에서 실행되며, Codex·Claude·외부 API·인터넷 조사는 네트워크 연결이 필요합니다.

번역 엔진과 언어

설정 열기 (Ctrl+,)의 왼쪽 목록에서 번역을 선택합니다. 앱 표시 언어는 일반, 원고와 번역의 언어는 번역에서 지정합니다.

원문 언어의 초기값은 자동, 번역 언어는 한국어입니다. 여러 언어가 섞인 원고도 자동으로 요청할 수 있고, 원문 언어가 명확하면 직접 선택할 수 있습니다. 기존에 저장한 언어 선택은 유지합니다.

번역 엔진·언어와 Codex 로그인·모델 설정

엔진 준비·선택 항목
Gemma 로컬 Hugging Face 또는 로컬 모델 파일, 모델 계열·프리셋, 장치에 맞는 런타임. RAM/VRAM이 부족하면 작은 프리셋부터 사용
Codex 앱 안에서 ChatGPT 로그인 → 사용 가능한 모델·추론 강도 선택. 첫 연결 시 공식 실행 파일 자동 설치, 이후 재사용
Claude Code 앱 안에서 Claude 구독 또는 Console 계정으로 로그인 → 계정에서 제공하는 모델·추론 강도 선택. 첫 연결 시 공식 실행 파일 자동 설치, 이후 재사용
API 제공자 빠른 설정 또는 Base URL·모델 ID·인증 정보 직접 입력. OpenAI 호환 로컬 서버도 연결 가능
  • Gemma 메모리: 프리셋의 메모리 표기는 선택 기준입니다. 문맥 길이·이미지·다른 프로그램 사용량도 영향을 줍니다. 여유 VRAM과 이미지 처리 위치를 조정할 수 있습니다.
  • Gemma 생성 설정: Temperature·Top P·Top K를 앱에서 조절합니다. 먼저 기본값으로 한 페이지를 확인하고, 결과의 다양성이나 일관성을 조절할 때 사용하세요. 기본값 복원도 지원합니다.
  • API 연결: 모델 목록과 이미지 입력 지원을 확인합니다. 여러 키, 호출 간격·재시도는 제공자의 제한에 맞춥니다. 제공자별 인증 방식은 해당 설정을 사용합니다.
  • API 고급값: Temperature·top_p·top_k·reasoning_effort·추가 JSON·사용자 헤더는 연결한 서버가 지원하는 값만 입력합니다.
  • 생성 한도: 최대 출력 토큰은 응답 길이, 문맥 한도·작품 정보 예산은 참고할 정보량에 관계됩니다. 설정의 권장값을 기준으로 조정합니다.
Gemma·API 설정 화면

Gemma 모델 소스·프리셋·런타임·메모리 설정

Gemma 번역 생성 설정의 Temperature·Top P·Top K

API 연결 주소·인증·모델·재시도 설정

OCR·이미지·하드웨어 설정

번역 엔진과 아래 항목은 각각 설정합니다. 번역 엔진을 바꿔도 OCR·원문 제거·이미지 생성·인터넷 조사 엔진이 함께 바뀌지는 않습니다.

설정 주요 항목
OCR HayaiOCR / HunyuanOCR 1.5 / PaddleOCR(레거시), 실행 장치. Hunyuan은 F16 기본·Q4 선택 가능
이미지 · 원문 제거 AOT / LaMa / Flux와 지원 백엔드, 별도의 Codex 이미지 모델·추론 강도, 전송 이미지 가리기
인터넷 조사 Tavily 키·사용량, 검색 결과 분석 모델. Codex 조사는 Codex 계정 사용
하드웨어 앱 그래픽 GPU와 로컬 AI 연산 GPU, 장치별 권장값. 그래픽 GPU 변경은 저장 후 재시작 필요
확인 · 업데이트 현재 버전·릴리스 페이지, OCR·모델 다운로드 및 실행 상태 확인
일반 앱 언어·휠 줌 민감도·환경 백업 및 이관
OCR·이미지·인터넷 조사·하드웨어·업데이트 화면

OCR 엔진과 장치

원문 제거 모델·이미지 생성·전송 가리기

인터넷 조사 키·분석 모델

그래픽 GPU와 AI 연산 GPU

앱 버전과 OCR·모델 확인

원고 가져오기와 보관함

보관함은 작품 → 화 → 페이지 → 블록 구조입니다. 작품에는 공통 용어·인물 정보가, 페이지에는 원본·번역 블록·보정 결과가 저장됩니다. 블록은 대사·나레이션·효과음처럼 따로 편집하는 영역입니다.

새 원본 추가의 입력 방식

입력 방법
PNG·JPEG·WebP 이미지 또는 이미지 폴더 선택. 파일·폴더 드래그도 지원
ZIP·CBZ·RAR·CBR 압축파일 안의 이미지 확인 후 추가
PDF 페이지를 이미지로 가져오기
여러 화가 든 폴더·압축파일 여러 화 추가에서 생성할 화·제목·순서 확인
웹 페이지 링크로 열기 → 이미지 불러오기 → 크기 필터·선택으로 대상 지정
.mgtshare 작업 가져오기로 편집 데이터를 포함한 작업 복원

가져오기 미리보기에서 새 작품 / 기존 작품과 포함할 항목을 정합니다. 결과물 자동 저장도 이때 켤 수 있습니다. 손상·미지원 파일의 제외 여부를 확인하고, 웹 로그인·접근 제한으로 읽지 못하는 원고는 직접 준비한 파일을 사용하세요.

보관함에서는 작품·화 검색, 이름 변경, 정렬·순서 이동을 합니다. 페이지 목록의 상태 필터, 소요 시간, 각 페이지의 더 보기로 처리 상태와 관리 명령을 확인합니다.

여러 폴더를 한 번에 가져오고, 화 전체 선택·해제와 같은 제목의 기존 화 건너뛰기를 사용할 수 있습니다. 가져오기만 마치거나 이어서 번역 설정을 여는 동작도 선택합니다. 작품별 접기 상태와 자주 쓰는 가져오기 옵션은 다음 작업에도 유지됩니다.

여러 화 가져오기·웹 링크 화면

여러 화의 제목·포함 여부·자동 저장 설정

웹 페이지 링크로 원고 가져오기

번역과 페이지 작업

화를 열고 번역 설정… (T)에서 대상 페이지와 실행 단계를 고릅니다. HayaiOCR은 기존 버전 / 새 버전을 전환할 수 있으며 마지막 선택을 기억합니다.

단계별 페이지 작업

HayaiOCR 페이지 선택·작업 프리셋·실행 순서

프리셋 실행 단계
전체 처리 검출 → OCR → 번역 → 자동 서식 → 원문 제거 → 배치 → 검수
손번역 준비 검출 → OCR → 원문 제거
원문 제거만 검출 → 원문 제거
번역만 저장된 원문으로 번역 → 검수
식자 마무리 자동 서식 → 원문 제거 → 배치 → 검수
  • 기존 결과 보존: 기본적으로 빈 항목만 처리합니다. 다시 처리할 내용은 각 단계의 세부 옵션에서 지정합니다.
  • OCR 교정 후 번역: 손번역 준비 → 원문 수정 → 번역만 순서로 실행합니다.
  • 자동 서식: 글자 크기 맞춤과 폰트 자동 맞춤은 별도 옵션입니다. 폰트 자동 맞춤은 원문 분위기에 맞는 한글 폰트를 적용합니다.
  • 일괄 규칙: 원문·번역문·최종 서식 단계에 저장한 일괄 편집 규칙을 넣습니다.
  • 프리셋 관리: 별표로 즐겨찾기, 변경 저장으로 갱신, 새로 저장으로 복사, 휴지통으로 삭제합니다.
  • 이어하기: 중단된 작업은 상단의 이어하기에서 선택합니다. 실패 페이지와 완료 단계를 확인한 뒤 남은 작업을 실행합니다.

기존 번역 실행 화면

HayaiOCR의 기존 버전과 PaddleOCR에서는 화·페이지를 선택하고 아래 옵션을 조합합니다. 미번역만으로 대상을 좁히고, 다음 번역의 기본값으로 저장으로 재사용합니다.

옵션 동작
빠른 1회 페이지 번역과 간단한 최근 문맥 사용
누적 컨텍스트 용어·인물·장면 정보를 다음 페이지에 활용. 상세 기록 / 균형 기록 / 필수 용어만 선택
자동 생성 / 기존 블록 유지 영역을 새로 찾거나, 기존 영역·서식을 유지하고 텍스트 재작성. 블록이 없으면 자동 생성
자연스러운 줄 나눔 영역 크기를 고려한 줄바꿈을 번역문에 반영
글자 크기 AI 맞춤 / 폰트 자동 맞춤 원문 크기 추정 / 원문에 어울리는 한글 폰트 선택
번역만 / 원문 지우기 번역에서 종료하거나 배경 복원까지 실행
말풍선 맞춤 / Codex가 지우기 제거 후 말풍선 내부에 배치 / 지원 조건에서 Codex 이미지로 제거
기존 번역 실행·작업 센터 화면

기존 번역 실행의 문맥·블록·완료 처리 옵션

원고 오른쪽 아래에서 여는 작업 센터

Shift+T는 남은 페이지를 이어서 번역합니다. 오른쪽 아래 작업 센터에서 진행 상황·실패 사유를 확인합니다. 처리 중인 페이지는 편집이 제한되지만 잠기지 않은 다른 페이지는 편집할 수 있습니다.

페이지 목록의 소요 시간에서 기존 번역과 새 버전 페이지 작업의 실행 이력·단계별 시간을 함께 확인합니다. 재개한 작업은 별도 실행으로 표시하며, 실패·취소·중단·건너뛴 단계와 시간을 측정하지 않은 단계를 구분합니다.

실행 이력과 단계별 소요 시간

재번역은 수동 수정과 기존 결과를 바꿀 수 있고, 일반 실행 취소로 전체 복구할 수 없습니다. 보존할 편집본은 먼저 작업 내보내기로 저장하세요.

영역 번역

왼쪽 영역 번역 도구로 필요한 부분만 지정합니다. 미리보기에서 텍스트 / 효과음 이미지, 원문 지우기, 사용할 엔진을 고르고 실행합니다. 페이지 전체를 다시 처리하지 않고 누락된 대사·효과음을 보완할 때 사용합니다.

지정 영역의 출력 방식·원문 지우기·엔진 선택

채팅으로 번역

일반 번역 옆의 채팅으로 번역을 누르거나, 오른쪽 패널의 채팅 탭을 엽니다. 화를 열지 않았을 때는 보관함 도구 모음의 채팅 아이콘으로 시작할 수 있습니다. Ctrl+K 명령 검색에서도 채팅을 열 수 있습니다.

대화 기록·도구 결과·현재 페이지·모델 선택을 표시하는 실제 채팅 패널의 QA 예시

  1. 입력창 아래 모델 선택 칩에서 Codex 또는 Claude, 모델, 추론 강도를 선택합니다. Codex는 ChatGPT 계정, Claude는 Claude 구독 또는 Console 계정으로 로그인합니다. 채팅의 모델 선택은 일반 번역 설정과 별도로 관리됩니다. 다른 AI로 전환하면 해당 AI의 새 대화를 시작합니다.
  2. 작품·화·페이지를 열고 아래처럼 요청합니다. 전송할 때 화면의 작품·화·페이지·선택 블록을 함께 전달하며, 첨부 버튼으로 참고 이미지를 추가할 수 있습니다.
  3. 결과를 앱에서 확인하고 같은 대화에서 수정·검수·출력을 이어서 요청합니다. 도구 작업을 펼쳐 세부 결과를 보고, 이미지 미리보기를 눌러 확인할 수 있습니다.

이 화를 한국어로 번역해줘. 앞 화의 용어와 말투를 유지하고, 효과음은 원문을 보존해줘. 글씨가 넘치는 곳을 확인한 뒤 PNG로 출력해줘.

  • 대화 이어가기: 위쪽 목록에서 이전 대화를 선택하고, +로 새 대화를 만듭니다. 작품을 이동하거나 앱을 다시 열어도 저장된 대화를 이어갈 수 있습니다. 압축 버튼은 모델이 참고하는 대화 문맥을 정리하며 화면의 기존 기록은 유지합니다.
  • 진행 제어: 실행 중에도 추가 지시를 보내거나 중지할 수 있습니다. 패널을 닫아도 작업은 계속되고, 앱을 종료하면 진행 중 대화는 일시 중지 상태로 남습니다. 화면 이동만으로 진행 중인 작업 대상이 바뀌지는 않습니다.
  • 연결 준비: 앱 안의 채팅은 Tailscale이나 외부 MCP 연결 설정 없이 사용할 수 있습니다. 모델 계정의 네트워크 연결은 필요하며, OCR·원문 제거처럼 앱의 엔진을 실행하는 작업은 해당 모델 준비가 필요합니다.
  • 검수 상태: 답변이 끝난 것과 정밀 검수가 완료된 것은 다릅니다. 확인하지 않은 페이지, 오래된 검수, 폰트 대체, 사용자 보정 대기 항목을 확인하세요. 되돌리기도 현재 저장 상태와 복구 가능 여부를 확인하는 작업입니다.
  • MCP와 같은 작업 기준: 앱 채팅과 외부 MCP가 번역·이미지 도구 선택·검수 지침을 공유합니다. 원문을 지울 영역과 한국어 배치를 구분하고, 확대 원본·실제 폰트 견본·제거된 배경·최종 식자를 확인하도록 안내합니다. 도구 오류는 펼친 작업 목록에서 확인할 수 있습니다.
  • 원문 제거와 사용량: 사용자가 엔진을 지정하면 그 선택이 우선합니다. 미지정 시 단순 배경은 단색 칠하기/AOT, 일반 제거는 FLUX, 복잡한 배경·그림형 글자는 앱 이미지 생성을 검토합니다. ChatGPT 구독과 현재 Codex 사용량을 확인해 Pro에는 더 여유를 주고 Plus 등에는 보수적으로 사용합니다. 이 조회는 이미지 생성 잔여 횟수를 뜻하지 않으며, 조회 불가나 낮은 잔여량을 무제한으로 취급하지 않습니다.

작업 화면

위치 기능
왼쪽 패널 보관함·화 선택, 페이지 목록·상태·순서
원고 왼쪽 도구 모음 선택·블록 추가·손바닥, 영역 번역·말풍선 영역·마스크·칠하기·복원
원고 오른쪽 위 실행 취소·원본 비교·표시 전환, 텍스트 모아보기·용어/기억
원고 오른쪽 아래 확대·보기 맞춤, 원본 불투명도, 작업 센터
오른쪽 패널 페이지 작업·블록 목록, 선택 블록의 서식 / 배치
조작 방법
페이지 이동 왼쪽 썸네일, PageUp / PageDown
원고 이동·확대 손바닥 H 또는 3로 드래그, Ctrl+휠. 보기 조절에서 화면·너비·높이 맞춤·실제 크기 선택
원본·번역 비교 O 원본, V 번역문, Shift+B 편집 배경·테두리 표시 전환
블록 생성·선택 W 또는 2로 영역 생성, S 또는 1로 선택·이동·크기 조절
다중 선택 여러 블록 선택 또는 Ctrl+A로 현재 페이지 전체 선택
읽기 순서 블록 목록의 위·아래 버튼, Ctrl+Alt+↑/↓, 좌표순 정렬

양쪽 패널과 도구 모음을 접어 원고 공간을 확보할 수 있습니다. 좁은 창에서 접힌 패널은 펼치기 버튼으로 엽니다. 아이콘 이름은 마우스를 올려 확인하고, 기능 위치가 기억나지 않으면 Ctrl+K로 검색합니다. 선택 테두리는 출력에 포함되지 않습니다.

왼쪽 패널의 오른쪽 경계를 드래그하면 너비가 바뀌고, 보관함과 페이지 목록 사이의 경계를 드래그하면 두 영역의 높이가 바뀝니다. 경계에 포커스를 둔 상태에서 방향키로도 조절할 수 있습니다. 바꾼 크기는 기억하며, 경계 더블클릭으로 기본 크기로 되돌립니다. 너비를 바꾼 뒤 경계에 마우스를 올리면 초기화 버튼도 나타납니다.

사이드바 너비·분할 높이를 조절한 화면

사이드바 너비와 보관함·페이지 목록 높이 조절

대사와 식자 편집

텍스트와 부분 서식

블록을 선택하고 서식 탭 상단에서 번역문·OCR 원문을 수정합니다. 이름·숫자·부호가 잘못 번역됐다면 OCR 원문부터 확인합니다. 역할·화자·검수 상태·메모는 일괄 편집과 검수 조건에도 사용됩니다.

선택 블록의 원문·번역문과 부분 서식 도구

번역문 일부를 선택하면 해당 글자에만 폰트·크기·굵기·기울임·밑줄·취소선·강조점·색·투명도·배경·행간·자간·장평·외곽선·광선·그림자를 적용합니다. 입력 커서만 있으면 이후 입력할 문자, 블록만 선택하면 전체 문자에 적용합니다. 출력 줄 선택으로 실제 말풍선의 줄을 선택해 앞줄과의 간격을 조절할 수 있습니다. 코드에서 서식 표현을 직접 수정하고, 서식 전체 초기화로 부분 서식을 제거할 수 있습니다.

배치와 변형

위치·크기·회전과 원근·곡선·워프 탭

조정 사용법
위치·크기·회전 수치 입력 또는 캔버스 조절점 드래그. 비율 유지 선택, 회전 초기화 Ctrl+Shift+T
가로·세로 / 정렬 / 줄바꿈 서식에서 글 방향과 흐름 조정. 직접 입력한 줄바꿈과 자동 줄바꿈을 구분
말풍선 맞춤 말풍선 내부에 번역문 배치. 말풍선 영역 도구의 다각형·브러시로 늘리거나 깎기. 해제 시 원래 OCR 영역으로 복귀
원근·곡선·워프 배치 탭의 변형 선택 후 조절점으로 기울기·휘어짐·형태 수정. 초기화로 원래 형태 복원
원근·곡선·워프 편집 화면

원근 변형 조절

곡선 변형 조절

워프 변형 조절

블록 서식과 일괄 적용

서식 탭에서 문자 속성과 블록 전체 설정을 함께 조정합니다. 문자 속성은 현재 선택 범위를 따릅니다. 정렬·쓰기 방향·줄바꿈·자동 맞춤은 블록 전체에 적용하며, 말풍선 여백과 자동 지우기에서 제외는 여러 블록을 선택해 함께 바꿀 수 있습니다.

블록 전체의 서식과 간격·색상 설정

일괄 적용에서는 복사할 서식 항목과 선택 블록 / 이 페이지 / 이 화 전체를 고릅니다. 예를 들어 색상만 통일하려면 글자 크기·방향 등은 해제합니다.

서식 항목·적용 범위 선택

서식 일괄 적용의 항목과 범위

폰트·서식·블록 재사용

기본 서식과 프리셋

설정 → 기본 서식은 새 블록에 적용할 기본값입니다. 기존 블록을 바꾸려면 블록 서식의 일괄 적용을 사용합니다.

현재 서식을 프리셋으로 저장할 때 이름과 포함할 항목을 고릅니다. 프리셋 관리에서 이름·그룹·순서, 복제·삭제·덮어쓰기, 빠른 서식에 표시와 키보드 슬롯 Alt+1~Alt+0을 설정합니다. 자동 폰트 맞춤은 번역 단계의 기능이며 프리셋 저장과 별개입니다.

프리셋 목록·포함 항목·키보드 슬롯

새 블록의 기본 서식 설정

기본 글꼴·크기·방향·효과와 미리보기

폰트 관리

폰트 선택 옆 관리 버튼에서 TTF/OTF 등록, 검색·견본 확인, 즐겨찾기·숨기기·순서·기본 폰트를 설정합니다. 다른 PC에서 폰트가 누락되면 같은 폰트를 등록하거나 대체합니다.

폰트 등록·견본·즐겨찾기·표시 순서

블록 라이브러리와 복사

블록의 더 보기 → 라이브러리에 저장으로 텍스트와 서식을 보관합니다. 라이브러리에서 이름·원문·번역문으로 검색하고 내용 편집·삭제·현재 페이지 삽입을 할 수 있습니다.

저장된 블록을 검색하고 재사용하는 라이브러리

생성한 효과음도 이미지·마스크·굵기 정보를 함께 저장해 재사용할 수 있습니다. 선택한 텍스트·이미지 블록은 Ctrl+C / Ctrl+V로 페이지·화·작품 사이에 복사합니다.

원문 제거와 수동 보정

자동 지우기 → 남은 자국 보정 → 원본 비교 순서로 처리합니다. 자동 지우기는 블록의 원문 영역을 기준으로 배경을 복원합니다. 남길 글자는 블록의 더 보기에서 자동 지우기에서 제외합니다.

브러시 보정과 크기·색 설정

도구 동작
자동 지우기 I 대상 페이지를 골라 설정한 인페인팅 모델로 제거. 후속 말풍선 맞춤 선택 가능
마스크 J 제거할 영역을 직접 칠한 뒤 적용해 배경 복원
브러시 B 선택한 색으로 작은 자국·평평한 배경 보정
사각형 R / 원형 E 드래그한 도형을 선택 색으로 채우기
복제 도장 지정한 위치의 픽셀을 복사해 망점·선화·배경을 보정
치유 브러시 지정한 위치의 질감을 주변 밝기·색에 맞춰 연결
지우개 X / 사각 지우개 보정한 부분을 원본 픽셀로 복원
색상 / 색 추출 P 스포이드·HEX·RGB·팔레트로 고르거나, P를 누른 뒤 원고를 클릭해 색 추출

브러시·사각형·원형에서 Alt+좌클릭으로 색을 추출합니다. Alt+우클릭 드래그는 반경 조절, Shift 드래그는 직선 그리기입니다. 마스크는 도구 상태에 따라 Space로 적용합니다. 잘못 칠하면 실행 취소하고, 원본으로 되돌릴 부분은 복원 지우개를 사용합니다.

복제 도장과 치유 브러시

브러시 아이콘의 메뉴에서 브러시 → 사각형 → 원형 → 복제 도장 → 치유 브러시를 선택합니다. 망점과 선을 그대로 옮길 때는 복제 도장, 주변 밝기 차이를 부드럽게 연결할 때는 치유 브러시를 사용합니다.

브러시 메뉴의 복제 도장과 원본·경도·불투명도 설정

  1. 현재 결과 또는 페이지 원본을 복사 대상으로 고릅니다. 현재 결과에는 이미지 보정이 포함되며 번역 글자·편집 테두리는 포함되지 않습니다.
  2. Alt/Option+클릭으로 복사할 위치를 지정하거나 원본 지정 버튼을 누른 뒤 원고를 클릭합니다. 아직 원본 위치가 없으면 첫 클릭은 위치 지정으로 처리하고 그림을 바꾸지 않습니다.
  3. 보정할 곳을 드래그합니다. 정렬을 켜면 여러 획에서도 원본과 대상 사이 거리를 유지하고, 끄면 매 획이 지정한 원본 위치에서 다시 시작합니다.
  4. 크기·경도·불투명도를 조절합니다. [·] 또는 Alt+우클릭 드래그로 크기를 바꾸고, Shift로 직선을 그립니다. 복제 경도는 100%, 치유 경도는 50%에서 시작합니다.
  5. 치유는 드래그 중 복제 미리보기를 보여준 뒤 계산 결과로 바뀝니다. Esc로 진행 중인 획·계산을 취소하고, 확정한 획은 실행 취소로 되돌립니다.

크기·경도·불투명도는 기억하지만 복사 위치는 페이지 이동 후 다시 지정합니다. 원본과 대상이 겹쳐도 같은 획에서 방금 그린 픽셀을 다시 복사하지 않습니다. 아주 큰 획이 계산 메모리 한도를 넘으면 부분 적용하지 않고 안내하므로 나눠서 작업하세요. 큰 페이지에서는 획 확정과 저장에 시간이 걸릴 수 있습니다. 새 도구의 전용 단축키는 설정 → 단축키에서 지정할 수 있습니다.

좁은 창의 치유 브러시

좁은 창에서도 보이는 치유 브러시 설정

색상 선택과 공유 팔레트

색상 칸을 누르면 앱 안에서 채도·명도·색조를 조절하거나 HEX·RGB 값을 입력합니다. **+**로 현재 색을 팔레트에 추가하고, 저장한 색을 클릭해 적용합니다. 팔레트는 최대 24색이며 글자·외곽선·그림자·브러시 등 여러 색상 입력에서 공유하고 재실행 후에도 유지합니다. 색을 우클릭하거나 포커스 후 Delete·Backspace를 누르면 삭제합니다.

앱 내부 색상 선택기와 공유 팔레트

자동 지우기 대상과 후속 말풍선 맞춤

원문 제거 페이지 선택

효과음 번역

원고 왼쪽 아래 SFX → 효과음 번역 실행에서 HayaiOCR의 후보를 검토합니다. 놓친 효과음은 영역을 직접 추가하고, 그림을 잘못 잡은 후보는 제외합니다.

페이지별 효과음 후보와 번역·제거 옵션

  1. 페이지별 후보의 영역·원문·포함 여부를 확인합니다.
  2. 텍스트 또는 효과음 이미지를 선택합니다. 이미지 방식은 별도로 설정한 Codex 이미지 모델을 사용합니다.
  3. 번역 문구를 검토·수정한 뒤 이미지를 생성합니다.
  4. 텍스트는 일반 블록으로, 생성 이미지는 위치·크기·이미지 편집 도구로 다듬습니다.
  5. 원본과 비교하고 완성 이미지 또는 PSD로 출력합니다.

개별 효과음 번역은 원문을 유지합니다. 원문 제거까지 하려면 전체 효과음 번역의 원문 지우기 옵션을 선택합니다. 초기화는 제외한 후보를 다시 표시하며 영역 수정과 번역 결과는 유지합니다.

이미지 작업 재개 시 가리기 영역과 겹치는 페이지는 번역문을 저장하고 이미지 작업을 보류합니다. 다른 페이지는 계속 처리합니다. 가리기를 조정한 뒤 미완료 이미지 작업을 이어서 실행하세요.

원본과 한국어 식자·이미지 효과음 비교
일본어 원본 한국어 대사·이미지 효과음
일본어 예제 원고 한국어 대사와 쾅 효과음

공개 예제 원고·배경에 실제 식자 렌더러를 적용한 비교입니다. 자동 번역·이미지 생성의 성능 측정 결과는 아닙니다. 예제 제작 과정

전송 이미지 가리기

설정 → 이미지 · 원문 제거 → 전송 이미지 가리기를 켜고, 페이지·화·작품 범위의 가리기 준비 명령으로 편집 화면을 엽니다. 지원되는 AI 이미지 전송 흐름의 전송 사본에 가리기를 적용하며 원본 파일은 유지합니다.

가리기 영역 편집과 페이지별 검토 상태

  • 영역 편집: 사각형·브러시로 가릴 부분을 지정하고 지우개로 조정합니다. 선택·이동·확대·실행 취소를 지원합니다.
  • 여러 페이지: 전체·미확인 등으로 필터링하고 페이지별 또는 선택한 페이지를 확인 처리합니다. 반복 영역은 복사·프리셋으로 재사용합니다.
  • 저장·재개: 초안과 검토 상태를 저장한 뒤 닫습니다. 중단된 번역·이미지 작업은 별도로 재개합니다.
  • 확인할 범위: 번역할 글자·효과음과 겹치지 않게 조정합니다. 가리기는 OCR 텍스트·작품 문맥까지 제거하지 않습니다.

외부 번역·조사·이미지 엔진과 MCP는 요청에 필요한 이미지·텍스트·문맥을 해당 서비스로 보낼 수 있습니다. 개인정보 안내

용어·인물·번역 규칙·기억

오른쪽 도구 모음의 용어/기억에서 작품의 공통 표기와 문맥을 관리합니다. 직접 입력하거나 AI 분석·누적 번역 결과를 확인한 뒤 저장합니다.

용어의 원문·번역·분류·별칭·사용 여부

탭 관리 내용
용어집 원문·번역 표기, 별칭·분류·메모·활성 여부. 예: 侍従長 → 시종장
캐릭터 표시 이름·원문 이름·번역 이름, 말투·사용자 지정 화법·인물 메모
번역 규칙 호칭 유지 여부, 효과음 처리, 기본 번역 톤
스토리 메모리 페이지별 이미지 장면 요약과 기존 텍스트 기억

검색·정렬·활성 필터로 중복 이름과 별칭을 정리합니다. 화자 조건을 쓰려면 블록과 인물이 올바르게 연결되어 있어야 합니다.

캐릭터·번역 규칙·스토리 메모리 화면

인물 이름과 말투

호칭·효과음·기본 톤 규칙

페이지 장면 요약과 스토리 기억

인터넷 조사는 검색용 작품 제목과 조사 엔진을 정해 외부 정보를 보충합니다. 검색 제목은 보관함 제목과 별개입니다. Codex 조사와 Tavily 검색·LLM 분석은 각각 계정·키·한도를 준비합니다. 제안은 출처·현재 내용과 비교한 뒤 필요한 항목만 적용합니다.

하단의 문맥 예산을 보며 번역에 필요한 정보를 유지합니다. 저장 충돌이 나면 최신 내용을 다시 엽니다. 용어·기억 전체 초기화는 작품의 용어집·캐릭터·모든 화의 스토리 메모리를 삭제합니다.

텍스트·서식 일괄 편집

Ctrl+H에서 범위 → 조건 → 작업 → 미리보기 → 적용 순서로 설정합니다. 선택 블록·페이지·화 중 범위를 고릅니다.

화자 조건·치환 작업과 변경 전후 미리보기

항목 기능
대상 조건 원문·번역문·역할·화자·검수 상태 등. 모두 맞을 때 / 하나라도 맞을 때 / 모든 말풍선
작업 문자 치환, 필드·서식 변경, 일부 글자 강조. 여러 작업은 순서대로 실행
검색 대소문자·전체 치환·정규식 사용 여부 선택
미리보기 실제 페이지의 변경 전후·개수 확인. 바꾸지 않을 항목 개별 제외
규칙 저장 이름과 함께 YAML로 저장·재사용. 여러 규칙을 순서대로 실행하는 시퀀스 구성
충돌·취소 미리보기 이후 바뀐 블록은 건너뜀. 최신 상태로 다시 확인. 적용 직후 실행 취소 지원

예를 들어 화자 = 세라피나인 대사의 처형했습니다만 처형하였습니다로 치환하고, 바뀐 구절에 굵게를 적용할 수 있습니다. 효과음 역할의 외곽선 통일, 말줄임표·공백 정리, 검수 상태·메모 지정에도 사용합니다. 앞 작업의 결과가 다음 작업의 입력이 됩니다.

대사 모아보기와 검수표

G로 텍스트 모아보기를 엽니다. 이 페이지 / 전체 화, 번역문+OCR / 번역문만 / OCR만을 선택하고 검색합니다. 페이지 제목을 눌러 원고로 이동하거나 블록을 골라 서식을 바꿀 수 있습니다.

원문과 번역문 모아보기·검색·파일 교환

방식 반영 기준
복사 / TXT 저장 현재 표시한 텍스트. 페이지 머리말 포함 여부 선택
TXT 불러오기 번역문만으로 저장한 텍스트의 줄 순서. 순서·개수와 적용 경고 확인
CSV / TSV 검수표 block_id로 대응. 번역문·검수 상태·메모를 반영하며 OCR 원문은 유지

외부 스프레드시트로 검수할 때는 ID 열을 보존합니다. 다시 가져오기 전 알 수 없는 ID·중복·누락 경고를 확인하세요.

완성 이미지와 PSD 출력

결과물 출력 (Ctrl+E)에서 화·페이지·형식·저장 위치를 선택합니다. 출력 전 확인의 미번역·실패·후처리 누락을 검수한 뒤 실행합니다.

출력 범위·형식·저장 위치와 사전 확인

형식·옵션 결과
원본 형식 / PNG / JPEG / WebP 완성 이미지 합성. JPEG·WebP 품질, 원본 파일명·하위 폴더 유지 설정
글자 없이 출력 번역문 없이 정리된 배경 저장. 원문 제거 결과 필요
PSD 출력 원본·정리 배경·블록별 레이어. 지원 대사는 편집 가능한 텍스트, 복잡한 세로·곡선·원근·부분 서식 등은 래스터 레이어로 보존 가능

새 타임스탬프 폴더 또는 선택 폴더 직접 저장을 고릅니다. 동일 파일은 교체 / 건너뛰기 / 출력 취소 정책을 확인합니다. PSD는 외부 편집용이며 앱의 모든 편집 상태를 복구하려면 작업 파일이나 환경 백업을 사용합니다.

출력 형식, JPEG/WebP 품질, 원본 파일명 유지와 저장 위치 방식을 기억합니다. 파일 덮어쓰기처럼 매번 확인해야 하는 선택은 자동 복원하지 않습니다.

PSD 출력 화면

PSD 대상 선택과 글자 제외 옵션

결과물 자동 저장

설정 → 결과물 자동 저장에서 작품·화별 저장 여부와 연결 폴더를 관리합니다. 가져오기 단계에서는 자동 저장 여부와 출력 형식도 지정할 수 있습니다. 편집 결과를 연결 폴더에 계속 반영하며 앱 내부 편집 데이터 저장과는 별개입니다.

작품·화별 자동 저장 연결·형식·상태

  1. 대상 화의 자동 저장을 켜고 기본 결과물 폴더를 확인합니다.
  2. 화의 더 보기에서 결과물 보기로 폴더를 열거나 저장 위치를 변경합니다. 사용자 지정 위치는 기본 위치로 되돌릴 수 있습니다.
  3. 최신·대기·실패 상태를 확인합니다. 실패하면 폴더 접근 권한·저장 공간과 오류 내용을 먼저 확인합니다.

가져오기 화면의 자동 저장 형식은 원본 형식·PNG·JPEG·WebP를 지원합니다. 설정 화면에서 새로 연결하면 기본 출력 설정을 사용합니다.

폴더 저장 내용
result 번역문·보정을 합성한 완성 이미지
originals 복구용 원본
inpainted 원문 제거본
mask 제거한 영역

연결을 끄거나 폴더를 옮기기 전에 저장 위치와 미완료 항목을 확인하세요. 이 폴더들은 사용자 원본·결과물이므로 캐시처럼 삭제하지 않습니다.

작업 공유

작업 내보내기에서 작품과 화를 골라 .mgtshare로 저장합니다. 다른 PC의 작업 가져오기에서 새 작품을 만들거나 기존 작품에 화를 추가·교체합니다. 적용 전 최종 화 목록과 순서를 확인합니다.

작품·화 선택 후 작업 파일 저장

포함 별도 준비
원고 이미지, 블록·읽기 순서·서식, 인페인팅 결과 등 편집 데이터 앱 설정·ChatGPT 로그인·API 키·AI/OCR 모델·런타임. 필요한 폰트도 대상 PC에서 확인
작업 파일 가져오기 화면

가져올 작품과 화의 적용 방식

환경 백업과 복원

설정 → 일반 → 백업 및 이관에서 작업 환경을 ZIP으로 저장·복원합니다. .mgtshare가 선택 작품을 옮기는 기능이라면, 환경 백업은 보관함과 사용자 설정을 함께 옮기는 기능입니다.

앱 언어·휠 민감도·환경 백업 및 이관

백업에 포함 포함되지 않음
보관함 원본·편집 데이터·재개 체크포인트, 설정, 추가 폰트, 프리셋, 가리기 초안 API 키·로그인 세션·서비스 계정, 사용자 지정 API 헤더·추가 요청 본문, 모델·런타임·실행 도구·로그·캐시
  1. 기존 PC에서 백업 내보내기로 ZIP을 저장합니다.
  2. 새 PC에서 백업 가져오기 후 검증 결과·작품/페이지 수·교체 내용을 확인합니다.
  3. 복원하고 앱 다시 시작을 실행합니다. 현재 환경은 복구용 위치에 보존됩니다.
  4. 로그인·API 인증·폰트·GPU·모델을 확인하고 외부 결과 폴더를 다시 연결합니다.

같은 화면에서 이전 환경으로 되돌릴 수 있으며 복구용 환경은 자동 삭제하지 않습니다. 외부 연결 폴더·별도 출력 파일은 직접 옮겨야 하고 동기화 대기열은 이관하지 않습니다. 백업에는 개인 원고·번역이 포함되며 암호화된 공유 파일이 아닙니다.

환경 복원 확인과 수동 데이터 이관

백업 검증 후 교체 내용·기존 환경 보존 경로 확인

수동 이관은 앱을 종료하고 library 전체를 새 설치의 실제 데이터 폴더로 복사합니다. 보관함 이미지 경로를 보정해 읽지만 설정·폰트까지 옮겨지지는 않습니다. 인증 정보는 OS 암호화 저장소에 묶여 있어 단순 복사로 복원되지 않을 수 있습니다.

library는 작품 원본과 편집 데이터이며 캐시가 아닙니다. 데이터 폴더·외부 원본·출력물을 구분해 보존하세요. macOS 기본 데이터 위치는 ~/Library/Application Support/manga-gemma-translator입니다.

AI 앱 연결 · MCP

MCP(Model Context Protocol)는 AI 앱이 당근의 기능을 도구로 호출하는 연결 방식입니다. Codex·ChatGPT·Claude·Claude Code·OpenCode 등 MCP를 지원하는 앱에서 보관함을 읽고 번역·식자·검수·출력을 요청합니다. 변경 결과는 당근 보관함에 저장되어 앱에서 이어서 편집할 수 있습니다. 당근 안에서 바로 대화하려면 채팅으로 번역을 사용하세요.

외부 MCP도 앱 채팅과 같은 번역·원문 제거·검수 지침을 사용하고 앱의 이미지 도구를 기본으로 선택합니다. 호스트의 이미지 도구를 명시적으로 요청하면 그 선택과 해당 호스트 계정의 사용량을 따릅니다. MCP에서 작업별 로컬 제거 엔진을 선택해도 앱의 전역 설정은 바뀌지 않습니다.

MCP 연결 주소·승인된 앱·기능별 권한

작업 지원 범위
조회·검수 작품·화·페이지·블록·문맥 검색, 원본·부분 이미지·앱 렌더링 확인
번역·편집 AI가 작성한 번역문 저장, 앱 OCR·번역 실행, 블록 생성·수정, 여러 페이지 텍스트·서식 일괄 변경
식자·보정 폰트 목록·견본, 크기·배치·효과, 원문 제거·마스크·이미지 수정·효과음 처리
문맥·보관함 용어·인물·기억·조사, 파일·웹 원고 가져오기, 작품·화·페이지 구조 관리
출력·교환 PNG·JPEG·WebP·PSD·ZIP, 작업 파일·텍스트·검수표·문맥 파일, 연결 결과 폴더 동기화

MCP 연결 순서

  1. 당근 실행 PC에 Tailscale을 설치하고 로그인·기기 연결을 완료합니다.
  2. 설정 → AI 앱 연결 (MCP) → MCP 켜기를 누릅니다. HTTPS·Funnel 안내가 나오면 브라우저에서 허용한 뒤 다시 켭니다.
  3. 연결 가능 → 연결 방법 및 도움말 → 연결 진단을 확인하고 주소 복사로 /mcp까지 복사합니다.
  4. 사용할 AI 앱에 등록하고, 브라우저와 당근의 숫자 코드·요청 권한을 확인해 승인합니다.
  5. 새 대화에서 당근을 선택해 작업을 요청합니다. 사용하는 동안 당근과 Tailscale을 켜 둡니다.

클라이언트별 등록 화면·명령·권한·문제 해결 → MCP 상세 가이드

설정의 연결 방법 및 도움말에서 Codex·ChatGPT·Claude·Claude Code·OpenCode·Grok 웹·Grok Build·기타 MCP 앱의 등록 방법을 선택할 수 있습니다. Grok 웹은 Custom 커넥터에 주소를 등록하고, Grok Build는 복사한 등록 명령을 실행한 뒤 /mcps에서 OAuth 인증합니다. Grok 웹은 실제 계정의 OAuth 연결·보관함 조회·페이지 블록 및 원본 이미지 수신을 확인했습니다. 검증 범위에서 미검증 작업도 확인할 수 있습니다. OpenCode는 안내된 설정을 기존 opencode.json의 mcp 항목에 추가하고 opencode mcp auth carrot로 인증합니다. 이 연결은 외부 AI 앱에서 당근을 조작하는 기능이며, 당근 내부의 번역 엔진 설정과는 별개입니다.

OpenCode MCP 연결 도움말

실제 프로덕션 MCP 도움말의 OpenCode 등록·인증 안내 QA 화면

MCP 작업 요청과 권한

「작품명」 2화 1~3페이지를 한국어로 번역해줘. 1화의 용어·말투를 유지하고, 식자 결과를 확인한 뒤 PNG ZIP 파일을 줘.

요청에 작품·화·페이지 범위, 수정할 내용, 유지할 내용, 출력 형식을 지정합니다. AI가 직접 번역문을 저장하는 방식과 당근에 설정한 번역 모델을 실행하는 방식은 다릅니다. 원하는 쪽을 명시하면 됩니다. 출력은 작업 완료 후 다운로드 파일까지 요청하세요.

기본 조회 범위는 보관함 전체입니다. 이미지 전송·텍스트 편집·보관함 관리 및 모델 실행은 별도 권한으로 제어합니다. Funnel 주소는 인터넷에 공개되며 도구 호출에는 OAuth 인증과 앱 승인이 필요합니다. 권한 변경은 진행 작업 취소·재승인, MCP 끄기는 접속 중단, 연결 해제는 해당 AI 앱의 승인 철회입니다.

정밀 번역·식자 검수

전체 번역은 원본의 대사·작은 글씨·효과음 범위 확인, 실제 폰트 견본과 작품별 서식, 원문 제거 결과, 최종 렌더를 함께 검수하도록 안내합니다. 효과음의 처리 범위나 유지할 글씨는 요청에 명시하세요. 생성 글자에 잘못된 자모·받침이 남아 있으면 사용자 보정 대기로 남길 수 있으며, 정밀 완료로 표시하지 않습니다.

검수는 현재 저장된 페이지를 기준으로 합니다. 수정 후 오래된 검수 기록이나 빠진 근거는 완료로 인정하지 않으며, 앱에서 저장하지 않은 수동 편집과 충돌하는 변경도 보호합니다. 검수 근거가 갖춰졌다는 표시가 번역·미적 품질이나 모든 오자 검출을 보장하지는 않습니다. 기본 번역과 완료 기준에서 자세한 범위를 확인하세요.

단축키와 명령 검색

Ctrl+K로 기능 이름 검색, ?로 단축키 도움말을 엽니다. 설정 → 단축키에서 조합 변경·충돌 확인·기본값 복원이 가능합니다. macOS에서는 아래 Ctrl 대신 Cmd도 사용할 수 있습니다. 글자 입력 중에는 일부 도구 키가 실행되지 않습니다.

작업 기본 키
설정 / 명령 팔레트 / 도움말 Ctrl+, / Ctrl+K / ?
번역 설정 / 남은 페이지 이어서 T / Shift+T
모아보기 / 일괄 편집 / 출력 G / Ctrl+H / Ctrl+E
이전·다음 페이지 PageUp / PageDown (A / D, 방향키도 가능)
선택 / 블록 추가 / 손바닥 S 또는 1 / W 또는 2 / H 또는 3
원본 / 번역문 / 편집 테두리 O / V / Shift+B
자동 지우기 / 마스크 / 브러시 I / J / B
브러시 크기 줄이기 / 늘리기 [ / ]
사각형 / 원형 / 복원 지우개 / 색 추출 R / E / X / P
확대·축소 / 초기화 Ctrl+휠 / Ctrl+0
실행 취소 / 다시 실행 Ctrl+Z / Ctrl+Shift+Z
블록 전체 선택 / 복제 / 삭제 Ctrl+A / Ctrl+D / Delete
이전·다음 블록 Ctrl+Shift+Tab / Ctrl+Tab
읽기 순서 이동 / 좌표순 정렬 Ctrl+Alt+↑/↓ / Ctrl+Shift+R
서식 슬롯 1~10 Alt+1~Alt+0
명령 팔레트·단축키 설정 화면

기능 이름으로 찾는 명령 팔레트

단축키 변경과 충돌 확인

문제 해결

증상 확인할 항목
번역이 시작되지 않음 페이지 선택 → 언어·엔진 → 로그인·키·모델 준비 → OCR/모델 확인
첫 실행이 오래 걸림 모델 다운로드·검증 진행 상태. 준비 후 대표 페이지로 확인
메모리 부족·GPU 오류 작은 Gemma 프리셋·문맥 한도, GPU 권장값, OCR CPU·가벼운 원문 제거 모델
OCR 영역·내용이 잘못됨 원문 언어·HayaiOCR/PaddleOCR 비교, 영역·원문 수정 후 필요한 단계만 재실행
이름·말투가 흔들림 용어집·캐릭터·누적 컨텍스트. 이미 번역한 내용은 화자 조건 일괄 편집
글자가 넘치거나 너무 작음 영역·방향·줄바꿈·크기·장평, 부분 서식·말풍선 맞춤
원문 제거가 그림을 손상시킴 실행 취소·원본 복원, 제외 블록·마스크 범위, 다른 제거 모델
이미지 효과음이 보류됨 가리기와 대상 영역의 겹침 수정 후 이미지 작업 재개
저장·일괄 적용 충돌 최신 페이지를 다시 읽고 변경 전후 확인 후 적용
Codex 연결 실패 앱 안의 로그인·모델 목록, 로그의 내장 서버 오류
API 401/403/404 키·Base URL·모델·이미지 지원, 미지원 고급값 제거
출력 폰트가 다름 폰트 등록·누락, 부분 서식, PSD 래스터 처리 대상 확인
자동 저장이 밀리거나 실패함 연결 폴더 접근·남은 공간·대기/실패 상태 확인 후 재시도
MCP 연결·도구 호출 실패 당근·Tailscale 실행 → 진단 → 코드 승인·권한 → 도구 목록 갱신. 상세 해결

계속 재현되면 설정 하단의 오류 보고에서 보고서를 검토하고 이슈에 앱 버전·OS·엔진·재현 순서·예상/실제 결과를 적어 주세요. 보고서는 자동 업로드되지 않습니다. 로그·보고서의 API 키·개인 경로·원고 내용은 공유 전에 확인하세요. 개인정보 안내 · 보안 정책

작업 실패 알림에서 여는 보고서에는 실패 단계·실행 식별자·엔진·모델·사용 설정과 최근 진단 로그를 함께 모읍니다. 긴 보고서는 GitHub 본문에 요약을 채우고 전체 내용을 클립보드로 복사하므로, 전체 진단이 필요하면 붙여 넣어 주세요. 진단 수집이 지연돼 일부 항목을 얻지 못한 경우에는 수집된 정보로 보고서를 만듭니다. 모델 응답의 원문 미리보기는 공개 진단에서 제외하지만, 제출 전에는 내용을 직접 확인하세요.

개발·문서·라이선스

Node.js·npm·Git을 준비한 뒤 실행합니다.

npm install
npm run dev

검사: npm run check · Windows 패키지: npm run dist:win · Apple Silicon 패키지: npm run dist:mac · UI 캡처: npm run qa:ui -- --help

화면·메뉴는 2026-09-30 저장소 기준입니다. 배포 버전의 변경 사항은 릴리스 노트를 확인하세요. 스크린샷은 실제 프로덕션 컴포넌트에 예제 데이터를 넣어 qa:ui로 촬영했습니다. 전체 캡처 목록·검증 범위·예제 출처

Current rankings

  • 205

    Underappreciated Gems

    100 stars · 19 fork · Total stars (ascending)

    Underrated →

Momentum, past 30 days

Cumulative stars

Rank movement

Put your badge on the README · ucx0204/CarrotMangaTranslator[![Put your badge on the README](https://git.vaiox.xyz/api/badge/ucx0204/CarrotMangaTranslator.svg)](https://git.vaiox.xyz/en/repo/ucx0204/CarrotMangaTranslator)

Badge · 任何仓库都可以挂 —— 未上榜的仓库显示灰章,上完榜会自动点亮。

<a href="https://git.vaiox.xyz/en/repo/ucx0204/CarrotMangaTranslator"><img src="https://git.vaiox.xyz/api/badge/ucx0204/CarrotMangaTranslator.svg" alt="Put your badge on the README" height="20"></a>

← Back to boards

GitHub Hot BoardTime MachineDiscover联系我们 · Contact