About this project

This tool is a command-line program that automatically extracts subtitles upon inputting a Bilibili BV number. If the video already has uploaded or AI subtitles, they are downloaded directly; if no subtitles exist, the tool automatically downloads the audio and calls the SiliconFlow ASR service to convert it to text, generating SRT files with timestamps, plain text TXT files, and metadata JSON files. It supports batch processing for multi-part videos, local caching to avoid duplicate requests, proxy settings, and enhanced audio downloading via yt-dlp. Core functionality relies solely on the Python 3.10+ standard library with zero mandatory dependencies. Users must register with SiliconFlow to obtain an API Key for ASR functionality. The output structure is clearly organized by BV number and title for easy management. Additionally, a sister project, bili-subtitle, provides a browser extension version suitable for one-click extraction without configuration.