Pompei
zulko.github.io
What it is
Pompei is a free, open-source Python package for creating photo mosaics from movie frames. It extracts frames from a video, turns them into thumbnails, and stores them with associated information in a directory. To build a mosaic, it matches image regions with movie-frame thumbnails and assembles selected thumbnails into a PNG file. Options let users set mosaic width, limit thumbnail reuse, choose an iteration count, and adjust time and spatial spacing between source frames. An experimental candidate-selection method uses Scikit-learn to identify thumbnails that may suit a mosaic; MoviePy is installed as a dependency, and that method requires Scikit-learn. The documentation describes a modular codebase and shows how to customize behavior by subclassing MovieFrames and overriding a method. The command-line API is not yet implemented, so the package is used through Python. Pompei runs on Linux, installs with pip or from source, and is released under the MIT licence. PyPI lists version 0.1.04, released January 29, 2015.
Spec sheet
- Purpose
- Pompei is a Python package for making photo mosaics from movie frames.Read 8 Oct 2026 · zulko.github.io
- Support
- The project page invites users to propose commits or ask for help on GitHub.Read 8 Oct 2026 · zulko.github.io
- License
- The project is open source and released under the MIT licence.Read 8 Oct 2026 · zulko.github.io
- Candidate selection
- An experimental method uses Scikit-learn to identify movie thumbnails that may be good mosaic candidates.Read 8 Oct 2026 · zulko.github.io
- Command-line interface
- The documentation says the command-line API is not yet implemented.Read 8 Oct 2026 · zulko.github.io
- Customization
- The documentation describes the code as modular and shows how to customize behavior by subclassing MovieFrames and overriding a method.Read 8 Oct 2026 · zulko.github.io
- Dependency
- MoviePy is installed as a dependency; the candidate-selection method requires Scikit-learn.Read 8 Oct 2026 · zulko.github.io
- Distribution
- The package can be installed with pip or from its source code.Read 8 Oct 2026 · zulko.github.io
- Frame extraction
- It extracts frames from a video, resizes them into thumbnails, and stores them with associated information in a directory.Read 8 Oct 2026 · zulko.github.io
- Mosaic controls
- Options include mosaic width, thumbnail reuse limits, iteration count, and time and spatial spacing between source frames.Read 8 Oct 2026 · zulko.github.io
- Mosaic creation
- It matches image regions with movie-frame thumbnails and assembles the chosen thumbnails into a mosaic file.Read 8 Oct 2026 · zulko.github.io
- Release status
- PyPI lists version 0.1.04, released January 29, 2015.Read 8 Oct 2026 · pypi.org
Plans and prices
Strong points and limits
Strong points
- Controls include mosaic width and thumbnail reuse limits.
- Creates PNG mosaics from movie frames.
- Can be installed with pip or from source.
- Released under the MIT licence.
Limits
- The command-line API is not yet implemented.
- Candidate selection is experimental and requires Scikit-learn.
- PyPI lists version 0.1.04 from January 29, 2015.
Who it suits
Pompei suits Python users on Linux who want to make mosaics from video frames and adjust how source frames are selected. It may also suit developers who want to adapt its behavior through subclassing.
Verdict
Pompei offers adjustable video-frame mosaics through a Python package, with a documented route to customize behavior. Its command-line API is unfinished, and candidate selection is experimental.
Where Specifiction places it
- Photo Mosaic Software#23 of 247.0