/btcrecover

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

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.

---------------------------------BTCRecover GPU----------------------------------

there is a test wallet.dat and tokenlist dictionary english.txt is included in repository for testing purpose

Windows Installation & use(OpenCL GPU(Intel/Nvidia/AMD GPUs)

requirements:any python version,pycryto,wheel,pyopencl wheel package,mako,wallet.dat

we will be using python 2.7

C:\Python27\btcrecover-master>pip install pycrypto mako wheel

use one of the wheel from this repository(according to the windows version 32/64 Bit)if your python version is other than 2.7 use https://www.lfd.uci.edu/~gohlke/pythonlibs/#pyopencl for appropriate wheel package

C:\Python27\btcrecover-master>pip install pyopencl-2018.1.1+cl12-cp27-cp27m-win_amd64.whl

put the wallet.dat in same folder

C:\Python27\btcrecover-master>python btcrecover.py --wallet wallet.dat --no-dupchecks --no-eta --enable-gpu --global-ws 4096 --local-ws 512 --autosave session.txt --tokenlist english.txt

Documentation:

Instructions for installation, usage & examples: https://btcrecover.readthedocs.io/

(You can also view the documentation in your browser locally by following the instructions here. )

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.

Features

Setup and Usage Tutorials

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

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 repository also included some example commands and file templates in the ./docs/ folder of the repository.

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.

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)

Thank You!