Please note: you are testing experimental software.
See also: Best Practices
To install zpy, you need Python 3.4 or later.
# apt-get install python3-pip
# pip3 install zpy
# dnf install python3-pip
# pip3 install zpy
$ brew install python3
$ pip3 install zpy
To encrypt a file, simply type:
zpy encrypt secrets.txt
You can also pipe text into zpy:
echo "attack at dawn" | zpy encrypt
Note that the output is Base64 encoded. If you are encrypting large files,
use the --raw flag to output raw bytes instead.
zpy encrypt -r secrets.sqlite > secrets.sqlite.zpy
The location of your identity defaults to ~/.ssh/id_rsa. If you want to
use another identity, use the --identity flag:
zpy -i ~/.ssh/my_other_id encrypt secrets.txt
If your private key is encrypted with a password, you will be prompted
to enter it when you execute these commands. You can use ssh-add to
cache your passphrase with ssh-agent.
Decrypting works the same as encrypting.
zpy decrypt secrets.txt.zpy
The --raw flag is not available for decryption. Zpy will automatically
determine whether the input is binary or not.
zpy decrypt secrets.sqlite.zpy > secrets.sqlite
If you have used a different identity for the encryption, provide it in the same way:
cat secrets.txt.zpy | zpy -i ~/.ssh/my_other_id decrypt
You should regularly check for updates. Zpy encrypted files have a version number that ensures new versions of the program can decrypt old files, but it will only use the newest protocol for encrypting files.
To update zpy, run:
pip install --upgrade zpy
You can find the Changelog on GitHub.