Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Tools for managing photos and videos

Project Description


A Python library and command line tool for managing visual digital media (photos and videos) using sqlite, pillow, and ffmpeg.


The package comes with a command-line script, illuminatus, that serves as a command-line frontend to many of the features provided by the library. To get help, just invoke the script:


The script requires an operation to be specified; the operations provided by the script are documented in more detail below, but first a word about databases.

Specifying a database

To allow the script to do something useful, you’ll need to provide the location of a database holding media metadata. You can do this in one of two ways:

  • Provide the --db flag when running the script.
  • Specify a database location using the ILLUMINATUS_DB environment variable.

If both are provided, the flag overrides the setting of the environment variable.


The illuminatus script can recursively import media from any filesystem path.

illuminatus import ~/Pictures


The illuminatus script can export media that are tagged in a specific way. The export comes in a zip file and includes a metadata dump of the relevant tags and such.

illuminatus export


The illuminatus script can show items in the database that match certain queries.

illuminatus list


The illuminatus script can add or remove tags to or from media.

illuminatus retag


The illuminatus script can regenerate the thumbnails for existing items in the database.

illuminatus rethumb


The illuminatus script can provide a RESTful HTTP server (using for media data and metadata.

illuminatus serve


Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(30.5 kB) Copy SHA256 Hash SHA256
Wheel 3.5 Jun 7, 2016
(23.8 kB) Copy SHA256 Hash SHA256
Source None Jun 7, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting