A thin wrapper around the standard pass(1) UNIX utility.

This module provides several prompts to ease password manipulation (generate, read, edit, remove); all of them benefit from the completion system provided by XMonad.Prompt. Specifically, we provide

• various functions to lookup passwords in the password-store:

  + passPrompt copies the password directly to the clipboard.

  + passOTPPrompt copies a one-time-password to the clipboard (this uses pass-otp).

  + passTypePrompt and passOTPTypePrompt work like the above, respectively, but use xdotool to type out the password.

• passGeneratePrompt generates a password for a given password label that the user inputs.
• passEditPrompt edits a password for a given password label that the user inputs.
• passRemovePrompt deletes a stored password for a given password label that the user inputs.

The password store is setup through an environment variable $PASSWORD_STORE_DIR, or $HOME/.password-store if it is unset. The editor is determined from the environment variable $EDITOR.

Source:

• The password store implementation is here.
• Inspired by http://babushk.in/posts/combining-xmonad-and-pass.html

You can use this module with the following in your xmonad.hs:

import XMonad.Prompt.Pass

Then add a keybinding for passPrompt, passGeneratePrompt, passRemovePrompt, passEditPrompt or passTypePrompt:

  , ((modMask , xK_p)                              , passPrompt def)
  , ((modMask .|. controlMask, xK_p)               , passGeneratePrompt def)
  , ((modMask .|. shiftMask, xK_p)                 , passEditPrompt def)
  , ((modMask .|. controlMask  .|. shiftMask, xK_p), passRemovePrompt def)

You can also use the versions that let you specify a custom prompt:

  , ((modMask , xK_p)                              , passPrompt' "Ask 'pass' for" def)

Note that, by default, we do not use fuzzy matching in this module. To enable this feature, import the XMonad.Prompt.FuzzyMatch module and add the relevant functions to your prompt configuration:

myXPConfig :: XPConfig
myXPConfig = def
  { searchPredicate = fuzzyMatch
  , sorter          = fuzzySort
  }

, ((modMask , xK_p), passPrompt myXPConfig)

For detailed instructions on:

• editing your key bindings, see the tutorial.
• how to setup the password store, see http://git.zx2c4.com/password-store/about/ or man 1 pass.