프로젝트 소개

본 도구는 커맨드라인 프로그램으로, Bilibili BV 번호를 입력하면 자동으로 자막을 추출합니다. 영상에 이미 업로드된 자막이나 AI 자막이 있는 경우 이를 직접 다운로드하며, 자막이 없는 경우에는 오디오를 자동으로 다운로드한 후 SiliconFlow ASR 서비스를 호출하여 텍스트로 변환합니다. 이를 통해 타임스탬프가 포함된 SRT 파일과 순수 텍스트 TXT 파일을 생성하며, 메타 정보가 담긴 JSON 파일도 함께 저장합니다. 다중 파트(P) 영상의 일괄 처리, 중복 요청 방지를 위한 로컬 캐싱, 프록시 설정 및 yt-dlp를 통한 강화된 오디오 다운로드를 지원합니다. 핵심 기능은 Python 3.10+ 표준 라이브러리에만 의존하며 강제적인 외부 의존성이 없습니다. ASR 기능을 사용하려면 SiliconFlow에 직접 가입하여 API Key를 취득해야 합니다. 출력 구조는 BV 번호와 제목별로 디렉토리가 구성되어 관리가 용이합니다. 또한, 설정 없이 원클릭 추출이 가능한 브라우저 확장 프로그램 버전인 자매 프로젝트 bili-subtitle도 제공됩니다.