#+TITLE: Pass layer

#+TAGS: layer|tool

* Table of Contents                     :TOC_5_gh:noexport:
- [[#description][Description]]
  - [[#features][Features:]]
- [[#install][Install]]
- [[#key-bindings][Key bindings]]

* Description
This layer adds integration with [[http://www.passwordstore.org/][pass]], the unix password manager.
You must have ~pass~ installed and available in your path for this layer to
function properly.

** Features:
- Use Spacemacs as your password manager
- Support for OTP via (password-store-otp)
- Use password-store as an Emacs auth source (auth-source-pass)
  See [[https://www.gnu.org/software/emacs/manual/html_node/auth/The-Unix-password-store.html][its info page]] for more details on using it.

* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =pass= to the existing =dotspacemacs-configuration-layers= list in this
file.

* Key bindings

| Key bindings    | Description                                            |
|-----------------+--------------------------------------------------------|
| ~SPC a t P /~   | copy password using =helm-pass= or =ivy-pass=          |
| ~SPC a t P y~   | copy password                                          |
| ~SPC a t P Y~   | copy and describe password                             |
| ~SPC a t P ?~   | describe password                                      |
| ~SPC a t P g~   | generate new password                                  |
| ~SPC a t P i~   | insert new password                                    |
| ~SPC a t P c~   | edit password                                          |
| ~SPC a t P r~   | rename password                                        |
| ~SPC a t P d~   | remove from password store                             |
| ~SPC a t P D~   | clear the password store                               |
| ~SPC a t P I~   | initialize the password store                          |
| ~SPC a t P w~   | open url                                               |
| ~SPC a t P o y~ | copy OTP token                                         |
| ~SPC a t P o Y~ | copy OTP URI                                           |
| ~SPC a t P o i~ | insert new OTP                                         |
| ~SPC a t P o a~ | append OTP to an entry                                 |
| ~SPC a t P o A~ | append OTP to an entry from QR code image in clipboard |
