Skip to main content
BTCRecover is a free, open source command-line tool that helps you recover lost or forgotten wallet passwords and seed phrases. Whether you remember most of your password but need to try variations, or you have a seed phrase with a typo or missing word, BTCRecover automates the search.

Installation

Install BTCRecover on Windows, Linux, macOS, or Android

Password Recovery

Recover wallet passwords using token lists and typo simulation

Seed Recovery

Recover BIP39/SLIP39 seed phrases for 25+ cryptocurrencies

Supported Wallets

Browse the full list of supported wallets and coin types

How it works

BTCRecover works by systematically generating password or seed phrase candidates based on what you remember, then testing each candidate against your wallet. You provide hints — fragments you remember, likely typos, possible word substitutions — and BTCRecover handles the combinatorial search.
1

Install Python and dependencies

BTCRecover requires Python 3.9+ and a few pip packages. Follow the installation guide for your operating system.
2

Choose your recovery type

Use btcrecover.py for wallet password recovery, or seedrecover.py for seed phrase recovery.
3

Describe what you remember

Create a token list of password fragments, or enter your best guess at your seed phrase with the words you’re uncertain about.
4

Run the recovery

BTCRecover searches all combinations, shows a progress bar with ETA, and prints the result when found.

Key features

Token lists

Assemble passwords from remembered fragments with flexible combination rules

Typo simulation

Automatically try case changes, swaps, deletions, repeats, and custom mappings

GPU acceleration

Up to 96x speedup on Bitcoin Core passwords using OpenCL

Address Database

Recover seeds without knowing any address using a blockchain-derived database

Extract scripts

Extract just enough wallet data for offline recovery — no private keys exposed

Multi-device

Split large searches across multiple machines or GPU instances
BTCRecover is distributed under the GPL-2.0 license. Always run it on copies of your wallet files — never on originals.

Build docs developers (and LLMs) love