Skip to content

BTCRecover

Last Push - All Tests (Base Modules) Weekly - All Tests (Base Modules) Weekly Run All Tests (Base Modules) Documentation Status license

BTCRecover is an open source wallet password and seed recovery tool.

For seed based recovery, this is primarily useful in situations where you have lost/forgotten parts of your mnemonic, or have made an error transcribing it. (So you are either seeing an empty wallet or gettign an error that your seed is invalid)

For wallet password or passphrase recovery, it is primarily useful if you have a reasonable idea about what your password might be.

Getting Started

Your best bet is to follow the Installing BTCRecover guide, then read the "Quick Start" for the recovery type you want. (Or look at some usage examples)

Getting Support

If you need help, your best bet is to look at my BTCRecover playlist on YouTube and ask a question in the comments section for any of video closest to your situation.

If you have found a bug, please open an issue on Github here: https://github.com/3rdIteration/btcrecover/issues

Features

  • Seed/Passphrase Recovery when for: (Recovery without a known address requires an Address Database)
    • Bitcoin
    • Bitcoin Cash
    • Cardano (Shelley Era Addresses)
    • Ethereum
    • Litecoin
    • Dash
    • Dogecoin
    • Vertcoin
    • Monacoin
    • DigiByte
    • Groestlcoin (Requires groestlcoin_hash module installed via PIP)
    • Ripple
    • Zilliqa
    • And many other 'Bitcoin Like' cryptos
  • Descrambling 12 word seeds (Using Tokenlist feature for BIP39 seeds via seedrecover.py)
  • Wallet File password recovery for a range of wallets

  • Seed Phrase (Mnemonic) Recovery for the following wallets

  • Bitcoin wallet password recovery support for:
  • Altcoin password recovery support for most wallets derived from one of those above, including:
  • Free and Open Source - anyone can download, inspect, use, and redistribute this software
  • Supported on Windows, Linux, and OS X
  • Support for Unicode passwords and seeds
  • Multithreaded searches, with user-selectable thread count
  • Ability to spread search workload over multiple devices
  • GPU acceleration for Bitcoin Core Passwords, Blockchain.com (Main and Second Password), Electrum Passwords + BIP39 and Electrum Seeds
  • Wildcard expansion for passwords
  • Typo simulation for passwords and seeds
  • Progress bar and ETA display (at the command line)
  • Optional autosave - interrupt and continue password recoveries without losing progress
  • Automated seed recovery with a simple graphical user interface
  • Ability to search multiple derivation paths simultaneously for a given seed via --pathlist command (example pathlist files in the )
  • “Offline” mode for nearly all supported wallets - use one of the extract scripts (click for more information) to extract just enough information to attempt password recovery, without giving btcrecover or whoever runs it access to any of the addresses or private keys in your Bitcoin wallet.

If you want the tool to support a crypto/wallet that isn't listed above, please test that it works and submit a PR which includes a unit test for that coin and also any required code to accept the address format.

If you are trying to do a recovery for a coin/wallet that isn't listed above, feel free to contact me as it may be possible for you to sponsor the addition of that crypto as part of an assisted recovery fee.