SUBDOWNLOADER(1)

📦
version 2.1.0 · 4 versions
, in debian bookworm, ubuntu noble

💖 SUBDOWNLOADER 💖

okay bestie, listen — subdownloader is a free open-source tool written in PYTHON that automatically downloads and uploads subtitles for your videofiles (DIVX, MPEG, AVI, etc.) and for DVDs, and it does it using fast hashing. it's giving "I never want to hand-hunt a .srt ever again" and honestly? same. 🦋

✨ SYNOPSIS ✨

usage: subdownloader [-h] [--version] [-V [PATH ...]] [-s FILE]
                     [-l LANGUAGE [LANGUAGE ...]] [-g | -c]
                     [-d | -w | -e | -q] [--log FILE] [-C] [-i] [-r]
                     [--list-languages] [-D | -U]
                     [--name-online | --name-video | --name-lang | --name-uploader]
                     [-P PROXY]
                     [--provider NAME [KEY1=VALUE1 [KEY2=VALUE2 [...]]]
                     [NAME [KEY1=VALUE1 [KEY2=VALUE2 [...]]] ...]]

🎀 OPTIONS 🎀

  • --version — shows the program's version number and then dips out, exit stage left. 💅
  • -V, --video — the full path to your video(s). yes, full. don't be shy with the path.
  • -s, --settings — set the settings file. that's the one you're pointing it at.
  • -l, --lang — set the preferred subtitle language(s) for download and upload. plural-friendly, queen. 🌈

🌸 Change settings of the interface 🌸

  • -g, --gui — run the application in GUI mode. this is the default, so if you do nothing, you get the pretty windows. ✨
  • -c, --cli — run the application in CLI mode. terminal girlies, this one's for us.

💜 Change the amount of logging done 💜

  • -d, --debug — print log messages of debug severity and higher to stderr. maximum yapping, we love to see it.
  • -w, --warning — print log messages of warning severity and higher to stderr. this is the default.
  • -e, --error — print log messages of error severity and higher to stderr. only the dramatic stuff.
  • -q, --quiet — don't log anything to stderr. silent. mysterious. iconic. 🤫
  • --log — path name of the log file. where all the receipts get filed.

🦋 Change the behavior of the command line interface 🦋

  • -C, --console — start a console. like, just… a console.
  • -i, --interactive — prompt the user whenever decisions need to be made. it will literally ask you. it wants your input. it's giving main character energy and you are the main character. 💖
  • -r, --recursive — search for subtitles recursively. it goes deep. 🕳️
  • --list-languages — list the available languages and quit. window shopping, no commitment.
  • -D, --download — download subtitle(s). this is the default.
  • -U, --upload — upload subtitle(s). sharing is caring, bestie.
  • --name-online — use the on-line subtitle filename as the name for the downloaded subtitles.
  • --name-video — use the local video filename as the name for the downloaded subtitle.
  • --name-lang — use the local video filename + language as the name for the downloaded subtitle. this is the default.
  • --name-uploader — use the local video filename + uploader + language as the name for the downloaded subtitle. full lore in the filename, honestly.
  • -P, --proxy — proxy to use on internet connections. for when you gotta route around.
  • --provider — enable and configure a provider. it takes a NAME and then as many KEY1=VALUE1, KEY2=VALUE2, … pairs as your heart desires (and it'll happily take more NAME + key/value groups after that too, per the synopsis). go off. 🔥
come hang out with us at https://github.com/subdownloader/subdownloader 🎀

👑 AUTHOR 👑

SubDownloader Developers. yes, the whole crew. no cap.

2022, SubDownloader Developers.

that's the whole thing, bestie — version 2.1.0, dated Oct 16, 2022, and it lives in section 1 of the manual. go download some subtitles, you ate. 💅✨🍓

📦 where this page comes from