emirberasoguk/Pi-Cracker
GitHub: emirberasoguk/Pi-Cracker
一款结合圆周率数字生成与 OSINT 智能字典的 WiFi 渗透测试工具，支持 Hashcat 和 Aircrack-ng 双模式破解。
Stars: 0 | Forks: 0
# 🥧 Pi-Cracker：高级混合 WiFi 渗透测试工具
**Türkçe | English**
## Türkçe
**Pi-Cracker**，WiFi 网络安全测试工具，结合了数学复杂性与人类行为（OSINT）的新一代渗透测试工具。
它旨在克服传统“暴力破解”（brute-force）攻击的笨重感，利用** Pi 的无限且不规律的数字**，同时针对目标特定的个人信息（出生年份、城市、球队等）生成“智能”字典。
## 🚀 核心功能
### 1. 🧠 混合攻击引擎
与普通的字典不同，Pi-Cracker 融合了两种不同的数据源：
* **数学数据源：** 动态计算 Pi 的数字。这提供了无限的密码空间，而无需在磁盘上存储数 TB 的“彩虹表”（Rainbow Table）。
* **社交数据源（OSINT 与智能变体）：** 收集目标的姓名、所在城市、车牌号和喜欢的球队等信息，使用以下高级技术：
* **Leetspeak：** 用外观相似的数字和符号替换字符（例如：`ali` -> `@l1`）。
* **反转（Reverse）：** 尝试倒序的单词（例如：`ahmet` -> `temha`）。
* **智能组合：** 将单词与符号和数字结合（例如：`ahmet.1990`、`ali_34`、`yilmaz!`）。
* **土耳其用户模式：** 生成符合土耳其用户常见密码创建习惯的组合。
### 2. ⚡ 智能硬件优化（统一脚本）
单个脚本（`pi_cracker.sh`）会分析您的系统并选择最合适的攻击向量：
* **GPU 模式（Hashcat）：** 如果您的系统拥有兼容的显卡和 Hashcat，它会将密码直接从 C 引擎通过“管道”（pipe）传输给 Hashcat。这样可以避免磁盘 I/O 瓶颈，每秒进行数千/数百万次尝试。
* **CPU 模式（Aircrack-ng）：** 如果没有 GPU 或使用的是旧系统，它会自动切换到 Aircrack-ng 模式。
### 3. 📡 网络信息分析与目标定向攻击
Pi-Cracker 不仅利用个人信息，还将目标网络自身的身份信息纳入攻击中：
* **自动提取：** 自动从选定的 `.cap` 或 `.hc22000` 文件中提取网络的 **BSSID**（MAC 地址）和 **ESSID**（WiFi 名称）信息。
* **针对网络的变体：**
* 尝试将 MAC 地址的最后 4 位和 6 位作为密码。
* 使用 WiFi 名称（例如：`Starbucks`）推导出 `starbucks123`、`Starbucks2024!` 等智能组合。
* 测试特定 ISP/调制解调器品牌的默认模式（例如：`superonlineXXXX`）。
### 4. 🔄 自动文件管理
* **.cap 转 .hc22000：** 自动执行 Hashcat 模式所需的文件格式转换（如果已安装 `hcxpcapngtool`）。
* **文件夹结构：** 自动识别捕获的网络文件（`Handshake/captures/`）和字典文件（`Wordlist/`）。
## 📂 项目架构
```
/
├── Docs/ # Dokümantasyon
│ └── Turk_Wifi_Parola_Analizi.md # Türkiye'ye özgü şifre kalıpları analizi
├── Handshake/
│ └── captures/ # Yakalanan ağ paketleri
│ ├── cap/ # .cap dosyaları (Aircrack-ng)
│ └── hc22000/ # .hc22000 dosyaları (Hashcat)
├── Wordlist/ # Wordlistler
│ ├── capture.txt
│ └── probable-v2-wpa-top*.txt
├── pi_script_bruteforce/ # Kaynak Kodlar
│ ├── pi_cracker.sh # (ANA ÇALIŞTIRILABİLİR DOSYA)
│ ├── pi_generator_dynamic.c # C tabanlı wordlist motoru
│ └── pi_generator.state # Durum dosyası
├── LICENSE # Lisans dosyası
└── README.md
```
## 🛠️ 安装
此工具专为 **Linux** 环境（Kali Linux、Parrot OS、Ubuntu 等）设计并运行。
### 1. 安装依赖项
在您的系统上安装必要的库和工具：
```
# Debian/Ubuntu/Kali 系统：
sudo apt-get update
sudo apt-get install build-essential libmpfr-dev libgmp-dev hashcat aircrack-ng hcxtools
```
*注意：`libmpfr` 和 `libgmp` 对于 C 程序高精度计算 Pi 的数字是必不可少的。*
### 2. 下载并编译项目
要编译 C 引擎：
```
cd pi_script_bruteforce
gcc pi_generator_dynamic.c -o pi_generator_dynamic -lmpfr -lgmp
```
*如果遇到错误，请确保已安装所需的库。*
## 💻 使用方法
运行主脚本以启动攻击。脚本将通过交互式界面引导您完成操作。
```
cd pi_script_bruteforce
./pi_cracker.sh
```
### 分步流程：
1. **模式选择：** 脚本将扫描您的系统。如果有 GPU，它会建议使用 Hashcat；如果没有，则建议使用 Aircrack-ng。
2. **文件选择：** 系统会提示您指定 `../Handshake/captures/` 目录中的文件。
3. **目标信息：** （可选）输入您了解的关于目标个人的详细信息（例如，姓名：`Mehmet`，年份：`1990`，球队：`GS` 等）。这些信息将显著提高成功率。
4. **攻击：** 该工具首先会尝试最流行的密码，接着是个人组合，最后尝试 Pi 的数字。
## ⚠️ 法律免责声明
**本软件仅供教育目的及合法的安全测试（渗透测试）使用。**
* 请仅在**您自己的网络**或**已获得书面许可**的网络上使用。
* 未经授权尝试访问网络，属于违反**《土耳其刑法典》第 5237 号**（网络犯罪）及国际法律的犯罪行为。
* 对于因滥用此工具而造成的任何损害，开发者概不负责。
## 📝 许可证
本项目采用 GNU GPLv3 许可证授权。详情请查看 [LICENSE](LICENSE) 文件。
## English
# 🥧 Pi-Cracker：高级混合 WiFi 渗透工具
**Pi-Cracker** is a next-generation penetration testing tool developed for WiFi network security assessments, combining mathematical complexity with human behavior (OSINT).
It aims to overcome the clumsiness of traditional "brute-force" attacks by leveraging the **infinite and irregular digits of Pi** while simultaneously creating "smart" wordlists using target-specific personal information (e.g., birth year, city, favorite team).
## 🚀 核心功能
### 1. 🧠 混合攻击引擎
Unlike ordinary wordlists, Pi-Cracker blends two distinct data sources:
* **Mathematical Source:** Dynamically calculates the digits of Pi. This provides an infinite password space without requiring terabytes of disk space for "Rainbow Tables."
* **Social Source (OSINT & Smart Variations):** Gathers information like the target's name, city, and favorite team, utilizing advanced techniques:
* **Leetspeak:** Replaces characters with similar-looking numbers and symbols (e.g., `ali` -> `@l1`).
* **Reverse:** Tries passwords in reverse order (e.g., `ahmet` -> `temha`).
* **Smart Combinations:** Merges words with symbols and numbers (e.g., `ahmet.1990`, `ali_34`, `yilmaz!`).
* **Turkish Password Patterns:** Tailors combinations to match common Turkish password creation habits.
### 2. ⚡ 智能硬件优化（统一脚本）
A single script (`pi_cracker.sh`) analyzes your system and selects the most appropriate attack vector:
* **GPU Mode (Hashcat):** If your system has a compatible graphics card and Hashcat, it pipes passwords directly from the C engine to Hashcat. This allows for thousands/millions of attempts per second without disk I/O bottlenecks.
* **CPU Mode (Aircrack-ng):** If no GPU is detected or on older systems, it automatically switches to Aircrack-ng mode.
### 3. 📡 网络信息分析与定向攻击
Pi-Cracker incorporates the target network's own identity into the attack:
* **Automatic Extraction:** Automatically retrieves the network's **BSSID** (MAC address) and **ESSID** (WiFi name) from the selected `.cap` or `.hc22000` file.
* **Network-Specific Variations:**
* Tests the last 4 and 6 digits of the MAC address as potential passwords.
* Uses the WiFi name (e.g., `Starbucks`) to derive smart combinations like `starbucks123` or `Starbucks2024!`.
* Tests default patterns related to specific ISP/Modem brands (e.g., `superonlineXXXX`).
### 4. 🔄 自动文件管理
* **.cap -> .hc22000 Conversion:** Automatically performs the necessary file format conversion for Hashcat mode (if `hcxpcapngtool` is available).
* **Folder Structure:** Automatically recognizes capture files (`Handshake/captures/`) and wordlists (`Wordlist/`).
## 📂 项目架构
```
/
├── Docs/ # Documentation
│ └── Turk_Wifi_Parola_Analizi.md # Analysis of Turkish-specific password patterns
├── Handshake/
│ └── captures/ # Captured network packets
│ ├── cap/ # .cap files (Aircrack-ng)
│ └── hc22000/ # .hc22000 files (Hashcat)
├── Wordlist/ # Wordlists
│ ├── capture.txt
│ └── probable-v2-wpa-top*.txt
├── pi_script_bruteforce/ # Source Code
│ ├── pi_cracker.sh # (MAIN EXECUTABLE FILE)
│ ├── pi_generator_dynamic.c # C-based wordlist engine
│ └── pi_generator.state # State file
├── LICENSE # License file
└── README.md
```
## 🛠️ 安装
This tool is designed to run in a **Linux environment** (e.g., Kali Linux, Parrot OS, Ubuntu).
### 1. 安装依赖
Install the necessary libraries and tools on your system:
```
# Debian/Ubuntu/Kali 系统：
sudo apt-get update
sudo apt-get install build-essential libmpfr-dev libgmp-dev hashcat aircrack-ng hcxtools
```
*Note: `libmpfr` and `libgmp` are essential for the C program to calculate Pi digits with high precision.*
### 2. 下载并编译项目
To compile the C engine:
```
cd pi_script_bruteforce
gcc pi_generator_dynamic.c -o pi_generator_dynamic -lmpfr -lgmp
```
*If you encounter errors, ensure the required libraries are installed.*
## 💻 使用方法
To start the attack, run the main script. The script will guide you through an interactive interface.
```
cd pi_script_bruteforce
./pi_cracker.sh
```
### 分步流程：
1. **Mode Selection:** The script scans your system. It will suggest Hashcat if a GPU is available, or Aircrack-ng otherwise.
2. **File Selection:** You will be prompted to specify the target file from the `../Handshake/captures/` directory.
3. **Target Information:** (Optional) Enter details you know about the target person (e.g., Name: `Mehmet`, Year: `1990`, Team: `GS`). This information significantly increases the success rate.
4. **Attack:** The tool will first try the most popular passwords, then personal combinations, and finally the digits of Pi.
## ⚠️ 法律免责声明
**This software is developed for educational purposes and legitimate security testing (Penetration Testing) only.**
* Use it only on **your own network** or on networks for which you have **explicit written permission**.
* Attempting to access unauthorized networks is illegal under **Turkish Penal Code No. 5237** (Cybercrimes) and international laws.
* The developer cannot be held responsible for any damage resulting from the misuse of this tool.
## 📝 License
This project is licensed under the GNU GPLv3 License. See [LICENSE](LICENSE) file for details.
标签：Aircrack-ng, Bitdefender, Cutter, ESC4, Hashcat, OSINT, WiFi渗透测试, 客户端加密