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 details)

Uploaded Source

File details

Details for the file rotten_tomatoes_cli-0.0.3.tar.gz.

File metadata

  • Download URL: rotten_tomatoes_cli-0.0.3.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.0 setuptools/40.5.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.2

File hashes

Hashes for rotten_tomatoes_cli-0.0.3.tar.gz
Algorithm Hash digest
SHA256 f576cb05888a27481dc1ac8790b7a2bbc06228d29d4f26a67c00e7778e396199
MD5 a4d1f906070790551b45e3fd640ebf6b
BLAKE2b-256 b5c92fa1b19276c56ae706b2dea8fab545dfd97b6c0c6cf1a7af27aa998f5b47

See more details on using hashes here.

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