/gnome-pass-search-provider

Pass password manager search provider for gnome-shell

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

A search provider for GNOME Shell that adds support for searching in pass.

Names of passwords will show up in GNOME Shell searches, choosing one will copy the corresponding content to the clipboard.

Sreencapture

Installation

Arch Linux

Install gnome-pass-search-provider-git from the AUR.

Manual

Ensure that python>=3.5 and python-gobject are installed on your system and that pass is setup.

Download or clone this repository:

git clone git@github.com:jle64/gnome-shell-pass-search-provider.git

Run the installation script as root:

sudo ./install.sh

If you need to you can change the installation paths to suit your system:

sudo SYSCONFDIR=/etc DATADIR=/usr/share LIBDIR=/usr/lib LIBEXECDIR=/usr/lib ./install.sh

Post-installation

Recommended : set gpg agent to use pinentry-gnome3 by adding pinentry-program /usr/bin/pinentry-gnome3 to ~/.gnupg/.gpg-agent.conf.

If you are on Xorg, restart GNOME Shell by typing 'alt + f2' then entering 'r' as command. If you are on Wayland, you need to close and reopen your GNOME session.

The search provider should show up and be enabled in GNOME search preferences and started on demand by GNOME Shell.

Environment variables

If you are configuring pass through environment variables, such as PASSWORD_STORE_DIR, make sure to set them in a way that will propagate to the search provider executable, not just in your shell. Setting them in ~/.profile should be sufficient.

Clipboard managers

If you are using GPaste, passwords will be sent to it marked as passwords, thus ensuring they are not visible. Otherwise they are sent to the clipboard using pass -c which defaults to expiration after 45 seconds.

Compatibility

This implements the org.gnome.Shell.SearchProvider2 D-Bus API which seems to be present in GNOME Shell since around 2012 and has been tested with GNOME Shell 3.22-3.26.

Troubleshooting

If this does not work for you, make sure to look to wherever GNOME and D-Bus are logging for error messages (in the journal on systemd-using systems). Don't hesitate to open an issue.