decrypt_bitcoinj_seed.pyw

• a simple Python script which decrypts and displays the seed mnemonic from from a bitcoinj-based HD wallet file
• supported on Windows and Linux
• currently supports:
  • MultiBit HD (mbhd.wallet.aes files)
  • Bitcoin Wallet for Android 4.0+ wallet files (requires root)
  • Bitcoin Wallet for Android 4.0+ encrypted backup files

Warning

Working with an unencrypted seed is risky. If you are uncertain whether or not your computer is completely free of malware, you should not run this nor any other program that can affect your finances.

Even if you are certain you are currently free of malware, it is strongly advised that you not store an unencrypted seed to your hard drive.

Installation

Just download the latest version from https://github.com/gurnec/decrypt_bitcoinj_seed/archive/master.zip and unzip it to a location of your choice. There’s no installation procedure for the Python script itself, however there are additional requirements below depending on your operating system.

Windows

• Python 2.7 – visit the download page here: https://www.python.org/downloads/windows/, and click the link for the latest Python 2 release. Download and run either the Windows x86 MSI installer for the 32-bit version of Python, or the Windows x86-64 MSI installer for the 64-bit one. If you're unsure which one is compatible with your PC, choose the 32-bit one.
• Google Protobuf and pylibscrypt for Python – choose one of the following two installation methods:
  • Automated installation: right-click on the included install-windows-requirements.ps1 file and choose Run with Powershell. Automated installation typically only works with Windows Vista SP1 and higher (including Windows 7+), but it doesn't hurt to try with other versions of Windows.
  • Manual installation:
    1. You must have Python 2.7.9 or later (or you must manually install Python pip).
    2. Open a command prompt (Start -> Run, type cmd and click OK).
    3. Type this at the command prompt: C:\Python27\Scripts\pip install protobuf pylibscrypt, and then press the Enter key.

Linux

• Python 2.7.x – most distributions include this pre-installed.

• Tkinter for Python – some distributions include this pre-installed, check your distribution’s package management system to see if this is available. It is often called “python-tk”.

• Google Protobuf and pylibscrypt for Python - use PyPI, for example on Debian-like distributions:

   sudo apt-get install python-pip
   sudo pip install protobuf pylibscrypt
  

How to Use

Simply double-click decrypt_bitcoinj_seed.pyw and choose your wallet file in the file selection dialog. Please note that some wallet files may take several minutes to decrypt (if you don't have one of the optional libraries installed).

Credits

Third-party libraries distributed with decrypt_bitcoinj_seed.pyw include:

• aespython, please see aespython/README.txt for more information

• bitcoinj wallet protobuf, please see wallet.proto for more information