개발 프로그램/소나기 OCR
소나기 ocr#3 사용법 안내
sonagi-psy
2025. 4. 19. 16:19
반응형
📘 OCR 실시간 번역기 사용자 설명서
📌 개요
OCR 실시간 번역기는 화면에 보이는 텍스트를 자동으로 인식하고 실시간으로 번역 결과를 오버레이 창에 표시해주는 프로그램입니다.
게임, 동영상, 웹사이트 등 다양한 환경에서 실시간 번역을 제공하며, DeepL 또는 LibreTranslate 번역 엔진을 선택해 사용할 수 있습니다.
🖥️ 주요 기능
기능설명
| 📸 실시간 OCR 인식 | 게임 화면, 이미지, 웹페이지 등에서 텍스트 인식 |
| 🌐 자동 번역 | DeepL 또는 LibreTranslate 번역 엔진 선택 가능 |
| 🖼️ 오버레이 출력 | 화면 위에 번역된 텍스트를 실시간으로 표시 |
| 🧪 이미지 전처리 | OCR 정확도 향상을 위한 대비/선명도 조절 기능 |
| ⚙️ 설정 저장 | 언어, 위치, 크기, 단축키 등 사용자 설정 유지 |
| 🔑 API 키 설정 | DeepL 사용 시 API 키 직접 입력 가능 |
| ⌨️ 단축키 지원 | F8 기본값으로 번역 시작/중단 |
🛠️ 설치 및 실행 방법
🔹 1. 프로그램 실행
- 압축 해제 후, ocr_translator_lite.exe 파일을 실행합니다.
- 별도로 Python이 설치되어 있을 필요는 없습니다.
🌐 번역 엔진 선택 및 설정
✅ DeepL 사용 시
- DeepL 개발자 센터(https://www.deepl.com/ko/translator)로 이동합니다.
- "Free API" 요금제에 가입하여 API 키를 발급받습니다.
- 프로그램 내 🔑 DeepL API 설정 버튼을 클릭해 API 키를 입력합니다.
- 이후 번역 엔진을 deepl로 설정하면 사용 가능합니다.
💡 DeepL은 더 자연스럽고 고급스러운 번역 품질을 제공합니다.
✅ LibreTranslate 사용 시 (오프라인 무료 엔진)
- install_models.bat 파일을 실행하여 영어 → 한국어 모델을 설치합니다.
⏳ 소요 시간: 약 5분 (인터넷 연결 필요, 한 번만 실행) - 설치 완료 후 run_libretranslate.bat을 실행하면 로컬 서버가 켜집니다.
(명령어 창이 떠 있는 동안 LibreTranslate 서버가 작동 중입니다.) - 프로그램에서 번역 엔진을 libretranslate로 선택하면 바로 사용 가능합니다.
💡 LibreTranslate는 인터넷 없이도 사용할 수 있는 무료 번역 엔진입니다.
🧭 기본 사용 방법
1. OCR 영역 설정
- 📐 OCR 위치 재설정 버튼 클릭 후 마우스로 화면의 번역할 영역을 드래그해 설정
2. 오버레이 위치 설정
- 🖼️ 오버레이 위치 재설정 버튼을 클릭하여 오버레이 텍스트가 표시될 위치 지정
3. 번역 시작
- ▶️ 번역 시작 버튼 또는 단축키 F8으로 번역 시작/중단 전환
4. 설정 변경
- ⚙️ 설정 버튼을 통해 언어, 단축키, OCR 주기, 전처리 옵션 등 조정 가능
- 기본 설정 / 고급 설정으로 탭이 분리되어 있어 접근이 편리함
🧪 이미지 전처리 기능 (선택 사항)
- OCR 정확도를 향상시키기 위한 기능입니다.
- 고급 설정 탭에서 아래 기능들을 활성화할 수 있습니다:
전처리 옵션설명
| 대비 향상 | 흐릿한 이미지 개선 |
| 노이즈 제거 | 배경 잡음 제거 |
| 선명도 향상 | 글자 윤곽 강조 |
📂 구성 파일 설명
파일명설명
| ocr_translator_lite.exe | 프로그램 실행 파일 |
| settings.json | 사용자 설정 저장 파일 |
| deepl.txt | DeepL API 키 저장 파일 |
| libretranslate.txt | LibreTranslate API 설정 저장 파일 |
| install_models.bat | LibreTranslate용 언어 모델 설치 파일 |
| run_libretranslate.bat | LibreTranslate 서버 실행 스크립트 |
🚨 오류 해결 Q&A
증상원인해결 방법
| 프로그램 실행 시 아무 반응 없음 | 보안 경고 또는 권한 문제 | ocr_translator_lite.exe를 우클릭 후 "관리자 권한으로 실행" |
| 번역이 안 됨 | API 키 누락 또는 서버 미작동 | DeepL 키 입력 여부 확인 / Libre 서버 실행 여부 확인 |
| 오버레이 위치 잘못됨 | 해상도 변경 등 | 🖼️ 오버레이 위치 재설정 실행 |
| 창 일부 안 보임 | DPI 배율 문제 | 설정에서 DPI 스케일 확인 및 재조정 |
| 오류 메시지 불명확 | 예외 발생 | debug_log.txt를 확인하여 에러 내용 추적 가능 |
💡 자주 묻는 질문(FAQ)
Q. 인터넷 없이도 번역이 가능한가요?
A. 네, LibreTranslate를 로컬 서버로 실행하면 인터넷 없이도 번역할 수 있습니다.
Q. 어떤 언어를 지원하나요?
A. 영어, 일본어, 한국어, 중국어, 독일어, 스페인어, 프랑스어 등 다양한 언어를 지원합니다.
Q. 여러 번 같은 문장이 나올 때 번역이 반복되나요?
A. 동일한 문장은 최대 3회까지 재번역을 건너뛰고 이전 결과를 재사용합니다.
반응형