Doc Unlocker

Recover the password of a Microsoft Office or PDF document you own - with a friendly GUI, smart guessing, and optional GPU acceleration.

Use it responsibly

Doc Unlocker is a password-recovery tool for documents you own or are explicitly authorised to access - for example, a file whose password you forgot. Do not use it on documents you have no right to open. You are responsible for how you use this software. See the MIT License.

---

What it does

You point it at a password-protected document and it tries to find the password so it can produce an unlocked copy (Unlocked_<yourfile>).

Supported files: Microsoft Word (.docx/.docm/.doc), Excel (.xlsx/.xlsm/.xls), PowerPoint (.pptx/.pptm/.ppt), and PDF (.pdf).

It works on two levels.

A. Smart CPU guessing

• Built-in common passwords and common words (multilingual).
• Live mutations: capitalisation, numbers, years, symbols, and leetspeak (amani becomes Amani2024, Am@ni!, and so on).
• Word + date patterns (e.g. Summer1990, Love2025!).
• Optional two-word combinations.
• Optional numeric-PIN sweep (1-12 digits).
• Bring your own wordlist for a targeted attack.

B. GPU acceleration (via Hashcat)

For modern Office encryption (AES-256 / SHA-512 / 100,000 iterations, Hashcat mode -m 9600), the CPU is slow by design. Doc Unlocker can hand the work to your GPU:

Button	What it does
Get Hashcat	Downloads and unpacks Hashcat next to the app (one click).
Test GPU	Runs hashcat -I and tells you if your GPU is detected.
Run Hashcat now	Builds a smart wordlist + hash, runs the attack, and auto-creates the unlocked copy when it succeeds.
GPU brute-force (all combos)	A mask attack that tries every combination of a chosen character set / length - with a keyspace and time estimate first.
Export for GPU	Generates the wordlist, hash, and a ready-to-run run_hashcat.bat.

GPU acceleration currently targets Office files only. PDFs are handled by the CPU path (smart guessing / Unlock with known password); PDF GPU modes are planned for a future release.

C. Quality-of-life

• Modern rounded interface with a Light / Dark / System theme.
• Settings panel (gear icon): theme, rounded/sharp corners, launch maximised, finish notifications + sound, and a "Check for updates" button.
• Live tries counter, speed, and estimated time remaining.
• Resume: tried passwords are remembered per file and skipped next time.
• Unlock with known password if you already have it.

---

Interface

A clean two-pane layout: your inputs and options on the left, GPU/utility actions on the right, and a live progress/status bar along the bottom - in both light and dark themes.

Tip: drop screenshots into assets/ and reference them here.

---

Installation

Option A - Download the ready-made build (easiest)

1. Go to the Releases page.
2. Download the latest asset for your platform:
   • Windows: DocUnlocker-vX.Y.Z.exe (double-click; no Python needed).
   • Android: DocUnlocker-vX.Y.Z.apk (enable "install unknown apps", then open the APK). Barebone build - Office files only for now.

Option B - Run from source (Windows)

git clone https://github.com/Fallax-Vision/doc_unlocker.git
cd doc_unlocker
py -m pip install -r requirements.txt
py doc_unlocker.py

On first launch the app will offer to install its small dependencies (msoffcrypto-tool, olefile, pypdf, customtkinter) automatically if they are missing.

Hashcat is optional. Click Get Hashcat inside the app to fetch it, or install it yourself from hashcat.net and make sure hashcat.exe is on your PATH.

---

Quick start

1. Browse to your locked document.
2. (Optional) pick a wordlist and tweak the Options.
3. Click Start Unlocking for the CPU attack, or Get Hashcat then Test GPU then Run Hashcat now for the fast GPU path.
4. When the password is found, an Unlocked_<yourfile> copy appears in the same folder, and the password is written to DocUnlocker_found.log.

---

How it works (under the hood)

• For Office files: reads the document's EncryptionInfo and builds a Hashcat-compatible $office$*2013*... hash natively in Python (olefile).
• Verifies a candidate by actually decrypting the file and checking the output is a valid document - so it never reports a false success.
• Uses msoffcrypto-tool for Office decryption, pypdf for PDFs, and Hashcat for GPU cracking of Office files.

---

Building the .exe yourself

py -m pip install --user pyinstaller
py build_exe.py
# -> dist/DocUnlocker.exe

The .exe is intentionally git-ignored; it is distributed as a Release asset, not committed to the repo.

---

Contributing - help wanted

This is a community project and contributions are very welcome.

We especially need help building macOS and Linux versions. The core logic is cross-platform Python, but the GUI styling, the Hashcat download/unpack step, and packaging (.app / AppImage / .deb) need work and testing on those platforms. If you can help:

1. Open an issue describing what you would like to tackle.
2. Fork the repo and create a feature branch.
3. Send a pull request.

Other good first issues: app screenshots, more wordlists, translations, and CI improvements. See CONTRIBUTING.md.

---

Roadmap

• macOS build (.app) and Linux build (AppImage / .deb)
• In-app screenshots
• Drag-and-drop a file onto the window
• Optional CUDA backend hint / device picker
• Auto-update check against the GitHub Releases API

---

License

Released under the MIT License - completely free to use, modify, redistribute, and even commercialise. Attribution appreciated but not required.

---

Made by Fallax Vision and contributors.