Pompei

Pompei is a free Python package for creating photo mosaics from movie frames. It extracts frames from a video, resizes them into thumbnails, and saves them with related information in a directory. For a mosaic, the package matches image regions to movie-frame thumbnails and assembles selected thumbnails into a PNG file. Options control mosaic width, how often a thumbnail can be reused, iteration count, and the time and spatial gaps between source frames. An experimental candidate-selection approach uses Scikit-learn to identify thumbnails that may suit a mosaic; MoviePy is installed as a dependency, while Scikit-learn is needed for that approach. The project documentation describes modular code and demonstrates customization by subclassing MovieFrames and overriding a method. The command-line API has not been implemented, so the package is used through Python rather than a finished command-line interface. Pompei runs on Linux and can be installed with pip or from source. It is open source under the MIT licence, and the project page invites commit proposals and requests for help on GitHub. PyPI lists version 0.1.04, released January 29, 2015.