IMDB-TOOLS(1)						      General Commands Manual						     IMDB-TOOLS(1)

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.   Alterna-
       tively 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 Matthew Johnson <debian@matthew.ath.cx>. Permission is granted to copy, distribute and/or modify this docu-
       ment 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.

																     IMDB-TOOLS(1)