Awesome Open Source
Awesome Open Source


Watch anything instantaneously, just write its name.

It searches a torrent for you and streams it using WebTorrent to your favorite app. It supports subtitles too.

Warning: If you don't know what a torrent is, or are unsure about the legality of the torrents you're downloading you shouldn't use cliflix.


$ npm install -g cliflix



Execute cliflix to run a wizard, it'll ask you everything it needs: a search query, which torrent to stream, and which app to use. If you want it may also search for subtitles for you.


I'm Feeling Lucky

If you're feeling lucky, just run something like this to automatically pick the first result:

cliflix Sintel


You can also directly pass any of the valid torrent identifiers supported by parse-torrent to stream it:

cliflix "magnet:?xt=urn:btih:08ada5a7a6183aae1e09d831df6748d566095a10&dn=Sintel&"

WebTorrent Options

You can pass arbitrary options to WebTorrent, read more about them here. Just write them after the special -- argument:

cliflix -- --iina --pip
cliflix -- --vlc --port 1234
cliflix Sintel -- --vlc --port 1234


You can customize cliflix to your likings via a ~/.cliflix.json file.

These are the settings available:

  "downloads": { // Downloads-related settings
    "path": "~/Downloads", // If saving them, put them here
    "save": true // Save the downloaded torrents or delete them upon exit
  "outputs": { // Apps-related settings
    "available": ["Airplay", "Chromecast", "DLNA", "MPlayer", "mpv", "VLC", "IINA", "XBMC"], // Apps to list when asking for the app
    "favorites": ["VLC"] // Favorite apps, they will be listed before the others
  "torrents": { // Torrents-related settings
    "limit": 30, // Number of torrents to show
    "details": { // Extra columns to show
      "seeders": true,
      "leechers": true,
      "size": true,
      "time": false
    "providers": { // Torrents providers-related settings
      "available": ["1337x", "ThePirateBay", "ExtraTorrent", "Rarbg", "Torrent9", "KickassTorrents", "TorrentProject", "Torrentz2"], // Providers to list if none is active
      "active": "1337x" // Active provider
  "subtitles": { // Subtitles-related settings
    "limit": 30, // Number of subtitles to show
    "details": { // Extra columns to show
      "downloads": true
    "languages": { // Languages-related settings
      "available": ["Afrikaans", "..."], // Languages to list when asking for the subtitles' language
      "favorites": ["English", "..."] // Favorite languages, they will be listed before the others
    "opensubtitles": { // OpenSubtitles-related settings
      "username": null, // Your OpenSubtitles username, required for increasing your IP quota
      "password": null, // Your OpenSubtitles password, required for increasing your IP quota
      "ssl": true
  "webtorrent": { // WebTorrent-related options
    "options": [ // Custom options to always pass to WebTorrent


MIT © Fabio Spampinato

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Typescript (265,979
Cli (131,578
Stream (20,981
Write (7,675
Torrent (3,206
Subtitles (2,714
Wizard (2,415
Webtorrent (296