McCloudS/subgen

어떤 프로젝트인가요?

핵심 기능

• 01SRT 자막을 생성하고, 오디오만 있는 경우 LRC 파일을 생성합니다.
• 02원본 언어로 전사하거나 음성을 영어로 번역합니다.
• 03CPU 또는 CUDA를 통한 Nvidia GPU에서 실행됩니다.
• 04Bazarr의 Whisper 공급자로 연동하고, Plex, Jellyfin, Emby, Tautulli와 웹훅으로 연동합니다.
• 05폴더를 스캔하고 감시해 기존 파일이나 새 파일의 자막을 생성합니다.
• 06OpenAI 호환 전사 및 번역 엔드포인트를 제공합니다.

활용 사례

• 자막이 없는 홈 미디어 라이브러리에 자막을 추가합니다.
• Plex 또는 Jellyfin에 새 에피소드가 추가될 때 자동으로 자막을 생성합니다.
• Bazarr에 셀프 호스팅 Whisper 백엔드를 제공합니다.
• 간단한 HTTP API를 통해 개인 오디오나 비디오 녹화물의 자막을 생성합니다.

빠른 시작

1. 1

   하드웨어에 맞게 환경 변수 TRANSCRIBE_DEVICE와 WHISPER_MODEL을 설정합니다

2. 2

   README의 CPU 또는 CUDA 이미지를 사용해 Docker에서 Subgen을 실행합니다

3. 3

   Bazarr에서 Whisper Provider Docker Endpoint를 http://<your-ip>:9000으로 설정합니다

사용 전 알아둘 점

• !Nvidia GPU를 사용하면 음성 인식 속도가 훨씬 빠르지만, CPU만 사용하면 느립니다.
• !AMD GPU(ROCm) 지원은 테스트되지 않았으며 전혀 작동하지 않을 수도 있습니다.
• !large-v3-turbo 모델은 번역을 지원하지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

subgen은(는) 무엇인가요?

OpenAI Whisper로 미디어 파일에서 SRT 또는 LRC 자막을 생성하고 Bazarr, Plex, Jellyfin, Emby, Tautulli와 연동하는 셀프 호스팅 도구입니다. Subgen은 오디오 및 비디오 파일을 전사해 .srt 또는 .lrc 자막 파일로 만듭니다. 원래 사용된 언어를 유지하거나 외국어 음성을 영어로 번역할 수 있습니다. 내부적으로 stable-ts와 faster-whisper를 사용하며, CPU 또는 Nvidia GPU(CUDA)에서 로컬로 실행됩니다.

subgen은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

subgen은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

subgen은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. subgen의 마지막 커밋은 2026년 8월 7일입니다.

subgen은(는) 어디에 사용할 수 있나요?

자막이 없는 홈 미디어 라이브러리에 자막을 추가합니다. Plex 또는 Jellyfin에 새 에피소드가 추가될 때 자동으로 자막을 생성합니다. Bazarr에 셀프 호스팅 Whisper 백엔드를 제공합니다. 간단한 HTTP API를 통해 개인 오디오나 비디오 녹화물의 자막을 생성합니다.

subgen는 어떻게 설치하나요?

하드웨어에 맞게 환경 변수 TRANSCRIBE_DEVICE와 WHISPER_MODEL을 설정합니다 README의 CPU 또는 CUDA 이미지를 사용해 Docker에서 Subgen을 실행합니다 Bazarr에서 Whisper Provider Docker Endpoint를 http://<your-ip>:9000으로 설정합니다

subgen은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/McCloudS/subgen