VoxelCubes/PanelCleaner

Panel Cleaner – AI 기반 만화 패널 텍스트 제거 도구

기능 – Panel Cleaner는 만화/만화 페이지의 대화 박스 내 텍스트를 자동으로 감지하고 정밀한 마스크를 생성한 후, 텍스트를 제거(깨끗한 박스 유지)하거나 OCR을 통해 추출합니다. 사전 훈련된 텍스트 감지 모델, LaMa를 이용한 인페인팅, 그리고 선택적 MangaOCR/Tesseract를 통한 OCR을 사용합니다. 명령줄에서 헤드리스로 실행하거나 Qt GUI를 통해 실행 가능하며, CUDA 가속을 지원하고 Windows, macOS, Linux에서 작동합니다.

주요 기능

• 일본어 및 영어 텍스트를 감지하고 고정밀 마스크를 생성하며, 근처 아티팩트까지 확장합니다.
• 깨끗하게 마스크할 수 없는 박스는 LaMa 모델로 인페인팅합니다.
• 정리된 이미지, 투명한 마스크 레이어, 또는 둘 다 저장 가능합니다.
• 폴더 및 전체 디렉터리 트리의 배치 처리를 지원합니다.
• 일반 텍스트 프로파일(INI 형식)로 완전히 구성 가능 – 마스크 확장, 임계값 등 모든 파라미터를 조정하고 저장할 수 있습니다.
• 내장 OCR: 일본어용 MangaOCR, 영어/일본어용 Tesseract, GUI 내 인터랙티브 에디터 포함.
• 초기 약 500 MiB 모델 다운로드 이후 인터넷 필요 없음.
• 선택적 CUDA 지원으로 처리 속도 향상 (pip 설치 시에만 가능, 사전 빌드된 바이너리에서는 비활성화).
• 다국어 UI (영어, 독일어, 불가리아어, 스페인어) 및 커뮤니티 번역 지원.

설치 방법

1. 사전 빌드된 바이너리 – GitHub의 Releases 페이지에서 최신 릴리스를 다운로드 (대부분의 사용자에게 추천).
2. Python 패키지 – pip install pcleaner (CLI와 GUI 모두 설치) 또는 pip install pcleaner-cli (명령줄 전용).
3. AUR – yay -S panelcleaner (pipx 환경에 설치되어 CUDA 처리가 간편).
4. Flatpak – Flathub에서 io.github.voxelcubes.panelcleaner (CUDA 미지원).
5. Docker – 제공된 Dockerfile을 빌드하고 호스트 폴더에 이미지를 마운트하여 컨테이너 실행.

일반적인 명령줄 워크플로우

# 몇 개의 파일을 정리하고 정리된 이미지 저장
pcleaner clean page1.png page2.png

# 폴더를 정리하고 마스크 레이어만 유지
pcleaner clean -m my_folder

# 사용자 정의 프로파일 사용
pcleaner clean -p my_profile folder/

# OCR 실행 및 결과를 텍스트 파일에 저장
pcleaner ocr my_folder --output-path=out.txt

GUI는 pcleaner gui 또는 pcleaner-gui로 시작할 수 있으며, 마스크 미리보기, 분석, OCR 에디터를 제공합니다.

제한 사항

• 정리 기능은 일본어와 영어만 지원; OCR은 일본어(MangaOCR)와 영어(Tesseract)에 대해 작동합니다.
• 마스크는 그레이스케일만 지원하므로 흰색/검은색/회색 박스에는 적용 가능하지만 색상 박스에는 적용 불가.
• AI 감지기는 완벽하지 않음 – 2~8%의 박스가 놓치거나 잘못 마스크될 수 있으며, 확신이 없는 박스는 건너뜁니다.
• 사전 빌드된 바이너리에는 CUDA 포함되지 않음; GPU 가속은 호환되는 PyTorch 빌드를 포함한 pip 설치 필요.

라이선스 – GNU GPL-v3 (동일 라이선스 하에 자유롭게 사용, 수정, 재배포 가능).

누가 도움이 될까 – 재레이아웃 전에 만화 패널의 텍스트를 빠르게 제거해야 하는 번역가, 스캔레이터, 또는 하류 컴퓨터 비전 작업을 위한 깨끗한 박스 이미지가 필요한 연구자.