IMDb

IMDb plugin for Limnoria that returns details for the top title match.

Features

• Looks up the top IMDb title match for a query.
• Returns title, year, plot, genre/type, and main actors.
• Gracefully falls back to suggestion data when IMDb blocks detailed page scraping.

Installation

From your Limnoria plugins directory (for example ~/runbot/plugins):

git clone https://github.com/Alcheri/IMDb.git

Install dependencies from the plugin directory:

pip install --upgrade -r requirements.txt

Load the plugin:

/msg bot load IMDb

Configuration

Enable per channel:

config channel #channel plugins.IMDb.enabled True

Disable per channel:

config channel #channel plugins.IMDb.enabled False

Usage

<Barry> !imdb the witches of eastwick
<Puss> Top Match Details:
<Puss> Title: The Witches of Eastwick
<Puss> Year: 1987
<Puss> Plot: Three single women in a picturesque village have their wishes granted, at a cost, when a mysterious and flamboyant man arrives in their lives.
<Puss> Genre: Comedy, Fantasy, Horror
<Puss> Main Actors: Jack Nicholson, Cher, Susan Sarandon, Michelle Pfeiffer, Veronica Cartwright

Notes

• IMDb can return anti-bot/interstitial responses for full title pages.
• When that happens, the plugin still returns a valid top match with available metadata.

Troubleshooting

If !imdb is not returning expected output, check the following:

1. Confirm the plugin is loaded.

/msg bot list IMDb

1. Confirm it is enabled for the channel.

config channel #channel plugins.IMDb.enabled

1. Reload after updates.

/msg bot reload IMDb

1. Reinstall plugin dependencies.

pip install --upgrade -r requirements.txt

1. Test with a popular, unambiguous title.

!imdb the matrix

1. Check Limnoria logs for request or parsing errors if output is still missing.

Expected Degraded Behavior

When IMDb blocks full title-page details, the plugin should still return a valid top match using suggestion metadata.

<Barry> !imdb the witches of eastwick
<Puss> Top Match Details:
<Puss> Title: The Witches of Eastwick
<Puss> Year: 1987
<Puss> Plot: Plot unavailable (IMDb blocked detailed page lookup).
<Puss> Genre: feature
<Puss> Main Actors: Jack Nicholson, Cher

This response indicates fallback mode is working as intended.

Copyright © MMXXVI, Barry Suridge