CLI tool to fetch movie/TV data for a single item from TMDB and output to stdout in either JSON or YAML.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
.rubocop.yml
Gemfile
Gemfile.lock
LICENSE
README.md
logo.png
tmdbget.rb

README.md

tmdbget

CLI tool to fetch movie/TV data for a single item from TMDb and output to STDOUT in either JSON or YAML.

Usage

The minimal example to get a result for a movie search:

ruby tmdbget.rb --apikey [TMDB APIKEY] 'The Terminator'

Would yield the result:

{
  "The Terminator": {
    "vote_count": 5259,
    "id": 218,
    "video": false,
    "vote_average": 7.4,
    "title": "The Terminator",
		[...]
    "overview": "In the post-apocalyptic future, reigning tyrannical supercomputers teleport a cyborg assassin known as the \"Terminator\" back to 1984 to kill Sarah Connor, whose unborn son is destined to lead insurgents against 21st century mechanical hegemony. Meanwhile, the human-resistance movement dispatches a lone warrior to safeguard Sarah. Can he stop the virtually indestructible killing machine?",
    "release_date": "1984-10-26",
    "release_year": "1984"
  }
}

It is also possible to specify a year to narrow search, enable an interactive prompt (on STDERR, to not interfere with output redirection) for iffy titles, disable JSON pretty-print, or just go straight to YAML for readability. Just check the help output:

./tmdbget.rb -h
Fetch movie/TV data for a single item from TMDB and output to STDOUT in either JSON or YAML.
Usage: tmdbget.rb [options] <title>
    -h, --h                          Display this help output
    -y, --year YEAR                  Year of release. This may do nothing for TV search.
        --yaml                       Output in YAML for easier human-reading.
    -a, --append x,y,z               Additional requests from within the same namespace (like credits, images, recommendations) to deliver along with the results. 
See [https://developers.themoviedb.org/3/tv] and [https://developers.themoviedb.org/3/movies for a detailed list of options, or just specify "all".
    -k, --key KEY                    TMDB API key or the path to a file containing such a key.
    -i, --interactive                Enable in order to present search results for selection on STDERR, eventually printing the final selection to STDOUT.
    -m, --maxshow MAXSHOW            Limit search results. By default, returns all.
        --nopretty                   Disable pretty-printing of JSON output.
    -t, --tv                         Search TV instead of Movies.

Installation

Requirements

In general

From the Gemfile

Install

git clone https://github.com/decipher-media/tmdbget.git
cd tmdbget
bundle install

Testing

One day...?

Contributing

Taking pull requests at https://github.com/decipher-media/tmdbget.git

Credits

By Christopher Peterson: website | twitter

for Decipher Media: website | github

License

Copyright (c) Christopher Peterson. License.