Skip to content

rjekker/password-store-menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Password-store-menu

A more convenient UI for password-store.el

This emacs package improves on the user interface for password-store.el (see https://www.passwordstore.org/), adding a friendly transient pop-up.

Here’s what that looks like:

./screenshot.png

Features

The package adds a bunch of useful features, including:

  • A minor mode for editing/inserting password files
  • Changes to password files are auto-committed to git
  • Easy browsing and viewing of entries
  • Inserting multi-line passwords
  • Generating passwords with arguments (e.g. length, no-symbols)
  • Initializing a new password folder with interactive selection of encryption keys
  • Verification: check that your password entries are correctly encrypted
  • Showing password QR code inside emacs in text or image format
  • Generating QR Codes for fields as well as secrets
  • Grep with support for emacs grep mode

Features to be added

I have some plans to support the following in the future:

  • otp
  • adding files to the password store

QR Code support

On some systems the command-line utility qrencode is automatically installed with pass. If qrencode is in your path, this will be detected and used.

If you dont have qrencode or prefer elisp-native encoding, you can install qrencode.el instead, and that will be used.

Setup

This package is available through MELPA. You can use “package-install” to install it.

After installing, make sure to “require” the package and call “password-store-menu-enable”, which will install the keybinding for password-store-menu, and make sure that your password files will be opened in a special edit mode.

(require 'password-store-menu)

(setopt
 ;; Optionally set a custom key, default is C-c p
 password-store-menu-key  "C-c p"
 ;; Auto commit can be turned off, default is t
 password-store-menu-edit-auto-commit t)

;; Binds the key and enables password-store-menu-edit-mode
(password-store-menu-enable)

Use-package

With use-package it looks like this:

(use-package password-store-menu
  :ensure t
  :config (password-store-menu-enable)
  :custom (password-store-menu-key "C-c p"))

Usage

By default, the password-store popup menu will be bound to the key C-c p. You can configure this (see above).

The following menu items are available:

Use

KeyNameDescription
bBrowseOpen the URL field in a browser and
c or pCopy SecretCopy the secret into the clipboard
fCopy FieldSelect a field from the entry and copy it
oBrowse and CopyOpen the URL field in a browser and copy the secret into the clipboard
vViewOpen entry in view-mode
qQR CodeView QR code for secret in an Emacs buffer

Change

KeyNameDescription
DDeleteDelete password entry
eEditEdit entry by visiting it
EEdit (pass)Edit entry by calling “pass edit”
iInsertInsert a new password entry (single line: secret only)
IInsert multilineInsert a new entry - open a buffer to create a multiline file
gGenerateGenerate a new password
rRenameRename an entry

Store

KeyNameDescription
+Init subfolderInitialize a new subfolder with its own recipients
dDiredOpen password store folder with dired
GGrepSearch password entries for text patterns
RRecipientsRecipient submenu (see below)

Version Control

KeyNameDescription
V=DiffShow VC diff
VpPullPull from VC
VPPushPush to VC

About recipients

Your password store contains a file .gpg-id, which holds a list of GPG keys to encrypt password entries for. Password-store-menu can help you edit these recipients with a friendly user interface and will re-encrypt your password entries for the new recipients.

Verification

If you use different tools or more password entries around, it can happen that an entry is not actually encrypted for the correct list of recipients in .gpg-id. Password-store-menu can verify your entries for you to make sure that everything is encrypted correctly.

About

A better, more complete user interface for password-store

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •