eeeXun/gtt

gtt – 터미널 기반 번역 UI

무엇인가요 – gtt 는 Go로 작성된 작은 명령줄 프로그램으로, 터미널을 벗어나지 않고도 텍스트를 한 언어에서 다른 언어로 번역할 수 있습니다. 소스와 목적지의 두 개의 패널을 제공하며, Google, DeepL, Bing, Apertium, LibreTranslate, Reverso, 그리고 ChatGPT 기반 번역을 포함한 여러 온라인 번역 서비스 중에서 선택할 수 있습니다. UI는 키보드 단축키로 제어되며, 서비스의 텍스트 음성 변환 엔드포인트를 통해 텍스트를 읽어주는 기능도 제공합니다.

주요 기능

• 여러 백엔드를 지원하며, 실시간으로 제공자 전환 가능.
• 무료 API(Google, Bing 등)와 키가 필요한 유료 API(ChatGPT, DeepL, LibreTranslate, DeepLX) 모두 작동. 키는 간단한 YAML 설정 파일에 저장됩니다.
• 사용자 정의 키 바인딩, 색상 테마, 선택적 클립보드 복사 기능(‘xclip’, ‘wl-clipboard’, 또는 OSC 52를 통해)을 갖춘 전체 화면 TUI.
• 소스 및 번역된 텍스트에 대한 텍스트 음성 변환 기능과 재생/정지 컨트롤 제공.
• 소스/목적지 언어 교체, 버퍼 지우기, 선택된 텍스트 또는 전체 텍스트 복사 기능.

설치 방법

• Linux 및 macOS용 사전 빌드된 바이너리는 GitHub 릴리스 페이지에 있습니다.
• Arch Linux 사용자는 AUR 패키지 gtt-bin을 설치할 수 있습니다 (yay -S gtt-bin).
• Nix 사용자는 nixpkgs-unstable에서 gtt를 추가하거나 nix run github:nixos/nixpkgs#gtt를 실행할 수 있습니다.
• 소스에서 빌드 – go install github.com/eeeXun/gtt@latest (이 경우 $HOME/go/bin에 바이너리가 추가됨) 또는 리포지토리를 클론하고 go build를 실행.
• Docker 이미지 eeexun/gtt도 제공됩니다 (docker run -it eeexun/gtt:latest).

설정 방법

• $XDG_CONFIG_HOME/gtt/server.yaml (또는 $HOME/.config/gtt/server.yaml) 파일을 생성합니다. API 키는 api_key.<service>.value 아래에 기입하거나, 키를 포함한 파일 경로를 지정합니다.
• 자체 호스팅 서비스(예: DeepLX 또는 개인용 LibreTranslate 인스턴스)를 사용할 경우, host.<service>에 IP:port를 설정합니다.
• 선택적 keymap.yaml 및 theme.yaml 파일을 동일한 설정 디렉터리에 두면, 단축키 재매핑 및 색상 변경이 가능합니다.

일반적인 사용법

# 기본값(Google)을 사용하여 영어 → 번체중국어로 번역
gtt -src "English" -dst "Chinese (Traditional)"

UI 내에서 다음 작업이 가능합니다:

• <C-j> – 현재 소스 패널 번역.
• <C-s> – 소스와 목적지 언어 교체.
• <C-y> / <C-g> / <C-r> – 선택된 텍스트, 전체 소스 텍스트, 전체 목적지 텍스트 복사.
• <C-o> / <C-p> – 소스 또는 목적지 텍스트 음성 재생.
• <Esc> – 팝업 메뉴 열기. 여기서 제공자 변경, 투명도 토글 등 가능.

왜 중요한가요 – 많은 개발자가 웹 기반 번역 도구를 사용하지만, gtt 는 동일한 기능을 터미널에 제공하여 원격 작업, 스크립팅, 또는 쉘 내에서만 작업하는 워크플로우에 매우 유용합니다. 여러 백엔드를 지원함으로써, 번역 품질을 비교하거나 유료 API가 사용 불가능할 경우 무료 서비스로 대체할 수 있습니다.

크레딧 – 이 프로젝트는 soimort/translate-shell, SimplyTranslate-Engines, s0ftik3/reverso-api의 요청 로직을 재사용하였으며, UI는 snsd0805/GoogleTranslate-TUI와 turk/free-google-translate에서 영감을 받았습니다.