SubDL is a Python-powered CLI tool for searching and downloading subtitles from subdl.com.
It supports both API and web scraping, offers interactive selection, and features a rich progress bar for downloads.
- Search subtitles via SubDL API or web scraping fallback
- Interactive selection of movies/series and subtitle languages
- Batch download: download all, by index, or by name
- Rich progress bar for downloads
- Debugging & pretty-print for developers (with
DEBUGenv) - Customizable download path
- Python 3.8+ compatible
-
Clone this repo:
git clone https://github.com/yourusername/subdl.git cd subdl/subdl -
Install dependencies:
pip install -r requirements.txt
Or manually:
pip install requests beautifulsoup4 rich rich-argparse configset jsoncolor json5
python subdl.py "movie or series name"python subdl.py "movie name" --webpython subdl.py "movie name" -p ./my_subtitles- Choose the movie/series from the list
- Choose subtitle language
- Choose subtitle(s) to download (single, multiple, or all)
- Enter
ato download all subtitles in a language - Enter
1,3,5to download by indices - Enter subtitle names separated by space to download by name
Set DEBUG or DEBUG_SERVER in your environment to enable extra logging and pretty JSON dumps:
export DEBUG=1
python subdl.py "movie name"python subdl.py "avengers endgame"- Select the movie from the list
- Select language (e.g. English)
- Select subtitle(s) to download
- This tool scrapes subdl.com and may break if the site changes.
- For best results, use Python 3.8+ and a modern terminal.
- All downloads go to the
subtitlesfolder by default (or your custom path).
- Found a bug? Open an issue or PR!
- Want a new feature? Fork and hack away!
MIT License
Happy subtitle hunting! 🎬
