Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

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


Project details

Release history Release notifications

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
illuminatus-0.0.1-py3-none-any.whl (30.5 kB) Copy SHA256 hash SHA256 Wheel 3.5 Jun 7, 2016
illuminatus-0.0.1.tar.gz (23.8 kB) Copy SHA256 hash SHA256 Source None Jun 7, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page