Skip to content
Media scoring CLI tool that queries OMDb, IMDB, Rotten Tomatoes and Mediacritic for media ranking
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


GitHub license GitHub release codebeat badge Go Report Card


Mediascore is a CLI tool to display rankings for TV series or movies from IMDB, Rotten Tomatoes and Metacritic in a simple table format so that you can easily decide what to watch next and if it is worth your time.

Program will accept one or more paths being given and will parse all media files in attempt to classify media title, year, season and episode information and query OMDb, IMDB, Rotten Tomatoes and Mediacritic searching for media information and rankings, eventually displaying separately the movie ranking table and the TV episode ranking table.



Using mediascore requires OMDb API key, obtainable here. Note that a free key is limited to 1,000 API calls per day, but all successful results are being cached. I strongly urge you to donate to Brian if you find OMDb useful.

Trying to score a large volume of media files could potentially lead to Rotten Tomatoes or Metacritic blacklisting your IP, so use wisely.

Media parsing information from the filename is being done by parse-torrent-name Go library which is not without issues, so make sure to have Kodi-compatible file naming if possible.

Rotten Tomatoes and Mediacritic scraping is simply horribly done, I know.



Download your preferred flavor from the releases page and install manually.

Using go get

go get


Usage: mediascore [-ch] [parameters ...]
 -c, --clean  clean cache before scoring media
 -h, --help   display help

Typical use case is to invoke mediascore on one or more media (for instance ones exported through SMB to Kodi or Plex) network/local folders like below:

OMDB_API_KEY=XXX ./mediascore "/Volumes/XBMC/TV Shows"

We are exporting OMDb API key as environment variable OMDB_API_KEY and using mediascore to parse locally mounted XMBC volume. Environment variable OMDB_API_KEY can also be permanently set and exported in your shell profile/configuration files for future use.

When unsure what is mediascore doing, you can also set DEBUG=1 environment variable for a bit more verbosity.

Bugs, feature requests, etc.

Please open a PR or report an issue. Thanks!

You can’t perform that action at this time.