Skip to main content

Download subtitle from subscene

Project description

ezsub

Downloads Published Version GitHub Release License: MIT Build Status

ezsub downloads subtitles from subscene.com and its persian clones such as subf2m.co.
For more details see How ezsub Works.


Table of Contents


Install

Dependencies:

  • python3.7+
  • unrar [optional]

Install latest published release using pip3

# linux and mac
python3 -m pip install --user --upgrade ezsub

# windows
python -m pip install --user --upgrade ezsub

For installing latest in progress version from github (not recommended) use this command:

python3 -m pip install --user --upgrade https://github.com/7aman/ezsub/archive/master.zip

# windows
python -m pip install --user --upgrade https://github.com/7aman/ezsub/archive/master.zip

See here for more details.


How to Use

Download

ezsub dl -t|-T TITLE -l LNG1 [LANG2 ...] -d DESTINATION -s SITE1 [SITE2 ...] -a|-A -o|-O -S -g|G

For details on each switch see this

Examples:

# if search keywords are distinctive enough, use auto select (-a)
ezsub dl -t riverdale third season -l fa -a

# determine site. If site is not responding, ezsub will choose first responding site automatically.
ezsub dl -t game of thrones -s subscene

# movies, tv series, video musics are not different.
ezsub dl -t how to train your dragon

# if you know exact title used in url use this -T
# for example subscene page for first season of "the end of the f***ing world" is:
# https://subscene.com/subtitles/the-end-of-the-fing-world
#so:
ezsub dl -T the-end-of-the-fing-world

# extract here and relative to here (both windows and unix)
ezsub dl -t aquaman -d .
ezsub dl -t aquaman -d ./children/to/here
ezsub dl -t aquaman -d ../sibling/to/here

# absolute and relative path (unix)
ezsub dl -t aquaman -d /absolute/path/to/a/destination
ezsub dl -t aquaman -d ~/relative/path/to/home/directory

# absolute path (windows)
ezsub dl -t aquaman -d 'D:\Movies\Aquaman\'

Extract Previously Downloaded Subtitles

ezsub unzip -t|-T Title of Movie or TV Series -l LNG1 [LNG2 ...] -d DESTINATION -a|-A -o|-O -g|-G

switches are same as ezsub dl switches except there is no -s and -S. ezsub searches through "cache" folder. Rest is same as the download process.

More Details

Login

Since June 2019, subscene added google re-captcha. If user logs in, this captcha will not be required anymore.
At now (October 2019) it is easy to get a token even without user and password. Also persian mirrors such as 'hasti' and 'subf2m' do not require login.

Info

ezsub info
ezsub info -v {-t|-s|-n}

prints some useful information such as version and cache folder details.
With -v lists all downloaded titles with size and number of files sorted by title (-t). for sorting based on size (s) and number of files (n) use -s and -n.

Config

ezsub config show
ezsub config set OPTION VALUE

command to show or change default values.

More Details

ezsub config set Defaults.site hasti
# to reset to default
ezsub config set Defaults.languages -

Clean

ezsub clean -t|-T TITLE -l LNG1 [LNG2 ...] [-0] -a|-A
ezsub clean --all -l LNG1 [LNG2 ...] [-0] -a|-A

searches cache directory for given title and language. then:

  • with -0 or --zero it will replace each downloaded files with empty zip files.
  • without -0 it will delete downloaded files completely.

If you want to delete or empty all subtitles use --all switch.

Update

ezsub update

Check if there is a new version of ezsub available. If user confirms, new version will be installed.
Also if last check was before 7 days ago, at next call it warns user to check for update.

Backup

Create a zip archive from cache folder. It accepts -d option for destination and -o|-O for opening destination folder after backup is completed.

History

To check history of previously called ezsub command.

# show previous calls
ezsub history show
# or simply:
ezsub history

# select a previous call [its line number] to run again.
ezsub history run NUMBER

# short version
ezsub h show|run

Report Errors

ezsub logs some messages that could be found in ROOT/ezsub.log file.
If you getting error, you can run each ezsub command with --loglevel=Debug switch. Get ezsub.log content and create an issue here to report.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ezsub-2021.9.7.tar.gz (27.6 kB view details)

Uploaded Source

Built Distribution

ezsub-2021.9.7-py3-none-any.whl (30.9 kB view details)

Uploaded Python 3

File details

Details for the file ezsub-2021.9.7.tar.gz.

File metadata

  • Download URL: ezsub-2021.9.7.tar.gz
  • Upload date:
  • Size: 27.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.2

File hashes

Hashes for ezsub-2021.9.7.tar.gz
Algorithm Hash digest
SHA256 bf79ab7c733b4f51342fcbf6ff51d74542ddbbad3cd2d1750dd1e686512a8f5c
MD5 88c393cbaf70532da38063af2182394c
BLAKE2b-256 bb4da97aa3f08918a33befdc86556e1144af28d2e7ba7c85c9050ef1d678afd6

See more details on using hashes here.

File details

Details for the file ezsub-2021.9.7-py3-none-any.whl.

File metadata

  • Download URL: ezsub-2021.9.7-py3-none-any.whl
  • Upload date:
  • Size: 30.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.2

File hashes

Hashes for ezsub-2021.9.7-py3-none-any.whl
Algorithm Hash digest
SHA256 6de8e3702a2b067f8071cd5a7d04f545ba1efa6cc67c00bb277d3fbd03941355
MD5 9c5e547816c6af49c2f35c8b5419f87a
BLAKE2b-256 c89cb774da2ce8805cdfcdb39684313d31930a8870dafd91da8a1eadffe0d5f9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page