# KeychainPGP — Full Documentation for LLMs > Simple, cross-platform OpenPGP encryption for your clipboard. ## Project Summary KeychainPGP is a free, open-source application that makes PGP encryption accessible through a clipboard-first workflow. Instead of managing files and command-line tools, users simply copy text, press a hotkey to encrypt or decrypt, and paste the result. ## Architecture KeychainPGP is built as a Rust workspace with 6 crates: - **keychainpgp-core**: Cryptographic engine using Sequoia-PGP. Pure computation, no I/O. - **keychainpgp-keys**: Keyring management with SQLite + OS credential store + file fallback. - **keychainpgp-clipboard**: Clipboard monitoring, PGP content detection, auto-clear. - **keychainpgp-ui**: Tauri v2 desktop/mobile app with Svelte 5 frontend. - **keychainpgp-cli**: Command-line interface binary. - **keychainpgp-wasm**: WebAssembly bindings for browser use. ## Platforms & Downloads | Platform | Format | Download | |----------|--------|----------| | Windows | .msi, .exe (NSIS) | GitHub Releases | | macOS | .dmg | GitHub Releases | | Linux | .deb, .AppImage | GitHub Releases | | Android | .apk (per-ABI) | GitHub Releases | | Web | Browser app (WASM) | https://keychainpgp.github.io | All downloads: https://github.com/keychainpgp/keychainpgp/releases ## Cryptography - **Key type**: Ed25519 (signing) + X25519 (encryption) — modern elliptic curve cryptography - **Library**: Sequoia-PGP (Rust implementation of OpenPGP RFC 4880) - **Backend**: crypto-rust (pure Rust, no OpenSSL dependency) - **Key storage**: SQLite database + OS credential store (Windows Credential Manager, macOS Keychain, Linux Secret Service) - **Passphrase handling**: Optional passphrase protection with zeroization on drop ## Features ### Core - Generate PGP key pairs (Ed25519 + X25519) - Encrypt messages to one or multiple recipients - Decrypt messages with automatic key matching - Sign messages with detached signatures - Verify signatures with automatic signer detection - Import/export keys (ASCII-armored) ### Desktop - Global hotkeys: Ctrl+Shift+E (encrypt), Ctrl+Shift+D (decrypt) - System tray with quick actions - Clipboard auto-clear after 30 seconds - Clipboard monitoring for automatic PGP detection ### Security - OPSEC mode: disguise window title, RAM-only keys, panic wipe button - Tor proxy support for network operations - No telemetry, no tracking, no user accounts - Passphrase cache with configurable timeout ### Mobile (Android) - Same core functionality as desktop - QR code key exchange - Key sync with desktop via encrypted export/import ### Web App - Full PGP operations in the browser via WebAssembly - IndexedDB key storage with AES-256-GCM encryption - Session-based wrapping key (keys cleared on tab close) - No server communication — everything runs locally ## Internationalization 20 languages: English, French, German, Spanish, Portuguese (BR), Portuguese (PT), Italian, Dutch, Russian, Ukrainian, Simplified Chinese, Traditional Chinese, Japanese, Korean, Arabic, Hebrew, Turkish, Polish, Hindi, Thai. ## How to Use 1. Install KeychainPGP for your platform 2. Generate a key pair (name + email, optional passphrase) 3. Share your public key with contacts 4. Import contacts' public keys 5. Copy text → Press Ctrl+Shift+E → Select recipient → Paste encrypted message 6. Copy encrypted message → Press Ctrl+Shift+D → Read decrypted text ## What is PGP? PGP (Pretty Good Privacy) is the gold standard for encrypting messages, emails, and files. Created by Phil Zimmermann in 1991, it uses public-key cryptography: you encrypt a message with someone's public key, and only their private key can decrypt it. The OpenPGP standard (RFC 4880) ensures interoperability between implementations. KeychainPGP implements the OpenPGP standard using Sequoia-PGP (Rust) with modern Ed25519 + X25519 elliptic curve keys, providing equivalent security to RSA-3072 at a fraction of the key size. ## PGP vs GPG - **PGP**: The original encryption standard created by Phil Zimmermann (1991). Now a commercial product owned by Broadcom. - **GPG (GnuPG)**: Free, open-source implementation of OpenPGP. CLI-based, the industry standard. - **OpenPGP**: The IETF standard (RFC 4880) defining the message format. All interoperable PGP tools implement this. - **KeychainPGP**: Modern implementation using Sequoia-PGP (Rust). Clipboard-first workflow, GUI-focused, cross-platform. ## Clipboard Encryption KeychainPGP pioneered the clipboard-first approach to PGP: 1. Copy text from any application 2. Press Ctrl+Shift+E (or use the web app Encrypt button) 3. Select recipient 4. Paste the encrypted PGP message anywhere Security features: - Clipboard auto-clear after 30 seconds - Memory zeroization on drop (Rust safety) - OPSEC mode: disguised window title, RAM-only keys, panic wipe - No clipboard history leakage (optional) ## Frequently Asked Questions **Is it safe to encrypt PGP messages online?** Yes, with KeychainPGP's web app. All encryption happens locally via WebAssembly. No data is sent to any server. **Is PGP still secure in 2026?** Yes. PGP with modern algorithms (Ed25519/X25519) remains one of the strongest encryption standards. The mathematical foundations have not been broken. **Can I use PGP without installing software?** Yes. KeychainPGP offers a web app that runs entirely in your browser via WebAssembly. **What algorithms does KeychainPGP use?** Ed25519 for signatures, X25519 for key agreement. Powered by Sequoia-PGP with no OpenSSL dependency. **Is KeychainPGP free?** Yes. 100% free and open source (MIT/Apache-2.0). No paid tiers, no accounts, no telemetry. ## Documentation - Online PGP Tool: https://keychainpgp.org/pgp-online-encrypt/ - What is PGP: https://keychainpgp.org/docs/what-is-pgp/ - How to Use PGP: https://keychainpgp.org/docs/how-to-use-pgp/ - PGP vs GPG: https://keychainpgp.org/docs/pgp-vs-gpg/ - PGP Tools: https://keychainpgp.org/docs/pgp-tools/ - PGP for Beginners: https://keychainpgp.org/docs/pgp-for-beginners/ - Clipboard Encryption: https://keychainpgp.org/docs/clipboard-encryption/ - Best PGP Tools 2026: https://keychainpgp.org/blog/best-pgp-tools-2026/ - PGP Software Comparison: https://keychainpgp.org/blog/pgp-software-comparison/ ## Links - Website: https://keychainpgp.org - Web App: https://keychainpgp.github.io - Source Code: https://github.com/keychainpgp/keychainpgp - Releases: https://github.com/keychainpgp/keychainpgp/releases - License: MIT / Apache-2.0 ## Donations KeychainPGP is free and open source. Donations are accepted in cryptocurrency: - Bitcoin: bc1qed0rtdgxq5t9g5lrsztxqvw9gnz4s2wd3gner3 - Ethereum: 0xD2Ca6c40f03Db5A0493012C7D2792e69C8C493D8 - Monero: 898XvFtvBMmes31kNwF4AJiNHsaWZA5aGLqf1jZT5ZZXPGCL4AgNAgZUgw9o6d3tg17fks3q1i4tWJ69tHAhh9MpQLLFGrf