---
name: "imdb-get"
section: "1"
platform: "linux"
package: "imdb-tools"
version: "0.9-1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/imdb-get"
---

# imdb-get(1)

Looks up IMDB data for a film.

## NAME

imdb-get — Looks up IMDB data for a film.

## SYNOPSIS

**imdb-get** \[**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*  **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.

## 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/1.md) [imdb-rename(1)](/imdb-rename/1.md) [imdb-link(1)](/imdb-link/1.md) [imdb-update-cache(1)](/imdb-update-cache/1.md) [imdbgetrc(5)](/imdbgetrc/5.md) [imdb-fxd(1)](/imdb-fxd/1.md)

## AUTHOR

This manual page was written by Matthew Johnson \<debian@matthew.ath.cx\>. 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.