How to Set Up Bitwarden for PWTray

You only do this once. After setup, relaunches only require one Bitwarden master-password unlock.

Prerequisites

Install PWTray from the download section.
Install Bitwarden CLI (bw) from Bitwarden official docs: bitwarden.com/help/cli.
Confirm CLI is available on your machine:
```
bw --version
```

PWTray does not bundle or install bw. It uses your existing Bitwarden CLI installation.

Step-by-step

Open PWTray.
Go to vault.bitwarden.com and sign in to your Bitwarden vault.
In the left sidebar, go to Settings.
Expand settings and click Security.
Open the Keys tab.
Copy both values: client_id and client_secret.
In PWTray first launch, paste client_id and client_secret when prompted.
If prompted, enter your Bitwarden master password to unlock your vault.
On future app relaunches, you only need to unlock once with your master password.

Bitwarden Vault UI showing Settings, Security, and Keys tab where client_id and client_secret are available.

Bitwarden path: Settings → Security → Keys (copy client_id and client_secret).

PWTray first-launch setup view where API key fields (client_id and client_secret) will be shown.

Preview of PWTray first-launch setup screen. Please add your vault client_id and client_secrets here.

Security and trust model

Your Bitwarden credentials are handled locally. PWTray does not store your client_id or client_secret. Bitwarden CLI stores required secrets encrypted on your machine.

Never share your API key values publicly.

Need more context? Visit the FAQ.