Repolode
Cerlancism

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. 1

    저장소를 클론합니다

    git clone https://github.com/Cerlancism/chatgpt-subtitle-translator
  2. 2

    디렉터리로 이동합니다

    cd chatgpt-subtitle-translator
  3. 3

    필수 항목을 설치합니다

    npm install
  4. 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 통계는 매일 갱신됩니다.

관련 프로젝트