kone
소미소프트
소미소프트

Pupil(모바일 hitomi뷰어) 번역기능 추가버전

유틸
17,352 views · 7 points

전에 올렸던 Pupil 번역기능 탑재 버전의 개선판임

대략적인 사용 예시
1
1
1


개선 사항
1. 인페인팅 시 글자 자국이 많이 남는 문제 개선
2. 글자 일부가 마스킹 되지 않는 문제 개선
3. gpu기반 모델들이 캐시되지 않고 있던 문제 개선 → 번역 속도 장당 평균 1.4초로 개선
4. 전반적인 사용 편의성 개선

Pupil Trans 사용 방법

PC에서 번역 서버를 켜 두면, 휴대폰 앱이 만화 페이지를 PC로 보내서 번역된 이미지를 받아 옴. PC와 휴대폰이 같은 와이파이에 연결되어 있어야 함.

준비물

  • Windows PC

  • Python 3.12 또는 3.13 (설치 화면에서 "py launcher"에 체크)

  • 번역 AI의 API 키 (잘 모르겠으면 구글 AI studio나 OpenRouter 가입해서 크레딧 충전하고 키 만들면 됨)

1. 휴대폰에 앱 설치

압축 파일 안의 Pupil-Trans-v6.1.1.apk를 휴대폰으로 옮겨서 설치함.

2. PC에 번역 서버 설치 (처음 한 번만)

  1. 압축 푼 폴더를 엶.

  2. 폴더 빈 곳에서 Shift + 마우스 오른쪽 클릭 → "PowerShell 창 열기"(또는 "터미널에서 열기")를 누름.

  3. 내 그래픽카드에 맞는 줄을 복사해서 붙여 넣고 Enter 누름.

    • NVIDIA (지포스 RTX 등):

      powershell -ExecutionPolicy Bypass -File install.ps1 -Hardware nvidia
      
    • AMD (라데온):

      powershell -ExecutionPolicy Bypass -File install.ps1 -Hardware amd
      
    • 잘 모르겠거나 그래픽카드가 없음 (느림):

      powershell -ExecutionPolicy Bypass -File install.ps1 -Hardware cpu
      
  4. "설치 완료"가 뜰 때까지 기다림. 몇 분 걸릴 수 있음.

3. API 키 넣기 (처음 한 번만)

  1. server 폴더 안의 .env 파일을 메모장으로 엶.

  2. 아래 세 줄을 찾아서 채움. = 뒤에 띄어쓰기나 따옴표 없이 바로 붙여 넣어야 함.

    TRANSLATOR_PROVIDER=openrouter
    TRANSLATOR_API_KEY=여기에_내_API_키
    TRANSLATOR_MODEL=deepseek/deepseek-v4.1-flash
    

    OpenRouter 쓰면 키만 넣으면 됨.

  3. 저장하고 닫음.

4. 서버 켜기

  1. 폴더에서 tray.bat을 더블클릭함.

  2. 화면 오른쪽 아래(시계 옆) 아이콘 모음에 "P" 아이콘이 생김. 안 보이면 ^ 버튼 눌러 보면 됨.

  3. 처음 켤 때는 준비하느라 20~30초 걸림. 아이콘이 초록색이 되면 준비 끝.

5. 휴대폰이 접속할 수 있게 하기 (처음 한 번만)

  1. "P" 아이콘을 마우스 오른쪽 클릭함.

  2. "휴대폰 접속 허용"을 누름.

  3. 다시 오른쪽 클릭해서 "방화벽 열기"를 누름. 관리자 권한 물어보면 "예" 누르면 됨.

집 와이파이(로컬 네트워크)에서만 쓸 것. 카페나 학교 같은 공용 와이파이에서는 같은 와이파이의 다른 사람이 내 서버(와 내 API 키)를 쓸 수 있음.

6. 앱 연결하기 (처음 한 번만)

  1. 휴대폰에서 Pupil Trans 열고 설정 → 번역 → 번역 서버 주소로 들어감.

  2. "서버 찾기" 누르면 PC를 찾아서 주소가 자동으로 채워짐.

  3. "연결됨"이 뜨면 확인 누름.

  4. "로컬 네트워크 기기 접근" 권한 물어보면 허용함.

이제 만화 열고 리더 메뉴에서 번역 켜면 그 페이지부터 번역됨.

안 될 때

  • "P" 아이콘이 빨간색이 되거나 바로 꺼질 때

    1. 아이콘 오른쪽 클릭해서 서버를 끔(또는 트레이를 종료함).

    2. 폴더의 start.bat을 더블클릭함. 검은 창에 오류 메시지가 나옴.

    3. 그 창 내용을 전부 복사해서 ChatGPT나 Claude 같은 AI한테 "이거 해결해 줘"라고 붙여 넣으면 대부분 해결됨.

    4. 제일 흔한 원인은 .env에 API 키를 안 넣었거나 잘못 넣은 경우임.

  • 휴대폰에서 서버를 못 찾을 때: PC와 휴대폰이 같은 와이파이인지, 5번 했는지 확인할 것. 그래도 안 되면 PC에서 ipconfig로 IPv4 주소 확인해서 앱에 192.168.0.10:37380처럼 직접 입력하면 됨.


링크: aHR0cHM6Ly9raW8uYWMvYy9ibkZCSDZNbXBXSjZiNXlyOXd6NmVi
ㅂㅂㄱㄹ
한달

7
6 comments
Pupil 이거 다운로드 하면 이미지를 하나하나 다운해서 곧바로 n드라이브 백업으로 들어가는거 귀찮아....
번역기능 자체는 캐시된 이미지를 번역하는거라 딱히 다운받을 필요없음
진짜 감사드립니다.
전에 설치한 사람은 앱만 교체하면 되나요?
ㄴ 서버 파일 자체도 수정이 많이되서 호환안됨
All
Title
Body