Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

A cli for interacting with yopass backend

Project description


Build Status

PyPI version

This is a command-line tool to interact with a (the) yopass backend created by Johan Haals. Even though it is possible to use the service via the web-frontend I felt the necessity of a cli tool to use this awesome software in our automation projects.

This cli tool uses sjcl (just like the web-frontend) to perform encryption on the client side thus preventing your secret from ever leaving your os in a cleartext form.


yopass-cli requires python3+ to run.

$ pip install --user yopass-cli

Make sure to have the following 2 environment variables set before using:



      $ export YOPASS_BACKEND_URL=
      $ export YOPASS_FRONTEND_URL=

If you use your own server, the front and backend URLs can be the same. For example:


yopass-cli send [OPTIONS] SECRET
cat <filename> | yopass-cli send [OPTIONS]
echo "<my passphrase" | yopass-cli send [OPTIONS]

Send Options:

--expires [1h|1d|1w]
--outmode [verbose|one-click-link|short-link|id]
--outformat [plain|json]

Get Options:

--outformat [plain|json]


  • testing
  • proper README



Free Software, Hell Yeah!

Contribution is welcome :) 🍺Cheers 🍺

Project details

Download files

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

Files for yopass-cli, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size yopass-cli-0.0.5.tar.gz (3.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page