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
  • on Linux, python3-dev package:
    • for Debian-based systems, use sudo apt-get install python3-dev


  • 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 are no subs 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.4
Filename, size File type Python version Upload date Hashes
Filename, size napi_py-1.1.4-py3-none-any.whl (19.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size napi-py-1.1.4.tar.gz (5.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page