/btcrecover

An open source Bitcoin wallet password and seed recovery tool designed for the case where you already know most of your password/seed, but need assistance in trying different possible combinations.

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

btcrecover - BIP-38 Version license

btcrecover is an open source wallet password and seed recovery tool. It is designed for the case where you already know most of your password or seed phrase, but need assistance in trying different possible combinations.

  • Seed/Passphrase Recovery when for: (Recovery without a known address requires an Address Database)
    • Bitcoin
    • Bitcoin Cash
    • Ethereum
    • Litecoin
    • Dash
    • Dogecoin
    • Vertcoin
    • Monacoin
    • DigiByte
    • Groestlcoin
    • 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

If you want the tool to support a crypto 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.

Setup and Usage Tutorials

BTCRecover is a Python (3.6+) script so will run on Windows, Linux and Mac environments. See the installation guide for more info

This repository also included some example commands and file templates for the usage scenarios covered in YouTube videos.

My suggestion is that you find a scenario that is most-like your situation and try to replicate my examples to ensure that you have the tool set up and running correctly. If you have a specific situation that isn't covered in these tutorials, let me know and I can look into creating a video for that.

You can reach me via the Code Warriors Telegram channel. (https://t.me/Code_Warriors)

If you don't know an address in the wallet that you are searching for, you can create and use an Address Database (click here for guide) There is no real performance penalty for doing this, it just takes a bit more work to set up.

Quick Start

To try recovering your password or a BIP39 passphrase, please start with the Password Recovery Quick Start.

If you mostly know your recovery seed/mnemonic (12-24 recovery words), but think there may be a mistake in it, please see the Seed Recovery Quick Start.

Thanks to Gurnec

This tool builds on the original work of Gurnec who created it and maintained it until late 2017. If you find btcrecover helpful, please consider a small donation to them too. (I will also be passing on a portion of any tips I recieve at the addys above to them too)

Features