Skip to content

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.

License

Notifications You must be signed in to change notification settings

psefro/btcrecover

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

btcrecover Build Status 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 you have a known address you have used for:
    • Bitcoin
    • Bitcoin Cash
    • Ethereum
    • Litecoin
    • Dash
    • Dogecoin
    • Vertcoin
    • Monacoin
    • DigiByte
    • And many other 'Bitcoin Like' cryptos
  • Seed/Passphrase recovery via Address DB (Where you don't need to know an address to search for) supporting:
    • Bitcoin
    • Bitcoin Cash
    • Litecoin
    • Vertcoin
    • Monacoin
    • DigiByte
    • Likely 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 (Listed below)

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

I have created a growing playlist that covers a number of usage examples for using this tool to recover seed phrases, BIP39 passphrases, etc.

This repositoy 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.

Sending me a message via Reddit is likely the best channel to reach me for support with this tool.

If you don't know an address in the wallet that you are searching for, you can create and use an Address Database 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.

If this tool or other content on my YouTube channel was helpful, feel free to send a tip to:

Donate Bitcoin

BTC: 37N7B7sdHahCXTcMJgEnHz7YmiR4bEqCrS

Donate Bitcoin Cash

BCH: qpvjee5vwwsv78xc28kwgd3m9mnn5adargxd94kmrt

Donate Litecoin

LTC: M966MQte7agAzdCZe5ssHo7g9VriwXgyqM

Donate Ethereum

ETH: 0x72343f2806428dbbc2C11a83A1844912184b4243

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)

Donate Bitcoin

BTC: 3Au8ZodNHPei7MQiSVAWb7NB2yqsb48GW4

Thank You!

Features

About

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.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 98.5%
  • Other 1.5%