This is MovieDB, a plugin for the Keypirinha launcher.
Search through TMDB (themoviedb.org) for movies, TV shows and people.
https://github.com/Fuhrmann/keypirinha-moviedb/releases/latest
@ueffel wrote PackageControl, a package manager that eases the install of third-party packages. It must be installed manually.
Once the MovieDB.keypirinha-package file is installed,
move it to the InstalledPackage folder located at:
Keypirinha\portable\Profile\InstalledPackagesin Portable mode- Or
%APPDATA%\Keypirinha\InstalledPackagesin Installed mode (the final path would look likeC:\Users\%USERNAME%\AppData\Roaming\Keypirinha\InstalledPackages)
There are three catalog items provided by this package, they are:
- Search movies
- Search TV shows
- Search people
Each catalog item is responsible for searching for its respective media type (movies, tv shows and people). Let's say you selected a movie (pressing TAB). Keypirinha will load the details from that media and present you in a form of suggestions:
There are some cases when you can navigate between movies/tv shows and people, e.g:
├── The Godfather (1972) -> your first selected item
├── 1972 -> select the year, to get all movies from 1972
│ ├── Search all movies from 1972
│ │ ├── ...
├── Al Pacino as Michael Corleone
│ ├── ...
├── James Caan as Santino Corleone
│ ├── ...
├── Marlon Brando as Don Vito Corleone -> select this actor, to get his info
│ ├── Born in 1924-04-03
│ ├── Apocalypse Now (1979)
│ ├── The Godfather (1972)
│ ├── On the Waterfront (1957) -> select this movie to get its info
│ │ ├── 1954
│ │ │ ├── Search all movies from 1972
│ │ │ │ ├── ...
│ │ ├── Marlon Brando as Terry Malloy
│ │ └── ...
- Select (press tab) the year from a movie info to search all movies from that year;
- Select (press tab) the director of a movie to open his info;
- Select (press tab) a movie that an actor/actress has participated in to see the info of the movie;
- Select (press tab) a actor/actress from the movie info to see his/her information;
Here it's a list of the default actions, how to trigger them and what they do:
| Suggestion item | Tab | Enter |
|---|---|---|
| Year | Filter all movies/tv shows from the year | Open TMDB website listing all movies/tv shows from the year |
| Trailer | - | Open the trailer in the browser |
| Person | Open person info | Open TMDB website with person info |
| Movie | Open movie info | Open TMDB website with movie info |
| Rating | - | Open related website |
| Load more | Go to the next page of results | - |
| Any other | - | Copy the text to clipboard |
# The key used to call TMDB API
# Get your own key at https://www.themoviedb.org/settings/api
# * Default already configured, you do not need to provide your own, unless you want it.
tmdb_api_key =
# The key used to call OMDB API
# Get your own key at http://www.omdbapi.com/apikey.aspx
# * Default already configured, you do not need to provide your own, unless you want it.
omdb_api_key =
# Number of seconds after cache (from API calls) will be expired.
# * Default: 86400 seconds (1 day)
cache_expire_after =
# Use an ISO 639-1 value to display translated data for the fields that support it.
# * Default: en-US
language =
*** If you are having problems with this plugin I recommend you to generate your own API keys. The TMDB API limits 40 requests every 10 seconds. OMDB API limits 1.000 requests every day.
When you select a catalog item, a list of search presets will be loaded, either for movies or tv shows:
- Popular (for movies and tv)
- Top Rated (for movies and tv)
Each one of this presets can be enabled/disabled, customized and you can even add your own!
To customize a default search preset, open the configuration file for MovieDB and add an entry to your configuration file as below:
# Here we're customizing the 'Popular' search preset in the Movies
[search_preset/PopularMovies]
label = Popular Movies
enabled = True # set False to completly disable this search
# Here we're disabling the 'Top Rated' search preset in TV Shows
[search_preset/TopRatedTVShows]
enabled = False
Here is the names of the search presets that already ships with this plugin:
- [search_preset/TopRatedMovies]
- [search_preset/PopularMovies]
- [search_preset/TopRatedTVShows]
- [search_preset/PopularTVShows]
You can always refer to the configuration file to check the names.
To create your own search presets open the configuration file for MovieDB and add an entry to your configuration file as the examples below:
[search_preset/PopularMoviesFrom2001]
label = Popular/2001
description = Get a list of popular movies from 2001
media_type = movie
search_args =
primary_release_year 2001
sort_by popularity.desc
enabled = True
[search_preset/BestDrama]
label = Best drama
description = Get a list of the best drama movies
media_type = movie
search_args =
with_genres drama
sort_by vote_average.desc
vote_count.gte 10
enabled = True
[search_preset/PopularCommedyShows1996]
label = Popular comedy/1996
description = Get a list of the most popular comedy shows from 1996
media_type = tv
search_args =
with_genres comedy
sort_by popularity.desc
first_air_date_year 1996
enabled = True
The complete list of available search_args can be found in the TMDB documentation.
If you're not a configuration expert to add your own presets there is another way to search! You can use the search box to perform some cool searches and get some cool results. The examples below can be used in both Movies and TV Shows catalog:
*** Note that it's not required for you to use 'and' between the queries. You can split the queries just by typing a whitespace between them: genre:action year:2001
genre:action and year:2001
genre:comedy and sort:vote_count.desc
genre:comedy and lang:ja
year:2001 and runtime:>100
genre:animation sort:popularity.desc
Here are the current possible queries:
| Query | Description | Example | Notes |
|---|---|---|---|
| genre: | Specify the genre names to search for movies/tv shows | genre:action,comedy | Values comma separated or single values. Note that the genres may differ from movies and tv shows You can check them here. |
| year: | Use it to search for the primary release year of movies or primary air year of tv shows | year:2012 | Only single values |
| lang: | Search movies/tv shows by their original language | lang:ja | Uses an ISO 639-1 string |
| sort: | Sort the results | sort:popularity.desc | Accepted values: popularity.asc, popularity.desc, release_date.asc, release_date.desc, revenue.asc, revenue.desc, primary_release_date.asc, primary_release_date.desc, original_title.asc, original_title.desc, vote_average.asc, vote_average.desc, vote_count.asc, vote_count.desc |
| votes: | Filter movies/tv shows by votes | votes:>100 | You always have to specify the greater-than sign (>) or The less-than sign (<) |
| runtime: | Filter movies/tv shows by runtime | runtime:<180 | You always have to specify the greater-than sign (>) or The less-than sign (<) |
action, adventure, animation, comedy, crime, documentary, drama, family, fantasy, history, horror, music, mystery, romance, sciencefiction, tvmovie, thriller, war, western
actionadventure, animation, comedy, crime, documentary, drama, family, kids, mystery, news, reality, scififantasy, soap, talk, warpolitics, western
- Make sure only the requests from this plugin are cached, do not affect others keypirinha's plugins.
- Released
This package is distributed under the terms of the MIT license.
- tmdbsimple
- omdb.py
- certifi
- idna
- requests
- requests-cache
- urllib3
- Icons by icons8