imdb-get(1) Looks up IMDB data for a film.


imdb-get [options] [--imdb-id id] [-l id] [--search search string] [-s search string] [--filename filename] [-f filename] [-h ] [--help]


This manual page documents briefly the imdb-get command.

imdb-get has three modes. It can be called with imdb ID and a set of details to print, in which case it will retrieve those details either from the cache or IMDB. Secondly, it can be called with a filename in which case it will look the file up in the cache (resolving symlinks as appropriate and checking for multiple disks from the same film) and if that fails it will use the filename to search IMDB. Alternatively it may be used with just a search string, which will always search IMDB.


These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-h --help
Print syntax and options.
-l --imdb-id
Specify IMDBID to use in queries.
-s --search
Specify search string to use in queries.
-f --filename
Specify filename. Will be used to form search queries if no ID or search string is specified.
-i --id
Print IMDB ID (default if nothing else is selected).
-t --title
Print film title.
-g --genre
Print film genres.
Print film tag line.
-y --year
Print film year.
-c --cover
Print cover art URI.
-m --print-filename
Print film genres.
-a --all
Print all film details.
-e --cachedir
Set cache directory.
-d --download-cover
Download cover art locally.
-r --refresh
Force an update from IMDB not the cache.
-n --rename
Rename file based on IMDB title.
-u --update-filename
Update the filename in a stored record
Removes cache files with duplicate filename entries. (Removes all but the most recently modified cache file)
Refresh all the details in the cache from IMDB (may be slow).


Config options are read from /etc/imdbgetrc or $HOME/.imdbgetrc


This manual page was written by Matthew Johnson <[email protected]>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 as published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-2.