Multiple Password Stores with Profiles

QtPass supports multiple profiles, letting you keep separate password stores for different purposes (e.g., work and personal).

Creating a New Profile

  1. Go to Config
  2. Click Add in the Profiles section
  3. Give it a name and choose where to store it
  4. Click OK

Switch between profiles using the dropdown in the main toolbar.

Template Fields

Templates let you add custom fields to password entries beyond just the password itself.

Currently there is only one global template for all profiles and folders.

Setting Up a Template

  1. Go to Config
  2. Open the Template tab
  3. Type each field name on a new line
Template (in Config): 
login
url
notes
Saved password entry: 
mypassword
login: user@example.com
url: https://github.com
notes: Two-factor enabled

Common templates

Template all fields

Check Template all fields in Config to render existing colon-separated lines (like login: user@example.com) as editable key-value fields.

OTP (One-Time Passwords)

Since 1.8.0 QtPass generates time-based one-time passwords (TOTP, RFC 6238) itself: SHA-1/SHA-256/SHA-512 and Steam Guard codes, on every platform and with both the pass and the direct gpg/git backends. The pass-otp extension is no longer required; entries it created keep working.

Adding OTP to a Password

  1. Add or edit a password as usual
  2. Put the otpauth:// URI (or the base32 secret) in the OTP template field. A bare otpauth:// line, as written by pass otp insert, is read too.
  3. Save the entry

Select the entry: the current code is shown with a countdown to the next one. Copy it with the button next to the code or with Ctrl+G. The shared secret itself is never shown or copied.

OTP support is enabled by default after upgrading to 1.8.0. Turn it off with Enable one-time password (OTP) support on the Settings tab of the configuration dialog.

Per-Folder Encryption

QtPass supports different encryption keys for different folders, useful for sharing passwords with family or team members.

Setting Per-Folder Keys

  1. Create or select a folder in your password store
  2. Click the Users button (or right-click and select Edit Users)
  3. Add the GPG keys that should have access to this folder
  4. Save the .gpg-id file

Each subfolder can have its own set of recipients. Files in that folder will only be decryptable by those keys.

Git Sync

QtPass can automatically sync your password store using Git.

Enabling Git

  1. Go to Config
  2. Check Use Git
  3. Configure your remote repository

Auto Sync Options

You can also manually pull/push using the toolbar buttons.

Password Generation

QtPass includes a built-in password generator.

Using the Generator

  1. When adding/editing a password, click Generate
  2. Set the desired length (20+ characters recommended)
  3. Choose character options (avoid capitals, numbers, symbols)
  4. Click Use to insert the generated password

Pwgen Option

For pronounceable passwords, enable Use Pwgen if you have the external pwgen tool installed.

Clipboard & Auto-Clear

QtPass automatically clears copied passwords from your clipboard for security.

Configuration

You can also press Ctrl+Shift+C to copy without auto-clear.

System Tray

QtPass can run in the system tray for quick access.

Enabling Tray Icon

  1. Go to Config
  2. Check Use Tray Icon

Tray Options

QR Codes

Display passwords as QR codes for easy scanning on mobile devices.

Requirements

Using QR Codes

When viewing a password, click the QR code button to display it. Scan with any authenticator app to transfer the password to your phone.

Shoulder Surfing Protection

QtPass can hide passwords to prevent others from seeing your screen.

Hide Passwords