🔒 BIOS Password Cracker (Rust + egui GUI)

This only works if you are able to boot into an OS A GUI-based BIOS password brute-force tool for HP machines, written in Rust with real-time parallel attacks and a hacker-styled dark UI.
Use this tool to recover locked BIOS setups legally and ethically (e.g., forgotten supervisor password on your own hardware).

---

🧠 Features

• 🔐 Real BIOS unlock attempts using HPQPswd64.exe + BiosConfigUtility64.exe
• 🧩 Multiple attack modes: Guess-based, Rule-based, Dictionary, Hybrid
• 🎛️ GUI with dark theme (egui + eframe)
• 🚀 Fast, parallel candidate testing with rayon
• 🧠 Variant + mask-based modeling for intelligent guessing
• 📝 Thread-safe, asynchronous attempt logging
• 🧃 Custom icon support (bios_lock.png)
• 💥 Launch GUI or CLI from setup script, Git clone, or binary

---

⚙️ Technical Requirements

Requirements	Minimum Version	Recommended	Purpose
🦀 Rust	1.74+	Latest	Language / compiler
📦 Git	2.30+	Latest	Clone + version control
⬇️ HP Tools	N/A	Auto-fetched	Interact with BIOS config
🖼️ bios_lock.png	Any PNG	128×128	GUI icon (taskbar + window)
🪟 OS	Windows 10/11	64-bit	Required for BIOS execution

---

Here's a clean and professional installation guide you can paste into your GitHub README.md:

---

🔧 Installation Instructions (Windows)

This tool requires a few dependencies to build and run. The installation process is mostly automated and checks for existing tools before installing anything new.

✅ Prerequisites

• Windows 10/11 with PowerShell
• Administrator privileges (for some installations)

🧠 What This Will Do

• Install Visual Studio Build Tools (if not already installed)
• Install Rust via rustup (if not already installed)
• Install Git (if not already installed)
• Clone this repository
• Build the project using Cargo
• Run the executable

---

🚀 Quick Setup (One-Liner)

Copy and paste this into PowerShell (Run as Administrator):

Get-Command cl.exe -ErrorAction SilentlyContinue >$null || (
  Start-Process "https://aka.ms/vs/17/release/vs_buildtools.exe" -Wait;
  Start-Process "vs_buildtools.exe" -ArgumentList "--add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --passive --norestart" -Wait
);
(Get-Command rustc.exe -ErrorAction SilentlyContinue) -or (irm https://sh.rustup.rs -UseBasicParsing | iex);
$env:Path += ";$env:USERPROFILE\.cargo\bin";
git --version 2>$null || (
  Invoke-WebRequest https://github.com/git-for-windows/git/releases/download/v2.43.0.windows.1/Git-2.43.0-64-bit.exe -OutFile git-installer.exe;
  Start-Process .\git-installer.exe -Wait;
  Remove-Item .\git-installer.exe
);
if (!(Test-Path .\HP-ADMIN-UEFI-PASSWORD-BRUTEFORCE)) {
  git clone https://github.com/yourusername/HP-ADMIN-UEFI-PASSWORD-BRUTEFORCE.git
}
cd HP-ADMIN-UEFI-PASSWORD-BRUTEFORCE
cargo build --release
.\bios-password-cracker\target\release\bios-password-cracker.exe

---

📝 Notes

• The script auto-skips any tools already installed.
• Make sure to restart PowerShell if Rust or VS Build Tools were newly installed.
• Tested on Windows 10/11 x64 with WSL and bare metal setups.

---

▶️ Usage Instructions

cargo run --release

• Creates HPUtilities/ folder on first run
• Downloads required HP EXEs automatically
• Opens GUI to configure and launch attacks
• Writes logs to attempts.log and success result to successful_password.txt

---

🔨 Attack Modes

Mode	Input Required	Use Case
Guess	A 7-char base guess (e.g. admin12)	Attempts close variants first
Rule-based	Mask (LLSLLDD) + char sets	Targeted brute-force pattern
Dictionary	Text file with password list	Common passwords, known leaks
Hybrid	All of the above combined	Smart full-spectrum attack

---

📄 File Outputs

File Path	Description
attempts.log	Timestamped brute-force attempts
successful_password.txt	Saved result if successful
bios-password-cracker/wordlists/	Your wordlists go here
HPUtilities/*.exe	HP BIOS utilities (downloaded)

---

🗂️ Project Structure

📦 HP-ADMIN-UEFI-PASSWORD-BRUTEFORCE/
 ┣ 📄 Cargo.toml                  # Workspace
 ┣ 📁 bios-password-cracker/
 ┃ ┣ 📄 Cargo.toml               # GUI App
 ┃ ┣ 📄 src/main.rs              # GUI + logic
 ┃ ┣ 📄 bios_lock.png            # Icon
 ┃ ┣ 📄 README.md                # You're reading it
 ┃ ┣ 📄 attempts.log             # Log file
 ┃ ┣ 📄 successful_password.txt  # Cracked result (if found)
 ┃ ┣ 📁 wordlists/
 ┃ ┃ ┣ 📄 default.txt
 ┃ ┃ ┗ 📄 Award_BIOS.txt, AMI_BIOS.txt ...
 ┗ 📄 bios_cracker_setup.bat     # Automated build + run

---

🧪 Example Use

# Start GUI normally
cargo run --release

# Use batch setup on clean Windows install
.\bios_cracker_setup.bat

---

🧩 Wordlist Sources

You can drop wordlists into:

bios-password-cracker/wordlists/

Some included lists:

• AMI_BIOS.txt
• Award_BIOS.txt
• Other_BIOS.txt
• Lenovo_BIOS.txt

You may also create custom.txt or import rockyou.txt.

---

🧱 Windows Build Troubleshooting

❌ Error: link.exe not found

If you see this during cargo build:

error: linker `link.exe` not found
note: please ensure that Visual Studio 2017 or later, or Build Tools for Visual Studio were installed with the Visual C++ option.

👉 You are missing the MSVC C++ toolchain needed to compile Rust projects on Windows.

✅ Fix:

1. Download Visual Studio Build Tools
2. Run the installer and select:
   • ✅ Desktop development with C++
   • ✅ also check MSVC v14.x, Windows SDK, and C++ build tools are selected
3. Finish the install and restart your terminal
4. Run:

   cargo build --release

If you want to verify it's installed, run:

where link

---

🧠 VS Code alone is not enough — only Visual Studio Build Tools include link.exe and the required C++ compiler.

## 📜 Legal Notice

This tool is for **educational and lawful recovery use only.**  
Do **not** use this to bypass security illegally.

> 🛑 we do **not condone** or support unauthorized access of systems.  
> Use it to **recover your own devices** — **you are responsible for your actions.**


## 🧠 Author

**Evan Saurage**  
    @sunofva

os reinstall number 5854336

## 📃 License

MIT License. Free to use, modify, and distribute with credit.  
Intended for restoration, recovery, and research.