cinemagoer 2026.8.20

Main features

• written in Python 3

• platform-independent

• simple and complete API

• released under the terms of the GPL 2 license

Cinemagoer powers many other software and has been used in various research papers. Curious about that?

Installation

Whenever possible, please use the latest version from the repository:

pip install git+https://github.com/cinemagoer/cinemagoer

But if you want, you can also install the latest release from PyPI:

pip install cinemagoer

This base installation includes native SQLite support. To use PostgreSQL, MariaDB, MySQL, or an explicitly selected SQLAlchemy dialect, install the optional integration and your chosen database driver:

pip install "cinemagoer[sqlalchemy]"

Example

Here’s an example that demonstrates how to use Cinemagoer:

s32cinemagoer.py /path/to/imdb-tsv-files/ sqlite:///cinemagoer.db

from imdb import Cinemagoer

 # Open the SQLite database populated with s32cinemagoer.py.
 ia = Cinemagoer('s3', uri='sqlite:///cinemagoer.db')

# get a movie
movie = ia.get_movie('0133093')

# print the names of the directors of the movie
print('Directors:')
for director in movie['directors']:
    print(director['name'])

# print the genres of the movie
print('Genres:')
for genre in movie['genres']:
    print(genre)

# search for a person name
people = ia.search_person('Mel Gibson')
for person in people:
   print(person.personID, person['name'])

Getting help

Please refer to the support page on the project homepage and to the the online documentation on Read The Docs.

The sources are available on GitHub.

Contribute

Visit the CONTRIBUTOR_GUIDE.rst to learn how you can contribute to the Cinemagoer package.

License

Copyright (C) 2004-2026 Davide Alberani <da@mimante.net> et al.

Cinemagoer is released under the GPL license, version 2 or later. Read the included LICENSE.txt file for details.

NOTE: For a list of persons who share the copyright over specific portions of code, see the CONTRIBUTORS.txt file.

NOTE: See also the recommendations in the DISCLAIMER.txt file.