Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marcelbuesing/mgpg

A mattermost client for conveniently encrypting messages
https://github.com/marcelbuesing/mgpg

Last synced: about 1 month ago
JSON representation

A mattermost client for conveniently encrypting messages

Awesome Lists containing this project

README

        

📦✨ mgpg


Mattermost Crypto Client


Build Status
crates.io
crates.io


Docs

Built with 🦀

# About

A mattermost client for conveniently encrypting messages using GnuPG via [GPGME](https://gnupg.org/software/gpgme/index.html).

# Setup

Install from source:
```
cargo install mgpg
```

When running mgpg for the first time you'll be guided through a setup process.
Your Mattermost password will be securely stored in your "keyring".
Other configuration values are stored in "~./config/mgpg" in plain format.

To rerun the setup process, replacing all previous values, run `mgpg --reinit`.

# Usage
Make sure GPG is aware of the recipient's public key by importing the key.
You can verify that the public key has been imported via `gpg --fingerprint [email protected]` or alternatively, check the output of `gpg --list-keys`.

Encrypt message using the public key of the recipient and send it as a direct message to the recipient:
```
echo "In God we trust. The rest we monitor." | mgpg --to [email protected]
```

In addition to encrypting messages you may also sign them, before sending them:
```
echo "It's a brave new world out there." | mgpg --sign --to [email protected]
```

Pass message as parameter:
```
mgpg --sign --to [email protected] -- "In God we trust. The rest we monitor."
```

# Help

```
mgpg --help
mgpg 0.1.0

USAGE:
mgpg [FLAGS] [OPTIONS] [--] [message]

FLAGS:
-h, --help Prints help information
--reinit
-s, --sign
-V, --version Prints version information

OPTIONS:
-t, --to ...

ARGS:

```