Skip to main content

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

Download files

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

Source Distribution

illuminatus-0.0.1.tar.gz (23.8 kB view hashes)

Uploaded source

Built Distribution

illuminatus-0.0.1-py3-none-any.whl (30.5 kB view hashes)

Uploaded 3 5

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page