Skip to main content

Python helper package for implementing Onion Mirror Guidelines (OMG)

Project description


Python helper for implementing the Onion Mirror Guidelines (OMG)

The Onion Mirror Guidelines are a set of rules enforced by the operator of DarkDotFail - a dark net directory of confirmed and official Tor .onions - to help improve the reliability of the information displayed on the website.

Practically, implementing the OMG shows a commitment to user safety by proving ownership of PGP keys on a regular basis.

Reference Specification


This will install the omgpy package globally with pip

git clone
cd omg-py
pip3 install .


Import OMG

from omgpy import OMG

Start OMG with the email address of the PGP key you want to sign with. This key must exist already and be correctly loaded in gpg. You can also use a key ID instead of an email address.

omg = OMG("")

Define a template_path. If this directory exists then you must manually populate it with templates of the files that will be signed. If this directory doesn't exist currently, it will be created automatically in the next step and the default template files will be copied.

You can always add new template files to the Template directory, you are not limited by the default set.

omg.template_path = "/Desktop/omg/templates"

You can copy the default set of files that need to be signed in order to comply with the OMG by calling create_template_files after setting the template_path. This only needs to be done once (and it is optional - if you do not do this, you will need to manually create the template files and place them in your template_path directory.)


You can optionally declare where you would like the output saved. If this is not set the default location of the files will be in the current working directory where the script is called from.

omg.public_path = "/Desktop/omg/public"

You are ready to sign.


When the files are signed, the output will be saved in a directory called public. In this directory will be two additional directories: signed and unsigned. The unsigned directory will contain the raw .txt file of what is to be signed and the signed directory will contain the corresponding clearsigned .txt.asc file.

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

omgpy-0.0.1.tar.gz (3.9 kB view hashes)

Uploaded source

Built Distribution

omgpy-0.0.1-py3-none-any.whl (5.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page