Skip to content
This repository has been archived by the owner. It is now read-only.
Easy GnuPG, shell scripts to make GnuPG more accessible and easier to use. (Migrated to: https://gitlab.com/EasyGnuPG/egpg)
Branch: gnupg-2.1
Clone or download
Pull request Compare This branch is 332 commits ahead of nyarly:master.

README.md

There are scads of options presented by GnuPG, which are all part of making it the flexible and powerful an encryption framework that it is. But it's extremely complicated to get started with, and that quite reasonably puts people off.

egpg is a wrapper script that tries to simplify the process of using GnuPG. In order to simplify things, it is opinionated about the "right" way to use GnuPG.

The philosophic goals here are these:

  1. Make GPG as easy to use as possible. The more people using strong encryption, the better for everyone. One of the big hang ups right now is that the GPG tools are difficult to use - moreso than they strictly have to be.

  2. Make the interface itself auditable. This is why this is presented as shell scripts rather than a web service or a GUI. If you're concerned about what egpg does, open up the files and read them, or have someone you trust read them.

  3. Build a guide forward. The simplified interface provided here should be good to get started with, and with luck many users will find they never need anything beyond what egpg provides. If you find that you need to do something more, though, the goal is that you have a foundation to start with, and some direction on how to proceed.

For more details see the following presentation from FOSDEM 2018:

Installation

git clone --branch gnupg-2.1 https://github.com/easygnupg/egpg
cd egpg/
sudo make install

Requirements

  • Debian and Ubuntu:

     apt install gnupg2 pinentry-tty haveged libgfshare-bin parcimonie \
            qrencode imagemagick zbar-tools wget realpath psmisc
    

    For development, you need also ronn to make the man pages:

     apt install ruby-dev gcc
     gem install ronn
    

Usage:

egpg presents a series of subcommands:

egpg init

egpg key gen [<email> <name>]
egpg key ls

egpg contact search <name>
egpg contact ls

egpg sign <file>
egpg verify <file.signature>

egpg seal <file> [<recipient>+]
egpg open <file.sealed>

egpg help
egpg key help
egpg contact help
egpg ext help

These should be the minimal set required to use GPG effectively.

Any suggestions or discussions about supported operations, simplified terminology, etc. is wellcome.

For more details see the wiki pages and the manual page:

You can’t perform that action at this time.