CinemagoerNG

CinemagoerNG is a Python library and command-line utility for retrieving data from IMDb. It provides a clean, modern API for accessing movie, TV show, and celebrity information from IMDb.

[!Note] This project and its authors are not affiliated with the Internet Movie Database Inc. See the DISCLAIMER.txt file for details about terms of use.

Features

• Retrieve comprehensive movie and TV show information.
• Support for alternate titles (AKAs).
• Taglines and parental guide information.
• Episode data for TV series.
• Modern Python typing support.
• Clean, intuitive API.

Installation

CinemagoerNG supports Python 3.11 and later versions. You can install it using pip:

pip install cinemagoerng

Basic usage

Here's a simple example of retrieving movie information:

from cinemagoerng import web as imdb

# Get basic movie information
movie = imdb.get_title("tt0133093")  # The Matrix
print(movie.title)       # "The Matrix"
print(movie.sort_title)  # "Matrix"
print(movie.year)        # 1999
print(movie.runtime)     # 136

# Access movie genres
for genre in movie.genres:
    print(genre)         # "Action", "Sci-Fi"

# Get director information
for credit in movie.directors:
    print(credit.name)   # "Lana Wachowski", "Lilly Wachowski"

Retrieving additional information

You can fetch additional details using the relevant set_ functions:

# Set all taglines
imdb.set_taglines(movie)
for tagline in movie.taglines:
    print(tagline)

# Get alternate titles (AKAs)
imdb.set_akas(movie)
for aka in movie.akas:
    print(f"{aka.title} ({aka.country})")

Available data

CinemagoerNG can retrieve various types of information:

Basic information

• Title
• Year
• Runtime
• Genres
• Plot summary
• Rating
• Number of votes

Credits

• Directors
• Writers
• Cast members
• Producers
• Composers
• Crew members

Additional details

• Taglines
• Alternative titles (AKAs)
• Episode information (for TV series)
• Parental guide

Development

It is recommended to use uv for development:

# Clone the repository
git clone https://github.com/cinemagoer/cinemagoerng.git
cd cinemagoerng

# Set up environment
uv sync

# Run tests
uv run pytest

# Run type checks
uv run mypy src tests

# Check code style
uv run ruff check --preview src tests

# Test under all supported Python versions
uv run tox

License

This project is licensed under the GNU Lesser General Public License v3 or later - see the LICENSE.txt file for details.

Acknowledgments

CinemagoerNG is a modern reimagining of the original Cinemagoer/IMDbPY project. Special thanks to:

• All contributors to the original Cinemagoer (IMDbPY) project.
• The IMDb website for providing the data.