Skip to main content

Rotten Tomatoes Command Line Tool

Project description

Rotten Tomatoes CLI

Build Status PyPI version codecov

Introduction

  • Search for movies and tv shows on Rotten Tomatoes from the command line
  • Browse movies in theaters or on various streaming platforms like Netflix and Amazon Prime

Install

pip install rotten_tomatoes_cli

Search

rotten search {term}

Harry Potter Example

rotten search "Harry Potter"

alt-text

Master of None Example

rotten search "Master of None"

alt-text

TV

rotten tv {category}

Category Argument

  • new (default)
  • popular
  • fresh

Browse Popular TV Shows Example

rotten tv popular

alt-text

Movies

Options:

  • --minimum_rating / -l
    • Minimum allowable Rotten Tomatoes score
    • Default: 70
  • --maximum_rating / -h
    • Maximum allowable Rotten Tomatoes score
    • Default: 100
  • --certified_fresh / -f
    • Boolean flag that represents whether or not to only show "Certified Fresh" movies
    • Default: True
  • --service / -s
    • Filter by specified streaming services
    • Default: All services
    • Can specify multiple services
    • Values:
      • amazon
      • prime
      • hbo
      • itunes
      • netflix
      • vudu
      • fandango
  • --genre / -g
    • Filter by specified genres
    • Default: All genres
    • Can specify multiple genres
    • Values:
      • action
      • animation
      • art_and_foreign
      • classics
      • comedy
      • documentary
      • drama
      • horror
      • family
      • mystery
      • romance
      • scifi
  • --sort_by
    • Sort results by specified value
    • Default: popularity
    • Values:
      • popularity
      • release

Streaming

rotten movies streaming {category}

Category Argument

  • new (default)
  • all
  • top
  • upcoming
  • fresh

Upcoming movies on Netflix or Amazon Prime with a minimum rating of 90

rotten movies streaming upcoming -l 90 -s netflix -s prime

alt-text

Theaters

rotten movies theaters {category}

Category Argument

  • opening (default)
  • playing
  • upcoming
  • fresh

Action movies in theaters with a minimum rating of 90

rotten movies theaters playing -l 90 -g action

alt-text

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rotten_tomatoes_cli-0.0.3.tar.gz (7.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page