Skip to main content

A script for renaming movies using the IMDb database

Project description


IMDbName is a console script that allows users to rename movie files intelligently using information from the IMDb database.


The recommended way to install IMDbName is with easy_install, as shown here (in a UNIX-like environment):

# easy_install imdbname

If easy_install is not available, IMDbName can also be installed using the file included in the distribution. Simply download the source distribution below, unarchive it, and run the setup script as follows:

# python install

Both options install both the IMDbName package in your Python site-packages directory, as well as the executable script (imdbname) in the setuptools script directory. In *nix systems, this is usually /usr/bin/.


Assuming the directory setuptools puts console scripts is part of your PATH, IMDbName can be run as follows:

$ imdbname [options] FILE1 [FILE2 FILE3 ...]

Where every FILE is a movie file to be renamed. The –help option shows all command line options, also listed here:

Prints the program’s version number and exits.
-h, --help
Prints the program’s usage, description, and command line options, then exits.
Prints the program’s license information and exits.
Prints extra helpful information during program execution.
-a, --assume-correct
If only one exact title match is found, assume it is the correct movie and don’t prompt the user to verify.
Allows the user to specify the format for the output filenames of the program, using the FORMATSTRING argument. See below for valid format specifiers [default: “%t (%y)”].
Format Specifiers
Conversion Meaning
%t Title (with ‘A’ or ‘The’ moved to the end)
%T Title (without any changes)
%y Year
%i Numerical IMDb id


0.1 (2010-01-03)

  • Initial release [jetheis]
  • All code conforms to PEP 8 standards [jetheis]

Project details

Release history Release notifications

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for IMDbName, version 0.1
Filename, size & hash File type Python version Upload date
IMDbName-0.1.tar.gz (21.4 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page