소나기 ocr ver1.0 설명서

안녕하세요 

 

소나기입니다.

 

오늘은 코딩 2주차인 제가 무려 이틀에 걸쳐서 개발한 (chatGPT를 괴롭힌) 프로그램을 소개 및 배포하고자 합니다.

 

아래 내용은 chatGPT의 도움을 받아 작성하였습니다.

 

https://youtu.be/x8I9qlIov-c

 

사용법 유튜브 첨부합니다.

📘 프로그램 이름: 소나기OCR 번역기

🔹 소개

• 기능 요약:
  이 프로그램은 화면의 텍스트를 실시간으로 인식(OCR)하고, 원하는 언어로 번역하여 화면에 표시해주는 번역 도우미입니다. 게임이나 영상 위의 자막 등 다양한 상황에서 활용할 수 있습니다.
• 지원 언어:
  영어, 일본어, 중국어, 스페인어, 독일어, 러시아어 → 한국어 (기본값)
  ※ 설정을 통해 다양한 언어 조합 가능

---

💾 설치 및 실행

1. 준비 사항

• 운영체제: Windows 10 이상 권장
• 필수 조건: 인터넷 연결 (번역 API 사용을 위해 필요)

2. 실행 방법

1. 압축을 해제한 폴더 내에서 main.exe 파일을 더블 클릭합니다.
2.  

3. 다음과 같이 프로그램이 실행이 됩니다.

4. 설정에 들어가서 원하는 번역 언어를 설정합니다.

참고로 EN(영어) JA(일본어) zh-CN(중국어) 입니다.

목표 언어는 기본적으로는 KO(한국어)로 되어 있습니다.

단축키는 디폴트값이 F8이며 번역 시작 (중단)을 버튼을 눌리지 않고도 사용하게 해줍니다.

원하는 설정을 한 뒤 저장을 하고 나옵니다.

5.

최초로 사용할때는 API 키를 입력해야 합니다. (그러지 않으면 실행되지 않습니다.)
API키를 얻는 방법은 하단 부에 설명되어 있습니다.

API키를 입력하면  해당 txt 파일이 생겨 다음에 이 프로그램 실행시 사용할 필요가 없습니다.

 

6. 원하는 게임을 실행시킵니다. (게임이 아니라 문서도 되는것을 확인은 했습니다.)

 

7. 아래 버튼을 눌리고 게임의 적절한 대화창을 (번역하고 싶은 부분) 드래그해서 지정합니다.

 

8. 이후 아래 버튼을 눌려 적절한 대화 표시부분 (텍스트가 표시되었으면 좋겠는 부분)을 드래그해서 지정합니다.

 

 

다만 이때 ocr 위치와 overlay 위치가 중첩되어선 절대 안됩니다.

ocr의 문자를 읽어서 overlay에 뿌려주는데, 위치가 중첩되면 ocr이 읽을수가 없기 때문입니다.

 

9. 아래 버튼을 눌려 원하는 api를 선택합니다. papago가 디폴트이며 deePL과 open AI를 지원합니다.

open AI의 경우 유료 API키를 openai.txt에 저장하셔서 로드하시면 되는데, 이 api키를 가지고 계실정도면

별도의 설명을 하지 않아도 될 것이라 판단하여 api키를 획득하는 방법은 기술하지 않았고, 조금 더 

번역의 품질이 좋아지는 것 같습니다. (이용료도 얼마하진 않습니다)

 

 

 

10. 이후 아래의 번역 시작 버튼을 눌리거나 혹은 단축키 (디폴트 f8)을 눌리면, overlay가 띄워지면서 번역이 되고

 

---

 

 

와 같이 번역 켜짐으로 상단부가 바뀌고 번역이 중단되면 (번역 중단 버튼 or 단축키 F8) 얼마나 API키를 사용했는지가

계산되어 나타납니다.

 

🧠 주요 기능

 

▶️ 실시간 번역

• F8 키로 번역 On/Off
• 텍스트 인식 → 실시간 번역 → Overlay로 화면 표시

🌐 지원 번역 엔진

• NHN Papago (기본값, 무료 API 가능)
• DeepL (Free API Key 필요)
• OpenAI GPT (유료, openai.txt 필요)

🎛️ 다양한 설정 지원

• OCR 영역 위치, Overlay 출력 위치 조정 가능
• 폰트 종류, 크기, 색상 조절 가능
• 프리셋 저장 및 불러오기 지원

---

⚙️ 설정 방법

🔑 API 키 입력

번역 엔진을 사용하려면 각 번역 API의 API 키를 입력해야 합니다. 아래 절차를 따라 API 키를 얻고 입력하세요.

---

📜 1. DeepL API 키 받기

1. DeepL 웹사이트에 접속: https://www.deepl.com/ko/translator
2. 회원 가입/로그인: DeepL 계정이 없다면 회원 가입을 진행합니다.
3. API 요금제 선택: 기본적인 번역 API는 무료 요금제(무료 사용량 한도 있음) 또는 유료 요금제를 선택할 수 있습니다.
4. API 키 받기: 로그인 후 My Account로 이동하여 API 키를 확인하고 복사합니다.
5. API 키 입력: 프로그램 설정에서 🔑 DeepL API 입력 버튼을 클릭하여 복사한 API 키를 deepl.txt 파일에 입력합니다.

---

📜2.  NHN Papago API 키 받기 (네이버 클라우드 기준)

1. 네이버 클라우드 플랫폼 접속:
   아래 링크를 클릭하여 네이버 클라우드 플랫폼의 Papago 번역 서비스 페이지로 이동합니다.
   👉 https://www.ncloud.com/product/aiService/papagoTranslation
2. 로그인 및 회원가입:
   네이버 계정으로 로그인합니다. 계정이 없다면 회원가입을 진행합니다.
3. 서비스 이용 신청:
   페이지에서 [이용 신청] 버튼을 클릭하여 Papago 번역 서비스 신청을 진행합니다.
4. 애플리케이션 등록:
   신청 완료 후, [Application 등록] 버튼을 눌러 애플리케이션을 생성합니다.
5. API 키 발급:
   애플리케이션 등록 화면에서 서비스 항목 중 **[Text Translation]**을 선택하고 등록을 완료합니다.
6. Client ID 및 Client Secret 확인:
   등록이 완료되면 해당 Application의 상세 화면에서 Client ID와 Client Secret을 확인할 수 있습니다.
7. 프로그램에 API 키 입력:
   프로그램 상태창의 ☁️ NHN Papago API 입력 버튼을 클릭하여 발급받은 Client ID와 Client Secret을 입력하면 자동으로 papago_nhn.txt 파일이 생성됩니다.

 

📜3.  OPEN AI API 키 받기 

1. open ai key(유료) 구매후 api키를 openai.txt 파일에 저장하면 됩니다.

🖼️ OCR / Overlay 위치 재설정

• 📐 OCR 위치 재설정: 마우스로 드래그하여 인식할 영역 지정
• 🖼️ Overlay 위치 재설정: 번역 결과가 표시될 위치 지정

💾 프리셋 기능

• 위치 설정을 이름으로 저장 (💾 프리셋 저장)
• 불러오기 (📂 프리셋 불러오기)
• 초기화 (🧹 프리셋 리셋)

---

📊 사용량 표시

• 상태창에서 실시간으로 번역 엔진 사용량 확인 가능
  (예: NHN Papago의 경우 일일 500만자 기준 사용량 퍼센트 표시)

---

❓ 자주 묻는 질문(FAQ)

Q. 번역이 작동하지 않아요!

• API 키가 누락되었거나 잘못 입력되었을 수 있습니다. 설정 버튼을 눌러 키를 다시 확인해주세요.

Q. 실행 후 아무 반응이 없어요.

• 프로그램이 백그라운드에서 작동 중일 수 있습니다. F8 키를 눌러 번역을 시작해보세요.

 

---

📝 기타

• 프로그램 아이콘은 rururu.ico 기준입니다.
• 블로그: https://sonagi-psy.tistory.com/8