Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

kip Keeps Passwords

Project Description

% KIP(1) % Graham King % 26 OCT 2012


kip - Keeps Internet Passwords. Command line script to keep usernames and passwords in gnupg encrypted text files.


kip get|add|list|edit|del [filepart] [–username USERNAME] [–notes NOTES] [–prompt] [–print]


Make sure you have a gnupg key pair: [GnuPG HOWTO](

Latest release: sudo pip install kip

Latest dev:

1. Clone the repo: git clone 1. Install: sudo python3 install

Ubuntu: [PPA with ‘precise’ package](

Arch Linux: [kip package for Arch]( Thanks [Pezz](!


## add

kip add –usename username

What it does:

  1. Generates a random password
  2. Writes username and password to text file ~/.kip/passwords/
  3. Encrypts and signs it by running gpg –encrypt –sign –armor
  4. Copies the new password to your clipboard

Add optional notes: kip add –username username –notes “My notes”. You can ask to be pompted for the password, instead of using a random one: kip add –username username –prompt

## get


What it does:

  1. Looks for ~/.kip/passwords/**, decrypts it by running gpg –decrypt
  2. Prints your username in bold, and any notes your stored.
  3. Copies your password to the clipboard

## list

kip list “*.org”

List contents of your password directory. [filepart] argument is a glob to filter the directory list. You can use ls too!

## edit

kip edit –username newuser

Change the username inside a password file. [filepart] is the file to edit, and –username sets a new username.

## del

kip del

Delete a password file. [filepart] is the file to delete. You can use rm too!

## import_from_chrome

Import passwords that Chrome stored in Gnome Keyring. This requires gnomekeyring (python lib) and python2.


gnupg to encrypt password files, xclip (linux) or pbcopy (OSX) to copy password to clipboard, and python3 but you have that already.

On Ubuntu / Debian: sudo apt-get install gnupg xclip


If you want to use different commands to encrypt / decrypt your files, want longer passwords, etc, you can. Copy kip.conf from the repo to ~/.kip/kip.conf, and customise it. It’s an INI file, using = or : as the delimiter. Make sure the home path does not end with a slash.


[GnuPG]( is secure, open, multi-platform, and will probably be around forever. Can you say the same thing about the way you store your passwords currently?

I was using the excellent [Keepass]( when I got concerned about it no longer being developed or supported. How would I get my passwords out? So I wrote this very simple wrapper for gnupg.

If you live in the command line, I think you will find kip makes your life a little bit better.


There’s 0 magic involved. Your accounts details are in text files, in your home directory. Each one is encrypted with your public key and signed with your private key. You can ditch kip at any time.

Browse your files: ls ~/.kip/passwords/

Display contents manually: gpg -d ~/.kip/passwords/facebook

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(21.6 kB) Copy SHA256 Hash SHA256
Source None Aug 28, 2013

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting