Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

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 hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page