Download Movies and Series subtitles via a intuitive node CLI.


Build bagde Total downloads Version


Search subtitles might be an easy task but also a boring one. So what if we can do that just using our favorite tool?

CLI Demo

GIF recorded using terminalizer!

Subtitles Provider

This CLI uses open-subtitles as provider. They have an API to help us (devs) to create apps on top of they resource.

It means whatever subtitle you can find in the website, you'll be able to find using this CLI!

Server API

Because their API is protected by user Token they provide you via requirement, I had to create a server (to hold my personal key) and to be a middleware for this CLI, which unfortunately is not open-source but hopefully soon I'll merge it into this repo.

Behind the scenes my server uses opensubtitles-api package which provides a very good abstraction for this XMLRPC API.

How use

Since it's a NodeJS CLI, you do need to have it installed.

For more info:

Also, I'd suggest you install it globally since the idea is to reuse more than once:

npm i -g sub-tv

Refresh your terminal section (or open another tab) and call the CLI:


A prompt will appears and ask you a bunch of questions (as you can see in the initial gif). When all questions got answered and the subtitles desired selected, they will be download in the same folder you call sub-tv CLI.


Having some problem? Please report via GH Issue :)


MIT License © Raul Melo

Sub Tv Cli

Downloading your series subtitles via terminal :tv:

Sub Tv Cli Info

⭐ Stars 65
🔗 Source Code
🕒 Last Update a year ago
🕒 Created 5 years ago
🐞 Open Issues 20
➗ Star-Issue Ratio 3
😎 Author sub-tv