Repolode
zh-plus

zh-plus/openlrc

faster-whisper로 오디오를 받아쓰고, OpenAI·Anthropic·Google 등의 LLM으로 텍스트를 번역하거나 다듬어 LRC 또는 자막 파일로 만드는 Python 라이브러리입니다.

스타
685
포크
54
열린 이슈
6
마지막 커밋
3개월 전

어떤 프로젝트인가요?

OpenLRC는 오디오와 동영상을 타임스탬프가 포함된 자막 파일로 변환합니다. faster-whisper로 음성을 받아쓴 뒤, 텍스트를 대규모 언어 모델에 보내 번역하거나 다듬어 .lrc 가사 파일 또는 .srt 자막을 생성합니다. OpenAI, Anthropic, Google, OpenRouter API 키를 사용할 수 있으며, 사용자 지정 OpenAI 호환 엔드포인트와 LiteLLM 라우팅도 지원합니다.

번역 과정에서는 각 파일을 순차적으로 처리해 앞부분의 문맥이 뒷부분의 번역에 반영되도록 합니다. 용어집 파일을 사용하면 게임 이름이나 고유명사 같은 분야별 용어를 일관되게 적용할 수 있습니다. 받아쓰기 오류를 줄이기 위해 입력 오디오의 라우드니스를 정규화하며, 추가 패키지를 설치하면 노이즈 억제 기능도 사용할 수 있습니다.

이 라이브러리는 PyPI에서 설치할 수 있으며, LRCer 클래스를 중심으로 한 Python API를 제공합니다. 이 API로 파일 하나 또는 여러 개를 처리하고, 이중 언어 자막을 만들거나 번역을 건너뛸 수 있습니다.

핵심 기능

  • 01번역에 앞서 faster-whisper로 오디오와 동영상의 음성을 받아씁니다.
  • 02OpenAI, Anthropic, Google, OpenRouter 또는 사용자 지정 엔드포인트를 사용해 자막을 번역하거나 다듬습니다.
  • 03분야별 용어를 일관되게 적용하는 용어집 파일을 지원합니다.
  • 04.lrc 가사 파일과 .srt 자막을 생성하며, 이중 언어 자막도 지원합니다.
  • 05입력 오디오에 라우드니스 정규화를 적용하고, 선택적으로 노이즈를 억제합니다.
  • 06토큰을 효율적으로 사용하도록 여러 모델을 조합하는 경량 번역 모드를 제공합니다.

활용 사례

  • 음악 라이브러리에 있는 노래의 싱크가 맞는 번역 가사를 만듭니다.
  • 동영상이나 팟캐스트의 자막을 다른 언어로 생성합니다.
  • 언어 학습용 이중 언어 자막 파일을 만듭니다.
  • Python 스크립트로 녹음 파일이 들어 있는 폴더를 일괄 처리합니다.

빠른 시작

  1. 1

    ffmpeg를 설치하고 bin 디렉터리를 PATH에 추가하세요

  2. 2

    OPENROUTER_API_KEY와 같은 LLM API 키를 환경 변수에 추가하세요

  3. 3

    PyPI에서 openlrc를 설치하세요

    pip install openlrc
  4. 4

    오디오 파일에 LRCer를 실행해 번역 자막을 생성하세요

사용 전 알아둘 점

  • 번역하려면 유료 제공업체의 LLM API 키가 필요합니다.
  • faster-whisper로 GPU 가속 전사를 사용하려면 CUDA와 cuDNN이 필요합니다.
  • ffmpeg를 설치하고 PATH에 추가해야 합니다.

포함된 컬렉션

토픽

#speech-to-text#whisper#subtitle#llm#translation#lyrics#audio#auto-subtitle#faster-whisper#lyrics-generator

자주 묻는 질문

openlrc은(는) 무엇인가요?
faster-whisper로 오디오를 받아쓰고, OpenAI·Anthropic·Google 등의 LLM으로 텍스트를 번역하거나 다듬어 LRC 또는 자막 파일로 만드는 Python 라이브러리입니다. OpenLRC는 오디오와 동영상을 타임스탬프가 포함된 자막 파일로 변환합니다. faster-whisper로 음성을 받아쓴 뒤, 텍스트를 대규모 언어 모델에 보내 번역하거나 다듬어 .lrc 가사 파일 또는 .srt 자막을 생성합니다. OpenAI, Anthropic, Google, OpenRouter API 키를 사용할 수 있으며, 사용자 지정 OpenAI 호환 엔드포인트와 LiteLLM 라우팅도 지원합니다.
openlrc은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
openlrc은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
openlrc은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. openlrc의 마지막 커밋은 2026년 8월 10일입니다.
openlrc은(는) 어디에 사용할 수 있나요?
음악 라이브러리에 있는 노래의 싱크가 맞는 번역 가사를 만듭니다. 동영상이나 팟캐스트의 자막을 다른 언어로 생성합니다. 언어 학습용 이중 언어 자막 파일을 만듭니다. Python 스크립트로 녹음 파일이 들어 있는 폴더를 일괄 처리합니다.
openlrc는 어떻게 설치하나요?
ffmpeg를 설치하고 bin 디렉터리를 PATH에 추가하세요 OPENROUTER_API_KEY와 같은 LLM API 키를 환경 변수에 추가하세요 PyPI에서 openlrc를 설치하세요: pip install openlrc 오디오 파일에 LRCer를 실행해 번역 자막을 생성하세요
openlrc은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/zh-plus/openlrc

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트