# CinemagoerNG
CinemagoerNG (Next Generation) 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`](https://raw.githubusercontent.com/cinemagoer/cinemagoerng/main/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
You can install CinemagoerNG using pip:
```bash
# Basic installation
pip install cinemagoerng
# For development
pip install cinemagoerng[dev]
```
## Basic Usage
Here's a simple example of retrieving movie information:
```python
from cinemagoerng import web
# Get basic movie information
movie = web.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 `update_title` method:
```python
# Get all taglines
web.update_title(movie, page="taglines", keys=["taglines"])
for tagline in movie.taglines:
print(tagline)
# Get alternate titles (AKAs)
web.update_title(movie, page="akas", keys=["akas"])
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
### Additional Details
- Taglines
- Alternative titles (AKAs)
- Episode information (for TV series)
- Parental guide
- Reference information
## Development
To set up for development:
```bash
# Clone the repository
git clone https://github.com/cinemagoer/cinemagoerng.git
cd cinemagoerng
# Install development dependencies
pip install -e .[dev]
# Run tests
pytest
# Run type checks
mypy cinemagoerng
# Check code style
ruff check --preview cinemagoerng tests
# Format code
ruff format cinemagoerng tests
```
## Python Version Support
CinemagoerNG supports Python 3.10 and later versions, including:
- Python 3.10
- Python 3.11
- Python 3.12
- Python 3.13
- PyPy 3.10
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
For major changes, please open an issue first to discuss what you would like
to change.
## License
This project is licensed under the
GNU General Public License v3 or later (GPLv3+) - see the
[LICENSE.txt](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.
- The Python community for their invaluable feedback and contributions.
Raw data
{
"_id": null,
"home_page": null,
"name": "cinemagoerng",
"maintainer": null,
"docs_url": null,
"requires_python": "~=3.10",
"maintainer_email": null,
"keywords": "imdb, cinema, movie, film, cast, actor, director",
"author": "H. Turgut Uyar, Davide Alberani",
"author_email": "H. Turgut Uyar <uyar@tekir.org>, Davide Alberani <da@mimante.net>",
"download_url": "https://files.pythonhosted.org/packages/18/0c/ea6037fe73d3268d21a8cba3391051d68898e544b47d2a01dd9ca27489a9/cinemagoerng-0.4.tar.gz",
"platform": null,
"description": "# CinemagoerNG\n\nCinemagoerNG (Next Generation) is a Python library and command-line utility\nfor retrieving data from IMDb.\nIt provides a clean, modern API for accessing movie, TV show,\nand celebrity information from IMDb.\n\n> [!Note]\n> This project and its authors are not affiliated\n| with the Internet Movie Database Inc.\n> See the [`DISCLAIMER.txt`](https://raw.githubusercontent.com/cinemagoer/cinemagoerng/main/DISCLAIMER.txt)\n> file for details about terms of use.\n\n## Features\n\n- Retrieve comprehensive movie and TV show information.\n- Support for alternate titles (AKAs).\n- Taglines and parental guide information.\n- Episode data for TV series.\n- Modern Python typing support.\n- Clean, intuitive API.\n\n## Installation\n\nYou can install CinemagoerNG using pip:\n\n```bash\n# Basic installation\npip install cinemagoerng\n\n# For development\npip install cinemagoerng[dev]\n```\n\n## Basic Usage\n\nHere's a simple example of retrieving movie information:\n\n```python\nfrom cinemagoerng import web\n\n# Get basic movie information\nmovie = web.get_title(\"tt0133093\") # The Matrix\nprint(movie.title) # \"The Matrix\"\nprint(movie.sort_title) # \"Matrix\"\nprint(movie.year) # 1999\nprint(movie.runtime) # 136\n\n# Access movie genres\nfor genre in movie.genres:\n print(genre) # \"Action\", \"Sci-Fi\"\n\n# Get director information\nfor credit in movie.directors:\n print(credit.name) # \"Lana Wachowski\", \"Lilly Wachowski\"\n```\n\n### Retrieving Additional Information\n\nYou can fetch additional details using the `update_title` method:\n\n```python\n# Get all taglines\nweb.update_title(movie, page=\"taglines\", keys=[\"taglines\"])\nfor tagline in movie.taglines:\n print(tagline)\n\n# Get alternate titles (AKAs)\nweb.update_title(movie, page=\"akas\", keys=[\"akas\"])\nfor aka in movie.akas:\n print(f\"{aka.title} ({aka.country})\")\n```\n\n## Available Data\n\nCinemagoerNG can retrieve various types of information:\n\n### Basic Information\n\n- Title\n- Year\n- Runtime\n- Genres\n- Plot summary\n- Rating\n- Number of votes\n\n### Credits\n\n- Directors\n- Writers\n- Cast members\n- Producers\n- Composers\n\n### Additional Details\n\n- Taglines\n- Alternative titles (AKAs)\n- Episode information (for TV series)\n- Parental guide\n- Reference information\n\n## Development\n\nTo set up for development:\n\n```bash\n# Clone the repository\ngit clone https://github.com/cinemagoer/cinemagoerng.git\ncd cinemagoerng\n\n# Install development dependencies\npip install -e .[dev]\n\n# Run tests\npytest\n\n# Run type checks\nmypy cinemagoerng\n\n# Check code style\nruff check --preview cinemagoerng tests\n\n# Format code\nruff format cinemagoerng tests\n```\n\n## Python Version Support\n\nCinemagoerNG supports Python 3.10 and later versions, including:\n\n- Python 3.10\n- Python 3.11\n- Python 3.12\n- Python 3.13\n- PyPy 3.10\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\nFor major changes, please open an issue first to discuss what you would like\nto change.\n\n## License\n\nThis project is licensed under the\nGNU General Public License v3 or later (GPLv3+) - see the\n[LICENSE.txt](LICENSE.txt) file for details.\n\n## Acknowledgments\n\nCinemagoerNG is a modern reimagining of the original Cinemagoer/IMDbPY project.\nSpecial thanks to:\n\n- All contributors to the original Cinemagoer (IMDbPY) project.\n- The IMDb website for providing the data.\n- The Python community for their invaluable feedback and contributions.\n",
"bugtrack_url": null,
"license": null,
"summary": "Retrieve data from the IMDb.",
"version": "0.4",
"project_urls": {
"repository": "https://github.com/cinemagoer/cinemagoerng"
},
"split_keywords": [
"imdb",
" cinema",
" movie",
" film",
" cast",
" actor",
" director"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "eba79f47ed6b822a500a9d6de87f4083fb28450e6b1c6a35f15fc6d159b1573d",
"md5": "e52ea4ff4f213d8ee48caf8f7d29977e",
"sha256": "cbcec4c574837917c67f18ba442a383060bab236af5b7845163f7fa00a8c2f66"
},
"downloads": -1,
"filename": "cinemagoerng-0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e52ea4ff4f213d8ee48caf8f7d29977e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "~=3.10",
"size": 30911,
"upload_time": "2025-07-25T08:41:54",
"upload_time_iso_8601": "2025-07-25T08:41:54.150264Z",
"url": "https://files.pythonhosted.org/packages/eb/a7/9f47ed6b822a500a9d6de87f4083fb28450e6b1c6a35f15fc6d159b1573d/cinemagoerng-0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "180cea6037fe73d3268d21a8cba3391051d68898e544b47d2a01dd9ca27489a9",
"md5": "7051d22a0657ae2fed479626a08a3157",
"sha256": "b322556345cdd38866433b77e7cfcbcf4c9386cf115330b7caaab8da62fa4a80"
},
"downloads": -1,
"filename": "cinemagoerng-0.4.tar.gz",
"has_sig": false,
"md5_digest": "7051d22a0657ae2fed479626a08a3157",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.10",
"size": 22506,
"upload_time": "2025-07-25T08:41:56",
"upload_time_iso_8601": "2025-07-25T08:41:56.809220Z",
"url": "https://files.pythonhosted.org/packages/18/0c/ea6037fe73d3268d21a8cba3391051d68898e544b47d2a01dd9ca27489a9/cinemagoerng-0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 08:41:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cinemagoer",
"github_project": "cinemagoerng",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cinemagoerng"
}