BTCRecover is a free, open-source tool for people who want to regain access to their own cryptocurrency wallet after forgetting part of a password or seed phrase. It is aimed at users who still have partial knowledge of their secret and want to try systematic guesses against it on their own computer.
The program is designed for personal recovery only. It does not attempt to reach wallets belonging to anyone else, and it runs entirely locally, so your secrets are not sent to a remote service. Note that the project has had no code updates since December 2017, so treat it as a mature but unmaintained tool and check the official repository before you start.
What Is BTCRecover and Who Is It For?
BTCRecover is a command-line recovery tool written in Python. It is built for individuals who lost access to a wallet they own, usually because they remember most of a password or most words of a seed phrase but cannot complete the rest.
Typical users include people who wrote a seed phrase with a few letters smudged, someone who changed a wallet password years ago and only recalls its general structure, or someone who ordered the words of a seed phrase out of sequence. The tool is not suited to beginners who have no partial information at all, since the search space grows very quickly without clues.
How Partial Recovery Searches Work
Recovery tools do not reveal a password directly. Instead they generate candidate passwords or seed combinations from the pattern you define and test each candidate against the wallet data. The more precise your clues, the smaller the set of candidates and the faster the result.
For seed phrases, the BIP39 standard uses a fixed list of 2048 words and a built-in checksum. That checksum is what lets a tool reject invalid combinations quickly. Understanding this is useful, because it explains why guessing an entire seed from nothing is impractical, while filling in two or three uncertain words is often feasible.
Practical Scenarios Where It Helps
Consider a user who wrote a 24-word seed on paper decades ago and now cannot read two of the words. With the other words intact and the word positions known, a targeted search can test only the plausible options. Another common case is a wallet password that follows a familiar pattern, such as a base word with a year and a symbol added, where restricting the character set cuts the work dramatically.
In both cases the recovery is only as good as the clues you bring. Without an address to check against or any reliable fragment, no tool can produce a result.
Key Terms Explained for Beginners
A seed phrase, sometimes called a mnemonic, is a list of words from which a wallet derives its private keys. A passphrase is an optional extra word or phrase that some wallets add on top of the seed; it is not stored anywhere and is easy to forget. A hardware wallet such as Ledger, Trezor, Coldcard, Blockstream Jade or KeePassXC-style setups keep keys on a device, but recovery of their seeds follows the same principles.
An address database is a list of wallet addresses you already own, used by the tool to confirm that a candidate seed produces a real account. Understanding these terms before you start will save hours of confusion.
Key features
Seed and passphrase recovery
Support for several blockchains
Customizable search strategies
Runs fully offline
Supported coins
BTCRecover's documentation mentions a broad range of networks, including Bitcoin, Ethereum, Litecoin, Dogecoin, Bitcoin Cash, Solana, Cardano, Polkadot, XRP, Stellar, Dash, Cosmos, Avalanche, Tezos and DigiByte. Support for each network depends on the address format and the recovery mode, so check the documentation for the exact combination you need. The tool works with SHA-256 and Scrypt based wallet formats, and it is compatible with wallets from Ledger, Trezor, Coldcard, Blockstream Jade and KeepKey.
How to install BTCRecover on Windows
- 1
Download from the official source
Download only from the official website or the project's GitHub Releases page. Do not use mirrors or third-party download sites, because a modified copy could steal your seed phrase.
- 2
Verify the file
Compare the SHA-256 checksum of the downloaded archive with the value published by the developers. On Windows you can run certutil -hashfile followed by the file name in a Command Prompt window. If the values do not match, discard the file.
- 3
Extract and set up Python
BTCRecover is a Python script, so you need a supported Python version, which the documentation lists as 3.10 through 3.14. Install Python from python.org, enable the option to add it to PATH, and confirm the installation from a terminal.
-
Install dependencies and run
Follow the installation guide in the repository to install the required Python packages with pip, then launch the script from the command line. Start with a test wallet or a harmless example to become familiar with the options before touching real funds.
System requirements
- Windows with a Python environment capable of running versions 3.10 to 3.14
- Enough free disk space for the program and any address database you create
- Command-line access, since the tool is operated from a terminal
How to use BTCRecover
BTCRecover runs from the command line, so the workflow is more technical than a typical desktop application. Work carefully and keep notes of every setting you change.
- Prepare a list of everything you remember, including word positions, approximate character counts and any patterns.
- Create an address database from addresses you already own, if the recovery mode requires it.
- Open a terminal in the BTCRecover folder and review the available options in the documentation.
- Configure the search with your known fragments so the candidate space stays small.
- Run the tool on a test case first to confirm that it behaves as expected.
- Start the real recovery on your own machine and let it run until it reports a match or finishes the search.
- When a match is found, immediately move the recovered funds to a new wallet with a freshly generated seed, and store the new seed offline.
Pros & cons
- Free and open source under the GPLv2 license, so the code can be inspected
- Runs locally, so secrets are not sent to a third party
- Supports a wide range of seed and passphrase scenarios
- Flexible search settings that reward good memory clues
- No code updates since December 2017, which raises compatibility and security concerns
- Requires a command-line workflow and some Python setup
- No graphical interface for beginners
- Recovery without partial information is impractical
Is BTCRecover safe?
Because BTCRecover handles seed phrases and wallet secrets, safety matters more than usual. Download only from the official website or GitHub, and verify the SHA-256 checksum before running anything. Never enter your seed phrase into a website, chat or online recovery service that claims to do the work for you; scammers often imitate recovery tools to collect secrets.
Because the project has not been updated since 2017, review the source code yourself or ask someone you trust to do so before you run it. Keep the tool and your wallet data on a clean, offline or well protected computer whenever possible, and move recovered funds promptly into a new wallet.
- Official source only. Download from github.com/3rditeration/btcrecover. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
BTCRecover is a specialized tool for recovering wallet secrets from partial information, which sets it apart from general-purpose utilities. Hashcat, for example, is a password cracking engine that can also target wallet files, but it requires more manual setup of hash formats and attack modes. KeePassXC is a password manager, not a recovery tool, and its value lies in preventing forgotten passwords in the first place.
If your goal is to protect your secrets for the future, a password manager or encrypted backup such as VeraCrypt or Cryptomator may serve you better than recovery software. BTCRecover is most useful when a secret has already been lost and partial memory of it remains.
Specifications
- Price
- Free
- Type
- Open source
- License
- GPLv2
- Latest version
- —
- Last update
- 21 Dec 2017
- Windows support
- Yes (official Windows version)
- Source code
- github.com/3rditeration/btcrecover
Frequently asked questions
Yes. BTCRecover is free and released as open source under the GPLv2 license. You can download it from the official repository without paying anything. Check the license terms in the repository if you plan to redistribute or modify it.
Not in practice. Recovery depends on having partial information, such as most of the words, their positions or a known address. A seed with no clues involves an impossibly large search, so the tool is designed for partial recovery only.
It can be, if you download it from the official source, verify the SHA-256 checksum and review the code. Never enter your seed phrase into websites or services that offer to run the tool for you, and move any recovered funds to a new wallet.
Software that has not been updated for years may not work with newer Python versions or wallet formats, and any security issues found since then will not be patched. Test it carefully and make sure you understand what it does before using it with real funds.
BTCRecover is designed to run locally on your computer, so your seed fragments and passwords are processed on your machine. Still, verify this yourself by reviewing the source code, especially given the project's age.
The documentation mentions compatibility with wallets from Ledger, Trezor, Coldcard, Blockstream Jade and KeepKey. Confirm that your specific wallet model and recovery scenario are covered in the official documentation before starting.
You need a Windows computer with a supported Python version, the BTCRecover files from the official source, and as much accurate information about your secret as possible. Command-line familiarity helps a great deal.
Verdict
BTCRecover is a legitimate, free tool for people who have partially lost access to their own wallet and can supply solid clues about the missing secret. It runs locally and is open source, which is an advantage. However, its lack of updates since 2017 and its command-line nature make it a poor choice for casual users. Check the official repository for the latest status, follow the safety steps carefully and proceed only with wallets you own.