https://github.com/mnussbaum/PassHUD

A HUD-style interface for pass on macOS
https://github.com/mnussbaum/PassHUD

macos pass password password-manager password-store

Last synced: 3 months ago
JSON representation

A HUD-style interface for pass on macOS

• Host: GitHub
• URL: https://github.com/mnussbaum/PassHUD
• Owner: mnussbaum
• License: mit
• Created: 2018-10-17T06:03:26.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-02-23T23:01:34.000Z (almost 6 years ago)
• Last Synced: 2024-08-02T02:02:34.993Z (6 months ago)
• Topics: macos, pass, password, password-manager, password-store
• Language: Swift
• Size: 1.02 MB
• Stars: 34
• Watchers: 6
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-password-store - PassHUD - style interface for pass on macOS. (Interfaces / All other extensions)

README

        
## PassHUD

A HUD-style fuzzy-finder interface for [zx2c4's

`pass`](https://www.passwordstore.org) on macOS. Copies passwords to clipboard.

Depends on `pass` being installed and configured.

![Screenshot](PassHUDScreenShot.png)

### Usage

Run the PassHUD application, then open PassHUD's window by clicking its lock

menu bar icon, or by using its default keyboard shorcut of `⌘ ` + `/`.

PassHUD fuzzy-finds passwords as you type. Click passwords to copy them to the

clipboard or just hit `Enter` once the password is highlighted. PassHUD keeps

recently used passwords at the top of the list for easy access.

Passwords are written to the clipboard directly by `pass` and are never seen by

PassHUD. Default `pass` clipboard clearing behavior applies.

### Installation

Download and install the latest release from a DMG on [the releases

page](https://github.com/mnussbaum/PassHUD/releases/).

### Configuration

PassHUD can be configured with an optional config file that can be created at

one of the following paths:

* `~/.PassHUD`

* `~/.config/PassHUD/config`

The config file is YAML and can set environment variables for PassHUD's

execution of `pass`, and an optional path to `pass` itself. If a path isn't

provided `pass` must be on the `$PATH`. All fields in the config are optional.

Here's an exhaustive example config file:

```yaml

---

version: 1

pass:

  commandPath: ~/a/non/default/path/to/pass

  env:

    - name: PASSWORD_STORE_DIR

      value: ~/a/non/default/password/store/path

# This example registers two arbitrary hot keys. Valid modifiers are: "cmd",

# "ctrl", "opt" and "shift"

hotKeys:

  - modifiers:

      - cmd

      - shift

    key: \

  - modifiers:

      - cmd

    key: /

 ```