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

A Python GUI, CLI, and wrapper for Tomb

Project Description

Mausoleum consists of a command line application and GUI application wrapped around Tomb (the Crypto Undertaker). Both applications were created with the intention of making it easier for users to interact with Tomb.


As Mausoleum is purely a wrapper for Tomb, it requires Tomb to be installed locally. For Tomb installation details, please see: The Mausoleum GUI application requires PyQt5 to be installed locally. For PyQt5 installation instructions, please visit:

With your environment set, the following command may be used to install Mausoleum:

$  pip install mausoleum

If you would rather install from source, run:

$  git clone
$  cd Mausoleum
$  python install

GUI Application

To run the GUI application, simply run the following command in a terminal:

$  mausoleum-gui

The command will open a new window that includes tabs that group Tomb functions into separate tabs. The ‘Create’ tab receives information needed to create a new tomb, the ‘Open’ tab allows the user to fill in information regarding the opening of an existing tomb, the ‘Close’ tab lets the user close opened tombs, the ‘Resize’ tab gives the user the ability to resize an existing tomb, the ‘List’ tab displays all active tombs, and the ‘Config’ tab allows the user to make configuration changes to the GUI.

Command Line Application

With Mausoleum installed, the command line application can be invoked with the following commands and arguments:

usage: mausoleum [options] command [arguments]

    construct               Dig, forge, and lock a new tomb
    enter                   Open an existing tomb
    alter                   Resize an existing tomb
    mold                    Create a QR code from an existing tomb key
    etch                    Embed an existing tomb key inside a JPEG image
    resurrect               Print to stdout the tomb key embedded within the JPEG image

positional arguments:
    name                    Name of the new or existing tomb
    size                    The size in megabytes for the new tomb
    key                     Name of the new or existing tomb key file

optional arguments:
    --open                  Option that opens a tomb after creation or resizing

If a key is not supplied as a command line argument, the application will search for a key with the name of the tomb with .key as the suffix.

Example of creating a new tomb and opening it thereafter:

$  mausoleum construct --open secret.tomb 100
Repeat for confirmation:

Example of opening an existing tomb:

$  mausoleum enter secret.tomb

Example of resizing an existing tomb:

$  mausoleum alter secret.tomb 200


Mausoleum may be imported as a module as seen in the following example:

import mausoleum.wrapper

def batch_create_tombs(names, size, password):
    """Take a list of names and batch create tombs."""

    for name in names:
        key = '{}.key' .format(name)
        mausoleum.wrapper.construct_tomb(name, size, key, password)


All contributions are welcome! Feel free to submit a pull request for trivial changes. For other changes, please open an issue on the repository’s issue tracker.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
mausoleum-0.8.3-py3-none-any.whl (28.0 kB) Copy SHA256 Checksum SHA256 py3 Wheel Jun 8, 2017
mausoleum-0.8.3.tar.gz (27.3 kB) Copy SHA256 Checksum SHA256 Source Jun 8, 2017

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting