Two recovery modes
Password recovery
Recover the password or BIP-39 passphrase for a wallet file. Provide remembered fragments in a token list and BTCRecover tries every combination.
Seed recovery
Recover a BIP-39 or Electrum seed phrase that has typos, missing words, or wrong words.
seedrecover.py includes a GUI for guided recovery.Supported cryptocurrencies
BTCRecover supports seed and passphrase recovery for more than 25 networks:| Category | Networks |
|---|---|
| Bitcoin family | Bitcoin, Bitcoin Cash, Litecoin, Dogecoin, Dash, DigiByte, Vertcoin, Monacoin, Groestlcoin |
| Ethereum & EVM | Ethereum, Zilliqa, Tron, Stacks |
| Cosmos ecosystem | Cosmos (Atom), Secret Network, and many Cosmos-based chains |
| Other | Avalanche, Polkadot (sr25519), Ripple, Solana, Stellar, Tezos, Helium, Cardano (Shelley), MultiversX, and more |
Supported wallet software
Password recovery is supported for:- Bitcoin Core, MultiBit Classic and HD, Electrum (1.x–4.x), mSIGNA
- Blockchain.com, Bither, Metamask (and clones), Coinomi, imToken
- Ethereum UTC Keystore files, BIP-38 encrypted paper wallets
- Brainwallets (SHA-256 and scrypt-secured), block.io, Dogechain.info
- Hardware wallets: Ledger, Trezor, Keepkey, Coldcard, Safepal, Bitbox02, and others
- Software wallets: Electrum, Coinomi, Exodus, Mycelium, Trust Wallet, Metamask, Wasabi, Edge, and others
Key capabilities
- Token lists — assemble candidate passwords from remembered fragments with anchors, mutual exclusion, and wildcards
- Typo simulation — automatically generate variations: caps lock, swap, repeat, delete, case, replace, and insert
- GPU acceleration — up to ~100x speedup for Bitcoin Core and Blockchain.com wallets using OpenCL
- Autosave — interrupt and resume long searches without losing progress
- Extract scripts — extract just enough wallet data for offline recovery without exposing private keys
- Multi-device — split large searches across machines or GPU instances
- Unicode support — handles non-ASCII passwords and seeds
Requirements
| Requirement | Detail |
|---|---|
| Python | 3.9, 3.10, 3.11, 3.12, or 3.13 |
| Operating systems | Windows, Linux, macOS, Android (Termux, experimental) |
| Base dependencies | pip3 install -r requirements.txt |
| Full dependencies | pip3 install -r requirements-full.txt |
BTCRecover is automatically tested against all supported Python versions (3.9–3.13) on Windows, Linux, and macOS on every release.
Get started
Installation
Install Python, pip dependencies, and verify your setup on any platform.
Password recovery quick start
Get to a working recovery command in minutes.
Seed recovery quick start
Recover a seed phrase with typos or missing words using the GUI or CLI.
Supported wallets
Browse the complete list of supported wallets and required packages.