Skip to content


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:


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.