Clients

Clients

rpass uses the standard password-store format. Any client compatible with pass works with rpass — there are many options across all platforms.

Known compatible clients

Client	Platform	Notes
Raycast	macOS / Windows	Official rpass extension available in the Raycast Store.
Vicinae	macOS / Linux	Fully compatible with the Raycast extension.
Pass for iOS	iPhone / iPad	Git sync, TOTP, Safari extension
Android Password Store	Android	Git sync, OpenKeychain integration
QtPass	Linux / Windows / macOS	GUI frontend for pass
Browserpass	Browser extension	Chrome, Firefox

Note

This list is not exhaustive. Any application that reads the password-store format (.gpg files + .gpg-id) is compatible. GUI launchers such as Raycast and Vicinae can also integrate directly with rpass through its JSON output. Check the password-store ecosystem for more options.

Setting up a client

All clients need two things:

1. A remote Git repository — to sync your store across devices. See Getting Started for how to push your store to GitHub, GitLab, or any Git host.
2. Your GPG private key — imported into the client or its companion app. See GPG Keys for the full workflow.

Each client has its own setup guide:

• Raycast: Install the official extension from the Raycast Store: https://www.raycast.com/rxtsel/rpass
• Vicinae: Configure it to use rpass --json as its password provider.
• Other clients: Refer to their official documentation. For Pass for iOS in particular, see the Pass for iOS wiki.

Important

Before importing your GPG key into any mobile client, check which key algorithms it supports. Not all clients support modern key types. See GPG Keys → Algorithm compatibility.