PC-Unlocker

Grafisches Offline-Recovery-Tool für lokale Benutzerkonten unter Linux und Windows, ausgeliefert als bootfähige Live-ISO. Gedacht für IT-Admins und das Zurücksetzen vergessener Passwörter auf Maschinen, zu denen man physischen Zugang und die Berechtigung hat (eigener Rechner, verwaltete Firmen-PCs, Konten ausgeschiedener Mitarbeiter).

Gleiche Kategorie wie chntpw, Trinity Rescue Kit oder System Rescue CD.

Was es kann

	Linux	Windows
Passwort leeren (blank)	✅	✅
Neues Passwort setzen	✅ (SHA-512)	❌ siehe Hinweis
Konto entsperren	✅	✅
Zu Admin machen	—	✅

Hinweis Windows: Ein neues Passwort direkt in die SAM zu schreiben ist auf modernen Windows-Versionen unzuverlässig (SYSKEY / geänderte Hash-Formate). Verlässlicher Weg: Passwort leeren, anmelden, in Windows neu vergeben.

Grenzen (bewusst)

Verschlüsselte Datenträger (BitLocker, LUKS) bleiben geschützt — das Tool kann die Verschlüsselung nicht umgehen. Ohne den jeweiligen Schlüssel/Recovery-Key ist die Partition nicht les- oder schreibbar.

Bedienung

1. ISO auf USB-Stick schreiben (siehe unten) und Zielrechner davon booten.
2. Das Live-System startet automatisch in die GUI.
3. Partition wählen → Öffnen / Mounten → erkannte Konten erscheinen.
4. Konto wählen → gewünschte Aktion. Vor dem Beenden hängt das Tool alles sauber aus.

ISO bauen

Einzige Voraussetzung auf dem Build-Host: Docker. Sonst muss nichts installiert sein — live-build und alle Werkzeuge laufen im Container.

./build.sh
# Ergebnis: ./out/pc-unlocker.iso

Auf USB-Stick schreiben:

sudo dd if=out/pc-unlocker.iso of=/dev/sdX bs=4M status=progress conv=fsync

Der Container läuft mit --privileged, weil live-build Loop-Devices und Mounts benötigt.

Release veröffentlichen

release.py zählt die Version hoch, pflegt das CHANGELOG, committet + taggt, baut die ISO und veröffentlicht sie als Gitea-Release mit der ISO als Anhang.

./release.py            # Patch: 0.1.0 -> 0.1.1
./release.py --minor    # 0.1.0 -> 0.2.0
./release.py --major    # 0.1.0 -> 1.0.0
./release.py --no-build # vorhandene out/pc-unlocker.iso anhängen
./release.py --no-publish  # nur lokal (bump, commit, tag, build)
./release.py --dry-run  # nur anzeigen

Veröffentlichen pusht Release-Commit und Tag nach origin und ruft dann tea release create. Einmalig nötig: tea login add für die Gitea-Instanz.

App direkt testen (ohne ISO)

Auf einem Linux-Host mit python3-tk, chntpw, ntfs-3g:

sudo python3 app/pc_unlocker.py

Projektstruktur

app/pc_unlocker.py     GUI (tkinter)
app/puk/disks.py       Datenträger auflisten/mounten
app/puk/linux.py       /etc/shadow bearbeiten
app/puk/windows.py     SAM via chntpw bearbeiten
config/                live-build Paketlisten + Autostart-Hook
build/Dockerfile       Build-Container (Debian + live-build)
build/build-iso.sh     Build-Logik im Container
build.sh               Host-Einstieg: Docker bauen + ISO erzeugen

Rechtlicher Hinweis

Nur auf Systemen einsetzen, die dir gehören oder für die du ausdrücklich autorisiert bist. Der unbefugte Zugriff auf fremde Computer ist strafbar.