# gurnec/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.

Repository: https://github.com/gurnec/btcrecover
Canonical: https://ross.abutalabs.com/products/btcrecover
Language: Python
License: GPL-2.0
License Family: copyleft
Topics: bitcoin, password-recovery
Last push: 2024-08-02T04:13:10+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4528, "days_push": 761, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1580, forks 860 (observed 2026-08-28T04:05:06.910752+00:00)

## What it is
btcrecover is an open-source Python command-line tool for recovering Bitcoin (and altcoin) wallet passwords and seed phrases when most of the password or mnemonic is already known. It supports many wallets including Bitcoin Core, Electrum, MultiBit, Blockchain.info, BIP-39 hardware wallet passphrases, and Ethereum seeds.

## Use cases
- recover a forgotten bitcoin wallet password when I remember most of it
- try different combinations of a partially known BIP-39 seed phrase
- recover an Electrum seed with a typo in one word
- crack a Blockchain.info wallet file password
- recover a TREZOR or Ledger BIP-39 passphrase
- recover a MultiBit HD wallet password
- recover an Ethereum wallet seed phrase
- brute force a Bitcoin Core wallet.dat password

## When to choose
- you already know most of your wallet password or seed and need to test variations
- your wallet is one of the many supported formats (Bitcoin Core, Electrum, MultiBit, BIP-39, etc.)
- you want an open-source, scriptable recovery tool with GPU acceleration options

## When to avoid
- you have no memory of the password or seed at all (pure brute force is impractical)
- your wallet software is not among the supported formats
- you need a graphical point-and-click recovery tool

## Facets
- artifact type: cli-tool
- maturity: active
- function: security, cryptography, cli
- domain: security
- platform: python, cross-platform, cli
- tags: bitcoin, password-recovery, seed-recovery, wallet, brute-force, bip39, ethereum, cryptocurrency, command-line

## Member repositories
- gurnec/btcrecover (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:06.910752+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:56:36.758412+00:00, confidence not recorded.
  - readme: https://github.com/gurnec/btcrecover (fetched 2026-08-28T04:05:06.910752+00:00, sha 889eaf00010f)
- Data as of 2026-08-30T08:39:29.467469+00:00.