Skip to main content

CLI tool for downloading subtitles from

Project description

napi-py CI

CLI tool for downloading subtitles from, fork of gabrys/


  • Python 3.6 or newer


  • pip install napi-py for user-wide installation

usage as CLI tool

  • napi-py ~/Downloads/MyMovie.mp4 will download and save subtitles under ~/Downloads/

usage as lib

from napi import NapiPy

movie_path = "~/Downloads/MyMovie.mp4"

napi = NapiPy()
movie_hash = napi.calc_hash(movie_path)
source_encoding, target_encoding, tmp_file = napi.download_subs(movie_hash)
subs_path = napi.move_subs_to_movie(tmp_file, movie_path)

in case of issues

  • if there's issue with weird characters in downloaded subtitles, try to re-download and use flag --from-enc utf-8
  • if there's no subtitles for your movie, there's still hope:
    • open the movie web page on in your browser, as in example:,1,1-dla-55534-Z%C5%82odziejaszki-(2018)
    • choose subtitles that might match your movie, right-click them and select "Copy link" on link containing hash, which looks like this napiprojekt:96edd6537d9852a51cbdd5b64fee9194
    • use flag --hash YOURHASH in this tool, i.e. --hash 96edd6537d9852a51cbdd5b64fee9194 or --hash napiprojekt:96edd6537d9852a51cbdd5b64fee9194


  • make config installs venv under .venv/napi-py
  • make test runs tests
  • make build creates installable package

Project details

Download files

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

Files for napi-py, version 1.1.3
Filename, size File type Python version Upload date Hashes
Filename, size napi_py-1.1.3-py3-none-any.whl (19.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size napi-py-1.1.3.tar.gz (6.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page