Integrate Emacs' auth-source with password-store
Emacs Lisp Makefile Shell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Build Status

auth-source-pass (aka. auth-password-store)

The auth-source-pass package, formerly known as auth-password-store, integrates Emacs' auth-source library with password-store. The auth-source library is a way for Emacs to answer the old burning question “What are my user name and password?”. Password-store (or just pass) is a standard unix password manager following the Unix philosophy.

The auth-source-pass project is a password-store backend for auth-source.

Installing

This package has been included in Emacs 26 (still unreleased). If that suits you, you can just start using it. Otherwise, install it from melpa (the name is still auth-password-store).

Regardless of the version you choose, please report issues to auth-password-store's issue tracker. Please make sure to specify which version you use.

Usage

Add the following to your init.el file:

(require 'auth-source-pass)
(auth-source-pass-enable)

Organization

auth-source-pass follows the first approach suggested by the Password-store project itself for data organization to find data. This means that the filename of the file containing the password for a user on a particular host must contain the hostname. The file itself must contain the password on the first line, as well as a user field containing the username on a subsequent line.

If you have several accounts for the same host, you can name your files in 2 different ways:

  • user1@host.gpg and user2@host.gpg, or
  • host/user1.gpg and host/user2.gpg

If you use several ports (sometimes called services) in the same host (e.g., web and mail), you can add a colon and the port number (or service name) at the end of the filename: e.g., host:443.gpg or host:imap.gpg.

Pass in Emacs

Users of this package may also be interested in functionality provided by other Emacs packages dealing with pass:

Contributing

Yes, please do! See CONTRIBUTING for guidelines.

License

See COPYING. Copyright (c) 2015 Damien Cassou & Nicolas Petton.