&dhucpackage; &dhsection;

&dhpackage;

Looks up IMDB data for a film.

          &dhpackage;
             options
             --imdb-id id
             -l id
             --search search string
             -s search string
             --filename filename
             -f filename
             -h
             --help

## DESCRIPTION

This manual page documents briefly the `&dhpackage;` command.

`&dhpackage;` 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.

## OPTIONS

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.

`--tag`

- 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

`--prune-duplicates`

- Removes cache files with duplicate filename entries. (Removes all but the most recently modified cache file)

`--refresh-cache`

- Refresh all the details in the cache from IMDB (may be slow).

## FILES

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

## SEE ALSO

imdb(1) imdb-rename(1) imdb-link(1) imdb-update-cache(1) imdbgetrc(5) imdb-fxd(1)

## AUTHOR

This manual page was written by &dhusername; &dhemail;. 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.