Getting Started with QtPass 1.5.0

Prerequisites

Before using QtPass, you need:

• GPG key pair - QtPass uses GPG for encryption. If you don't have one, create one.
• pass (optional but recommended) - The command-line password manager. Install pass.

Step 1: Install QtPass

Download QtPass for your platform:

• GitHub Releases - All platforms
• Windows - Installer or Chocolatey
• macOS - DMG or Homebrew
• Linux - Package manager or source

Step 2: Initialize Your Password Store

QtPass needs a password store to work with. You have two options:

Option A: Create a new store

1. Click the Initialize button in QtPass
2. Select your GPG key(s) for encryption
3. Choose where to store your passwords (default: ~/.password-store)

Option B: Use existing store

1. If you already use pass, just point QtPass to your existing store
2. Go to Config and set the password store directory

Step 3: Add Your First Password

1. Click the + button or press Ctrl+N
2. Enter a name (e.g., github.com)
3. Add your password and any other details (username, URL, notes)
4. Click Save

Step 4: Copy Password to Clipboard

1. Select the password entry in the list
2. Press Ctrl+C or click the copy button
3. The password is copied and will auto-clear after configurable seconds

Step 5: Sync Across Devices (Optional)

QtPass works great with Git for syncing your password store:

1. Initialize a Git repository in your password store
2. Add a remote (GitHub, GitLab, self-hosted, etc.)
3. QtPass can automatically push/pull changes

Next Steps

• FAQ - Common questions and answers
• Security Considerations - Important security notes
• Downloads - More installation options
• API Documentation - Developer documentation