Repository files navigation

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 queryOMDb,IMDB,Rotten Tomatoes andMediacritic searching for media information and rankings, eventually displaying separately the movie ranking table and the TV episode ranking table.

Usingmediascore requiresOMDb API key, obtainablehere. 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 byparse-torrent-name Go library which is not without issues, so make sure to haveKodi-compatible file naming if possible.

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

Download your preferred flavor fromthe releases page and install manually.

go get https://github.com/dkorunic/mediascore

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

Typical use case is to invokemediascore 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 variableOMDB_API_KEY and using mediascore to parse locally mounted XMBC volume. Environment variableOMDB_API_KEY can also be permanently set and exported in your shell profile/configuration files for future use.

When unsure what ismediascore doing, you can also setDEBUG=1 environment variable for a bit more verbosity.

Please open a PR or report an issue. Thanks!