BTCRecover: So rettest du verlorene Bitcoin-Wallets mit einem kostenlosen Tool

Wer seinen Bitcoin-Wallet-Zugang verloren hat, muss nicht aufgeben. BTCRecover ist ein kostenloses, quelloffenes Python-Tool, das dabei hilft, vergessene Passwörter, Seed-Phrasen und Passphrases systematisch wiederzufinden – vollständig offline und ohne Drittanbieter.

Was ist BTCRecover?

BTCRecover ist ein in Python geschriebenes Open-Source-Tool, das ursprünglich von Christopher Gurnee entwickelt wurde und heute aktiv von der Community gepflegt wird. Es ist auf GitHub frei verfügbar und unterstützt eine Vielzahl von Wallet-Formaten – darunter Bitcoin Core, Electrum, MultiBit, Armory, Blockchain.com und viele weitere.

Das Tool richtet sich an Nutzer, die:

• Ihr Wallet-Passwort teilweise kennen, aber Tippfehler vermuten
• Ihre BIP39-Seed-Phrase kennen, aber einzelne Wörter vergessen haben
• Die Wörter ihrer Seed-Phrase kennen, aber die Reihenfolge nicht mehr wissen
• Eine Passphrase (auch «25. Wort» genannt) vergessen haben

BTCRecover probiert keine zufälligen Kombinationen aus wie ein klassischer Brute-Force-Angriff. Stattdessen nutzt es gezielt vom Nutzer gelieferte Hinweise, um den Suchraum auf ein Minimum zu reduzieren.

Wie funktioniert BTCRecover technisch?

BTCRecover besteht aus zwei Hauptkomponenten:

• btcrecover.py – für die Wiederherstellung von Wallet-Passwörtern
• seedrecover.py – für die Wiederherstellung von Seed-Phrasen (BIP39, BIP44 etc.)

Passwort-Wiederherstellung

Das Tool nimmt eine verschlüsselte Wallet-Datei entgegen und testet systematisch Passwortvarianten. Der Nutzer gibt sogenannte Token-Listen an – Textdateien, in denen mögliche Passwortbestandteile aufgeführt werden.

Beispiel einer Token-Datei:

bitcoin
Bitcoin
%d%d%d%d
!

BTCRecover kombiniert diese Token nach definierten Regeln zu möglichen Passwörtern und testet jede Variante gegen die verschlüsselte Wallet-Datei. Das Prozentzeichen mit «d» (%d) steht dabei als Platzhalter für eine beliebige Ziffer.

Zusätzlich unterstützt das Tool automatische Typo-Korrekturen:

• Capslock versehentlich aktiv (z.B. «BITCOIN» statt «bitcoin»)
• Buchstaben vertauscht (z.B. «bitoicn»)
• Zeichen hinzugefügt oder weggelassen
• Ähnlich aussehende Zeichen verwechselt (l/1, O/0)

Seed-Phrase-Wiederherstellung

Bei der Seed-Wiederherstellung gibt der Nutzer die ihm bekannten Wörter der BIP39-Phrase an. Das Tool prüft dann fehlende Wörter, falsche Reihenfolgen und ähnlich klingende Alternativen.

Technisch funktioniert dies über eine Überprüfung des BIP39-Checksums sowie einen Adressabgleich: BTCRecover leitet aus den Testkandidaten den privaten Schlüssel ab und prüft, ob auf der daraus generierten Bitcoin-Adresse jemals eine Transaktion stattgefunden hat.

GPU-Beschleunigung

Für rechenintensive Aufgaben unterstützt BTCRecover optional GPU-Beschleunigung via OpenCL. Damit lassen sich – je nach Hardware und Wallet-Typ – Tausende bis Millionen Passworttests pro Sekunde durchführen, was die Wiederherstellungszeit erheblich verkürzt.

Installation auf macOS – Schritt für Schritt

Voraussetzungen: macOS 11 oder neuer, Internetverbindung, grundlegende Terminal-Kenntnisse.

Schritt 1: Homebrew installieren

Homebrew ist der Standard-Paketmanager für macOS. Falls noch nicht vorhanden, folgenden Befehl im Terminal ausführen:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Anschliessend das Terminal neu starten oder ausführen:

eval "$(/opt/homebrew/bin/brew shellenv)"

Schritt 2: Python 3 installieren

brew install python@3.11

Installation prüfen:

python3 --version

Schritt 3: BTCRecover herunterladen

git clone https://github.com/3rdIteration/btcrecover.git
cd btcrecover

Schritt 4: Virtuelle Umgebung erstellen (empfohlen)

python3 -m venv venv
source venv/bin/activate

Schritt 5: Abhängigkeiten installieren

pip install -r requirements.txt

Für erweiterte Wallet-Unterstützung zusätzlich:

pip install -r requirements-full.txt

Schritt 6: Installation testen

python3 btcrecover.py --help

Erscheint die Hilfeanzeige, ist die Installation erfolgreich abgeschlossen.

Schritt 7: Wallet-Datei vorbereiten

Je nach Wallet-Software befindet sich die verschlüsselte Datei an unterschiedlichen Orten:

• Bitcoin Core: ~/Library/Application Support/Bitcoin/wallet.dat
• Electrum: ~/.electrum/wallets/
• MultiBit HD: ~/Library/Application Support/MultiBitHD/

Die Datei in den BTCRecover-Ordner kopieren – niemals das Original löschen oder überschreiben.

Schritt 8: Token-Datei erstellen

Eine Textdatei tokens.txt erstellen mit möglichen Passwortbestandteilen:

meinPasswort
MeinPasswort
passwort2021
passwort2022
%d%d%d%d

Schritt 9: BTCRecover ausführen

Für eine Bitcoin Core Wallet:

python3 btcrecover.py --wallet wallet.dat --tokenlist tokens.txt

Mit Typo-Korrekturen (bis zu 2 gleichzeitige Zeichenveränderungen):

python3 btcrecover.py --wallet wallet.dat --tokenlist tokens.txt --typos 2 --typos-swap --typos-case

Seed-Phrase wiederherstellen – Kurzanleitung

Wenn beispielsweise das 12. Wort der Seed-Phrase fehlt:

python3 seedrecover.py --wallet-type bip39 --mnemonic "wort1 wort2 wort3 wort4 wort5 wort6 wort7 wort8 wort9 wort10 wort11" --addr-limit 10

BTCRecover testet dann alle 2048 möglichen BIP39-Wörter für die fehlende Position und prüft, welche Kombination eine bekannte Bitcoin-Adresse ergibt.

Sicherheitshinweise

BTCRecover verarbeitet höchst sensible Daten. Folgende Massnahmen sind unbedingt einzuhalten:

• Offline arbeiten: Den Computer während der Nutzung vom Internet trennen.
• Originaldateien schützen: Niemals mit der Original-Wallet-Datei arbeiten – immer eine Kopie verwenden.
• Keine Cloud-Dienste: Wallet-Dateien und Seed-Phrasen niemals in Cloud-Speicher hochladen.
• Vertrauenswürdige Hardware: Nur auf einem Gerät verwenden, dem man vollständig vertraut.
• Quellcode prüfen: Der Code ist auf GitHub öffentlich einsehbar und kann auf Veränderungen geprüft werden.

Unterstützte Wallets (Auswahl)

• Bitcoin Core (wallet.dat)
• Electrum (1.x, 2.x)
• MultiBit Classic & HD
• Armory
• Blockchain.com
• Bither
• Metamask
• Mycelium (Android-Backups)
• SLIP39 / Shamir Backup (Trezor)
• BIP39 (nahezu alle modernen Hardware-Wallets)

Fazit

BTCRecover ist für alle, die Teile ihres Wallet-Zugangs verloren haben, ein ausserordentlich wertvolles Werkzeug. Die Stärke liegt nicht im blinden Durchprobieren, sondern in der präzisen Nutzung von Hinweisen, die der Nutzer selbst kennt – und damit der gezielten Reduktion des Suchraums auf ein überschaubares Mass.

Wer seine Bitcoin selbst verwahrt (Self-Custody), sollte BTCRecover kennen – nicht nur als Rettungsanker im Ernstfall, sondern auch als Motivation, Backup-Strategien von Anfang an sorgfältig zu gestalten.

Weiterführende Links

• GitHub Repository – BTCRecover
• Offizielle Dokumentation
• BIP39 Wortliste (Englisch)