https://github.com/jaebradley/rotten_tomatoes_cli

Rotten Tomatoes CLI
https://github.com/jaebradley/rotten_tomatoes_cli

cli command-line command-line-tool pip python rotten-tomatoes rottentomatoes

Last synced: about 2 months ago
JSON representation

Rotten Tomatoes CLI

• Host: GitHub
• URL: https://github.com/jaebradley/rotten_tomatoes_cli
• Owner: jaebradley
• License: mit
• Created: 2017-05-27T18:08:18.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-07T23:57:12.000Z (about 2 years ago)
• Last Synced: 2024-10-31T06:48:55.753Z (2 months ago)
• Topics: cli, command-line, command-line-tool, pip, python, rotten-tomatoes, rottentomatoes
• Language: Python
• Homepage: https://pypi.org/project/rotten_tomatoes_cli/
• Size: 68.4 KB
• Stars: 14
• Watchers: 3
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Rotten Tomatoes CLI

[![Build Status](https://travis-ci.org/jaebradley/rotten_tomatoes_cli.svg?branch=master)](https://travis-ci.org/jaebradley/rotten_tomatoes_cli)

[![PyPI version](https://badge.fury.io/py/rotten_tomatoes_cli.svg)](https://badge.fury.io/py/rotten_tomatoes_cli)

[![codecov](https://codecov.io/gh/jaebradley/rotten_tomatoes_cli/branch/master/graph/badge.svg)](https://codecov.io/gh/jaebradley/rotten_tomatoes_cli)

* [Introduction](https://github.com/jaebradley/rotten_tomatoes_cli#introduction)

* [Install](https://github.com/jaebradley/rotten_tomatoes_cli#install)

* [Search](https://github.com/jaebradley/rotten_tomatoes_cli#search)

  * [Harry Potter Example](https://github.com/jaebradley/rotten_tomatoes_cli#harry-potter-example)

  * [Master of None Example](https://github.com/jaebradley/rotten_tomatoes_cli#master-of-none-example)

* [TV](https://github.com/jaebradley/rotten_tomatoes_cli#tv)

  * [Browse Popular TV Shows Example](https://github.com/jaebradley/rotten_tomatoes_cli#browse-popular-tv-shows-example)

* [Movies](https://github.com/jaebradley/rotten_tomatoes_cli#movies)

  * [Streaming](https://github.com/jaebradley/rotten_tomatoes_cli#streaming)

    * [Upcoming movies on Netflix or Amazon Prime with a minimum rating of 90](https://github.com/jaebradley/rotten_tomatoes_cli#upcoming-movies-on-netflix-or-amazon-prime-with-a-minimum-rating-of-90)

  * [Theaters](https://github.com/jaebradley/rotten_tomatoes_cli#theaters)

    * [Action movies in theaters with a minimum rating of 90](https://github.com/jaebradley/rotten_tomatoes_cli#action-movies-in-theaters-with-a-minimum-rating-of-90)

## 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](http://imgur.com/MNAwVxI.png)

### Master of None Example

`rotten search "Master of None"`

![alt-text](http://imgur.com/FNPejbR.png)

## TV

`rotten tv {category}`

Category Argument

* `new` (default)

* `popular`

* `fresh`

### Browse Popular TV Shows Example

`rotten tv popular`

![alt-text](http://imgur.com/3PYkLuz.png)

## 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](http://imgur.com/7aP33au.png)

### 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](http://imgur.com/vU54rQr.png)