Skip to main content

Command line utility to search for TV and movie torrents and stream using Peerflix automatically.

Project description

Command line utility that allows you to search for TV and movie torrents and stream using Peerflix automatically.


ezflix is available on the Python Package Index (PyPI) at

You can ezflix using pip.

pip install ezflix

This program requires Peerflix. You can install Peerflix via NPM.

npm install -g peerflix

Supported Media Players

Below is a list of media players supported in Peerflix.

  • mpv
  • airplay
  • vlc
  • mplayer
  • smplayer
  • mpchc
  • potplayer
  • webplay
  • omx

In ezflix, the default player is mpv. It will fallback to vlc if mpv isn’t found.

You can use the media_player argument to set your media player.


usage: ezflix [-h] [--limit [LIMIT]] [--minimum_rating [MINIMUM_RATING]]
              [--media_player [{mpv,vlc,mplayer,smplayer,mpchc,potplayer,webplay,omx,airplay}]]
              [--latest] [--subtitles]
              [--sort_by [{download_count,like_count,date_added,seeds,peers,rating,title,year}]]
              [--sort_order [{asc,desc}]] [--quality [{720p,1080p,3d}]]
              [--genre GENRE] [--remove]
              [{movie,tv}] query

positional arguments:
  {movie,tv}            The media type.
  query                 The search query.

optional arguments:
  -h, --help            show this help message and exit
  --limit [LIMIT]       The number of results to return.
  --minimum_rating [MINIMUM_RATING]
                        Used to filter movie by a given minimum IMDb rating
  --media_player [{mpv,vlc,mplayer,smplayer,mpchc,potplayer,webplay,omx,airplay}]
                        The media player.
  --latest              Play the latest TV episode.
  --subtitles           Load subtitles file.
  --sort_by [{download_count,like_count,date_added,seeds,peers,rating,title,year}]
                        Use this argument to sort the torrents.
  --sort_order [{asc,desc}]
                        Use this argument to set the sort order.
  --quality [{720p,1080p,3d}]
                        Use this argument to set the min quality.
  --genre GENRE         Used to filter by a given genre (See
               for full list)
  --remove              Remove files on exit.


ezflix "The Man in the High Castle"

Pass ‘–latest’ to watch the latest episode of a given TV series.

ezflix "South Park" --latest

To search for movies, pass the ‘movie’ argument.

ezflix movie "Mad Max"

Search for movies released in 2017 and order by like count descending.

ezflix movie '2017' --sort_by=like_count --sort_order=desc

Search for thrillers released in 2017 and order by download count descending.

ezflix movie '2017' --sort_by=download_count --sort_order=desc --genre=thriller

Run development version

Before any new changes are pushed to PyPi, you can clone the development version to avail of any new features.

git clone
cd ezflix
virtualenv env
source env/bin/activate
pip install -r requirements.txt
python install


  • Fork the project and clone locally.
  • Create a new branch for what you’re going to work on.
  • Push to your origin repository.
  • Create a new pull request in GitHub.

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 ezflix, version 1.0.7
Filename, size File type Python version Upload date Hashes
Filename, size ezflix-1.0.7-py2.py3-none-any.whl (10.1 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size ezflix-1.0.7.tar.gz (5.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page