the-film-flam 2026.6.7

FilmFlam (or just "flam") is a commandline tool and API for extracting insights from your movie lists.

FilmFlam

FilmFlam (or just "flam") is a commandline tool and API for extracting insights from your movie lists.

From the commandline, flam enables you to quickly answer questions like "where have I seen this actor?", or "which director have I seen the most movies from?", and so much more.

For more powerful uses, you can import flam and use the underlying API to access all the data about the movies and people in your movie lists.

Features

• Get information about all the movies in your movie list, or about the people in those movies
• Filter those movies or people to find something specific
• Sort everything and everyone and discover standouts
• Extend flam to support custom movie databases, custom filters, and custom attributes
• All in a short and quick commandline
• All in a python API for using from a script

Installation

Simply:

pip install the-film-flam

If it worked, great! Otherwise, python probably didn't add the folder where scripts get installed to PATH. Find where flam.exe is installed on your machine - On Windows it will probably be in a folder that looks similar to one of these:

%LOCALAPPDATA%\Python\pythoncore-3.14-64\Scripts
%LOCALAPPDATA%\Programs\Python\Python312\Scripts

Once you find it, add the folder to PATH and try again.

Usage

Read all about how to use flam in the docs!

Supported platforms

Flam is cross-platform and should work on Windows, Linux, and macOS. However, it's only well-tested on Windows, since that is what I am using. Please let me know if you encounter issues.

Flam is better if you have less installed. If you're on Windows, it's recommended to install it. One easy way is to just install git.

Getting help

If you encounter issues or have questions, please open an issue, or email me at [e-mail].

Disclaimer

This program uses TMDB and the TMDB APIs but is not endorsed, certified, or otherwise approved by TMDB.

Likewise IMDb, Letterboxd, or what-have-you.