Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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]
Release History

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
IMDbName-0.1.tar.gz (21.4 kB) Copy SHA256 Checksum SHA256 Source Jan 3, 2010

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting