Awesome Open Source
Awesome Open Source


Bash script to watch movies and TV shows on Mac OS X and Linux, with subtitles, instantaneously. Just give the name, quickly grab your popcorn and have fun!

How to use?

Once installed:

  1. Open terminal (⌘+space, then type terminal, or ctrl+alt+t);
  2. Type bashflix "movie / serie sXXeYY" subtitles in the terminal and press ENTER;
  3. Wait a few seconds for the player to open.


bashflix "jumanji next level"
bashflix "westworld s03e01 720p" pt


  • Stuck? ctrl+c and change the search query;
  • Subtitles not synced? Use h to speed it up or g to delay it;
  • Stopping? space to PAUSE, wait a few minutes and space to PLAY;
  • What did I watch? bashflix -h to see which episode to watch next.

How to install?

  1. Open terminal (⌘+space, then type terminal, or ctrl+alt+t);
  2. Copy & Paste the following command into the terminal and press ENTER:
bash <(curl
  1. Input your system password and press ENTER (sudo required);
  2. Wait a few minutes until it finishes;
  3. (Optional) Change DNS to (this might prevent torrent search failures).

How it works?

It uses pirate-get for torrent search, peerflix and vlc for torrent streaming and playing, and subliminal for subtitles.


bashflix is under development. If you want the newer features or bugs fixed, just reinstall it from time to time. Best efford approch is used. Most of the times bashflix will work. Random errors will occur. Unavailability issues will occur. Some torrents and subtitles will not be found.

Downloading files via torrents might be illegal, depending on the content, so be aware of copyright infringements. Use a VPN for privacy.


This project is licensed under the terms of the MIT license.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
shell (9,858
linux (2,336
macos (1,659
bash (595
streaming (282
movies (62
series (42
torrents (16

Find Open Source By Browsing 7,000 Topics Across 59 Categories