Skip to content

maxgfr/brutifi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

82 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

BrutiFi πŸ”

Simple desktop application for WPA/WPA2 password cracking on macOS

Release CI Rust License

⚠️ EDUCATIONAL USE ONLY - UNAUTHORIZED ACCESS IS ILLEGAL ⚠️

A simple macOS desktop app for testing WiFi password security. Scan networks, capture handshakes, and crack passwords using CPU or GPU acceleration.

✨ Features

  • πŸ–₯️ Simple Desktop GUI - Clean 2-screen interface built with Iced
  • πŸš€ Dual Cracking Engines:
    • Native CPU: Custom PBKDF2 (~10K-100K passwords/sec)
    • Hashcat GPU: 10-100x faster with automatic device detection
  • πŸ“‘ WiFi Network Scanning - Real-time discovery with channel detection
  • 🎯 Two Attack Methods:
    • 4-Way Handshake: Traditional EAPOL frame capture (requires client reconnection)
    • PMKID: Clientless attack from beacon frames (no clients needed)
  • πŸ”‘ Two Crack Modes:
    • πŸ”’ Numeric bruteforce (8-12 digit PINs)
    • πŸ“‹ Wordlist attacks (rockyou.txt, custom lists)
  • πŸ“Š Live Progress - Real-time speed, attempts, and ETA
  • πŸ”’ 100% Offline - No data transmitted

πŸ“¦ Installation

macOS

Quick Installation

  1. Download the DMG from the latest release (Apple Silicon or Intel)
  2. Open the DMG and drag BrutiFi.app to Applications
  3. Launch the app β€” macOS will ask for admin password to enable capture

Remove Quarantine (Required for GitHub downloads)

xattr -dr com.apple.quarantine /Applications/BrutiFi.app

From Source

git clone https://github.com/maxgfr/bruteforce-wifi.git
cd bruteforce-wifi
cargo build --release
./target/release/brutifi

πŸš€ Usage

Simple 2-Step Workflow

1. Scan & Capture β†’ Generates .pcap file with handshake/PMKID
2. Crack β†’ Bruteforce password from .pcap

Step 1: Scan & Capture

  1. Click "Scan" to discover nearby WiFi networks
  2. Select a target network from the list
  3. (Optional) Disconnect from WiFi for better capture: Option+Click WiFi β†’ Disconnect
  4. Click "Start Capture"

The app automatically captures either:

  • βœ… PMKID (clientless, instant)
  • βœ… 4-Way Handshake (M1 + M2 frames)

macOS Note: Deauth attacks don't work on Apple Silicon. Manually reconnect a device to trigger handshake (turn phone WiFi off/on).

Step 2: Crack Password

  1. Navigate to "Crack" tab
  2. Select cracking engine:
    • Native CPU: Works everywhere
    • Hashcat GPU: 10-100x faster (requires brew install hashcat hcxtools)
  3. Choose attack method:
    • Numeric: Tests 8-12 digit PIN codes
    • Wordlist: Tests passwords from file (e.g., rockyou.txt)
  4. Click "Start Cracking"

Watch real-time progress with speed and ETA!

πŸ› οΈ Development

Prerequisites

  • Rust 1.70+: Install via rustup
  • Xcode Command Line Tools: xcode-select --install

Build Commands

# Development build
cargo build

# Release build
cargo build --release

# Run the app
cargo run --release

# Format code
cargo fmt --all

# Lint code
cargo clippy --all-targets --all-features -- -D warnings

# Run tests
cargo test

Optional: Hashcat GPU Acceleration

brew install hashcat hcxtools

πŸ” Security & Legal

Disclaimer

Educational Use Only

βœ… Legal Uses:

  • Testing your own WiFi network
  • Authorized penetration testing with written permission
  • Security research and education

❌ Illegal Activities:

  • Unauthorized network access
  • Intercepting communications without permission

Unauthorized access is a criminal offense. Always obtain explicit written permission.

πŸ”§ Alternatives

Looking for more advanced features?

BrutiFi focuses on simplicity with just 2 core attacks (PMKID + Handshake). For a more comprehensive WiFi auditing tool with additional attack vectors, check out:

  • Wifite2 - Complete automated wireless auditing tool
    • WPS attacks (Pixie Dust, PIN brute-force)
    • WPA3 attacks (Transition downgrade, SAE)
    • Evil Twin phishing
    • Multiple attack automation
    • Linux-focused CLI tool

πŸ™ Acknowledgments

Inspired by:

Built with:

πŸ“„ License

MIT License - Use at your own risk