ChatGPT 스타일 LLM을 사용해 자막 파일(SRT, VTT, ASS, SSA)을 다른 언어로 번역하는 데스크톱 앱입니다.
Cerlancism/chatgpt-subtitle-translator
ChatGPT 또는 로컬 Ollama 모델을 포함한 OpenAI 호환 API를 사용해 SRT 자막 파일을 한 줄씩 번역하는 CLI 및 웹 도구입니다.
- 스타
- 391
- 포크
- 43
- 열린 이슈
- 4
- 마지막 커밋
- 6일 전
어떤 프로젝트인가요?
이 도구는 OpenAI chat completions API 또는 로컬 Ollama 서버와 같은 OpenAI 호환 제공자를 통해 대규모 언어 모델로 자막 파일과 일반 텍스트를 번역합니다. 줄 단위 번역을 기반으로 설계되어, 전송 전에 SRT 인덱스와 타임스탬프를 제거하고 여러 줄을 묶어 배치로 처리합니다. 이를 통해 토큰 사용량을 줄이고 입력과 출력의 줄 수를 일치시켜 자막 타이밍을 유지합니다.
웹 인터페이스와 CLI를 모두 제공합니다. CLI는 진행 상황 파일을 통한 중단 작업 재개, 사전 검수, 분당 요청 수 제한, 여러 구조화된 출력 모드(array, object, timestamp, none)를 지원합니다. 선택 사항인 에이전트 모드에서는 번역 전에 파일을 계획 단계에서 검토해 컨텍스트 요약을 작성합니다.
이 프로젝트는 JavaScript로 작성되었으며 Node.js 20 이상에서 실행됩니다.
핵심 기능
- 01SRT 자막과 일반 텍스트를 번역하는 웹 UI 및 CLI
- 02SRT 부가 정보를 제거해 토큰 사용량을 줄이는 줄 단위 배치 처리
- 03로컬 Ollama 모델을 포함한 모든 OpenAI 호환 제공자 지원
- 04번역된 줄과 입력 줄을 일치시키는 구조화된 출력 모드
- 05CLI에서 진행 상황 이어서 처리 및 스트리밍 출력 지원
- 06번역 전에 파일 전체를 검토하고 계획하는 선택적 에이전트 모드
활용 사례
- 영화나 TV 자막 파일을 다른 언어로 번역
- 타이밍을 다시 조정하지 않고 동영상 콘텐츠의 SRT 자막 현지화
- 로컬 Ollama 모델로 자막을 완전히 오프라인에서 번역
- 줄 순서를 유지하면서 일반 텍스트를 한 줄씩 번역
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/Cerlancism/chatgpt-subtitle-translator - 2
디렉터리로 이동합니다
cd chatgpt-subtitle-translator - 3
필수 항목을 설치합니다
npm install - 4
.env.example을 .env로 복사하고 API 키를 추가합니다
cp .env.example .env
사용 전 알아둘 점
- README에서 가정한 대로 Node.js 20 이상과 bash 계열 셸이 필요합니다.
- 번역 품질과 비용은 선택한 모델에 따라 달라집니다. Ollama와 같은 로컬 호환 제공자를 사용하지 않는 경우 OpenAI API 키가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- chatgpt-subtitle-translator은(는) 무엇인가요?
- ChatGPT 또는 로컬 Ollama 모델을 포함한 OpenAI 호환 API를 사용해 SRT 자막 파일을 한 줄씩 번역하는 CLI 및 웹 도구입니다. 이 도구는 OpenAI chat completions API 또는 로컬 Ollama 서버와 같은 OpenAI 호환 제공자를 통해 대규모 언어 모델로 자막 파일과 일반 텍스트를 번역합니다. 줄 단위 번역을 기반으로 설계되어, 전송 전에 SRT 인덱스와 타임스탬프를 제거하고 여러 줄을 묶어 배치로 처리합니다. 이를 통해 토큰 사용량을 줄이고 입력과 출력의 줄 수를 일치시켜 자막 타이밍을 유지합니다.
- chatgpt-subtitle-translator은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- chatgpt-subtitle-translator은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- chatgpt-subtitle-translator은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. chatgpt-subtitle-translator의 마지막 커밋은 2026년 11월 1일입니다.
- chatgpt-subtitle-translator은(는) 어디에 사용할 수 있나요?
- 영화나 TV 자막 파일을 다른 언어로 번역 타이밍을 다시 조정하지 않고 동영상 콘텐츠의 SRT 자막 현지화 로컬 Ollama 모델로 자막을 완전히 오프라인에서 번역 줄 순서를 유지하면서 일반 텍스트를 한 줄씩 번역
- chatgpt-subtitle-translator는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone https://github.com/Cerlancism/chatgpt-subtitle-translator 디렉터리로 이동합니다: cd chatgpt-subtitle-translator 필수 항목을 설치합니다: npm install .env.example을 .env로 복사하고 API 키를 추가합니다: cp .env.example .env
- chatgpt-subtitle-translator은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Cerlancism/chatgpt-subtitle-translator
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
음성 인식, 문장 분할, 교정, 번역, 자막 영상 삽입을 지원하는 LLM 기반 데스크톱 및 CLI 도구입니다.
설정 가능한 LLM 백엔드를 사용해 diff에서 Git 커밋 메시지를 생성하는 JetBrains IDE 플러그인입니다.
OpenAI 호환 채팅 모델을 사용하는 PWA 번역기로, 휴대폰이나 데스크톱에 설치할 수 있고 번역 기록을 로컬에 저장합니다.