summaryrefslogtreecommitdiffstats
path: root/.local/share
diff options
context:
space:
mode:
authorThomas Vanbesien <tvanbesi@proton.me>2026-05-19 20:58:12 +0200
committerThomas Vanbesien <tvanbesi@proton.me>2026-05-19 20:58:12 +0200
commite08f1ecdf1135d3efe2bdae392bee731f688f4c6 (patch)
tree0ca45510cec93c93062a96a6afa94a5a0cb365ff /.local/share
parent05ce4c66bf98b409282574dc789e0e41e2a6b0bf (diff)
downloaddotfiles-e08f1ecdf1135d3efe2bdae392bee731f688f4c6.tar.gz
dotfiles-e08f1ecdf1135d3efe2bdae392bee731f688f4c6.zip
docs: update README
Diffstat (limited to '.local/share')
-rw-r--r--.local/share/dotfiles/README.md18
1 files changed, 12 insertions, 6 deletions
diff --git a/.local/share/dotfiles/README.md b/.local/share/dotfiles/README.md
index 9b35cc7..3cd1772 100644
--- a/.local/share/dotfiles/README.md
+++ b/.local/share/dotfiles/README.md
@@ -33,15 +33,19 @@ The store is its own git repository, manage it with `pass git ...`, independent
These variables must be available for other programs to function. See `man 5 environment.d`. Now reboot.
-For browser integration, install the [browserpass][7] extension from the browser's add-on store, then register its
-native messaging host (the `browserpass` package is installed by `dotfiles sync`):
+## Password management
-```bash
-make -C /usr/lib/browserpass hosts-firefox-user
-```
+For browser integration, install the [browserpass][7] extension from the browser's add-on store. Everything else is
+handled by `dotfiles sync`: it installs Firefox and the `browserpass` package, and symlinks the native messaging host
+from `/usr/lib/browserpass` into `~/.mozilla/native-messaging-hosts/`.
browserpass inherits `PASSWORD_STORE_DIR` automatically because the browser is launched with the `environment.d`
-environment — which is exactly why that variable lives there and not in the shell rc. That's it!
+environment — which is exactly why that variable lives there and not in the shell rc.
+
+For Secret Service integration, [pass-secret-service][8] exposes the `org.freedesktop.secrets` D-Bus API backed by the
+same `pass` store, so any application that would normally reach for GNOME Keyring or KWallet (NetworkManager secrets,
+IDE credential stores, …) reads and writes through `pass` instead. Like browserpass, it inherits `PASSWORD_STORE_DIR`
+from the `environment.d` environment.
## Overview
@@ -51,6 +55,7 @@ environment — which is exactly why that variable lives there and not in the sh
- **File browser**: [ranger][4]
- **Text editor**: [nvim][5]
- **Password manager**: [pass][6]
+- **Secret Service provider**: [pass-secret-service][8]
## Links
@@ -62,3 +67,4 @@ environment — which is exactly why that variable lives there and not in the sh
[5]: https://neovim.io/
[6]: https://www.passwordstore.org/
[7]: https://github.com/browserpass/browserpass-extension
+[8]: https://github.com/grimsteel/pass-secret-service