{"id":20333075,"url":"https://github.com/jaebradley/rotten_tomatoes_cli","last_synced_at":"2025-04-11T21:33:08.521Z","repository":{"id":57462755,"uuid":"92615694","full_name":"jaebradley/rotten_tomatoes_cli","owner":"jaebradley","description":"Rotten Tomatoes CLI","archived":false,"fork":false,"pushed_at":"2022-12-07T23:57:12.000Z","size":70,"stargazers_count":14,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-25T17:46:50.343Z","etag":null,"topics":["cli","command-line","command-line-tool","pip","python","rotten-tomatoes","rottentomatoes"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/rotten_tomatoes_cli/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jaebradley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-27T18:08:18.000Z","updated_at":"2024-07-06T05:49:42.000Z","dependencies_parsed_at":"2023-01-25T01:15:18.498Z","dependency_job_id":null,"html_url":"https://github.com/jaebradley/rotten_tomatoes_cli","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaebradley%2Frotten_tomatoes_cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaebradley%2Frotten_tomatoes_cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaebradley%2Frotten_tomatoes_cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaebradley%2Frotten_tomatoes_cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jaebradley","download_url":"https://codeload.github.com/jaebradley/rotten_tomatoes_cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248483373,"owners_count":21111435,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","command-line-tool","pip","python","rotten-tomatoes","rottentomatoes"],"created_at":"2024-11-14T20:29:15.014Z","updated_at":"2025-04-11T21:33:08.499Z","avatar_url":"https://github.com/jaebradley.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rotten Tomatoes CLI\n\n[![Build Status](https://travis-ci.org/jaebradley/rotten_tomatoes_cli.svg?branch=master)](https://travis-ci.org/jaebradley/rotten_tomatoes_cli)\n[![PyPI version](https://badge.fury.io/py/rotten_tomatoes_cli.svg)](https://badge.fury.io/py/rotten_tomatoes_cli)\n[![codecov](https://codecov.io/gh/jaebradley/rotten_tomatoes_cli/branch/master/graph/badge.svg)](https://codecov.io/gh/jaebradley/rotten_tomatoes_cli)\n\n* [Introduction](https://github.com/jaebradley/rotten_tomatoes_cli#introduction)\n* [Install](https://github.com/jaebradley/rotten_tomatoes_cli#install)\n* [Search](https://github.com/jaebradley/rotten_tomatoes_cli#search)\n  * [Harry Potter Example](https://github.com/jaebradley/rotten_tomatoes_cli#harry-potter-example)\n  * [Master of None Example](https://github.com/jaebradley/rotten_tomatoes_cli#master-of-none-example)\n* [TV](https://github.com/jaebradley/rotten_tomatoes_cli#tv)\n  * [Browse Popular TV Shows Example](https://github.com/jaebradley/rotten_tomatoes_cli#browse-popular-tv-shows-example)\n* [Movies](https://github.com/jaebradley/rotten_tomatoes_cli#movies)\n  * [Streaming](https://github.com/jaebradley/rotten_tomatoes_cli#streaming)\n    * [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)\n  * [Theaters](https://github.com/jaebradley/rotten_tomatoes_cli#theaters)\n    * [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)\n\n## Introduction\n\n* Search for movies and tv shows on Rotten Tomatoes from the command line\n* Browse movies in theaters or on various streaming platforms like Netflix and Amazon Prime\n\n## Install\n`pip install rotten_tomatoes_cli`\n\n## Search\n\n`rotten search {term}`\n\n### Harry Potter Example\n\n`rotten search \"Harry Potter\"`\n\n![alt-text](http://imgur.com/MNAwVxI.png)\n\n### Master of None Example\n\n`rotten search \"Master of None\"`\n\n![alt-text](http://imgur.com/FNPejbR.png)\n\n## TV\n\n`rotten tv {category}`\n\nCategory Argument\n* `new` (default)\n* `popular`\n* `fresh`\n\n### Browse Popular TV Shows Example\n\n`rotten tv popular`\n\n![alt-text](http://imgur.com/3PYkLuz.png)\n\n## Movies\n\nOptions:\n* `--minimum_rating` / `-l`\n  * Minimum allowable Rotten Tomatoes score\n  * Default: `70`\n* `--maximum_rating` / `-h`\n  * Maximum allowable Rotten Tomatoes score\n  * Default: `100`\n* `--certified_fresh` / `-f`\n  * Boolean flag that represents whether or not to only show \"Certified Fresh\" movies\n  * Default: `True`\n* `--service` / `-s`\n  * Filter by specified streaming services\n  * Default: All services\n  * Can specify multiple services\n  * Values:\n    * `amazon`\n    * `prime`\n    * `hbo`\n    * `itunes`\n    * `netflix`\n    * `vudu`\n    * `fandango`\n* `--genre` / `-g`\n  * Filter by specified genres\n  * Default: All genres\n  * Can specify multiple genres\n  * Values:\n    * `action`\n    * `animation`\n    * `art_and_foreign`\n    * `classics`\n    * `comedy`\n    * `documentary`\n    * `drama`\n    * `horror`\n    * `family`\n    * `mystery`\n    * `romance`\n    * `scifi`\n* `--sort_by`\n  * Sort results by specified value\n  * Default: `popularity`\n  * Values:\n    * `popularity`\n    * `release`\n\n\n### Streaming\n\n`rotten movies streaming {category}`\n\nCategory Argument\n* `new` (default)\n* `all`\n* `top`\n* `upcoming`\n* `fresh`\n\n#### Upcoming movies on Netflix or Amazon Prime with a minimum rating of 90\n\n`rotten movies streaming upcoming -l 90 -s netflix -s prime`\n\n![alt-text](http://imgur.com/7aP33au.png)\n\n### Theaters\n\n`rotten movies theaters {category}`\n\nCategory Argument\n* `opening` (default)\n* `playing`\n* `upcoming`\n* `fresh`\n\n#### Action movies in theaters with a minimum rating of 90\n\n`rotten movies theaters playing -l 90 -g action`\n\n![alt-text](http://imgur.com/vU54rQr.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaebradley%2Frotten_tomatoes_cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaebradley%2Frotten_tomatoes_cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaebradley%2Frotten_tomatoes_cli/lists"}