# open-password-tool

**Repository Path**: xkx1029/open-password-tool

## Basic Information

- **Project Name**: open-password-tool
- **Description**: 暴力字典填充工具 - 用于生成密码字典并可自动填充到输入框的Python工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-09
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 暴力字典填充工具

## 项目介绍

暴力字典填充工具是一个用于生成密码字典并可自动填充到输入框的Python工具。它支持命令行和图形界面两种运行方式，可根据用户设置的字符集和长度范围生成密码组合，并能自动将生成的密码填充到目标输入框中。

## 功能特点

- **多种运行模式**：支持命令行和图形界面两种运行方式
- **自定义字符集**：可设置任意字符集，内置5种字符集预设（数字、小写字母、大写字母、字母数字、全部字符）
- **长度范围控制**：可设置密码的最小和最大长度
- **多线程生成**：支持多线程生成字典，提高生成速度（命令行模式默认4线程，GUI模式默认1线程）
- **自动填充功能**：可将生成的密码自动填充到输入框，包含3秒倒计时提示
- **填充后按键**：可设置填充密码后自动按下的按键（如回车、Tab等）
- **实时状态显示**：图形界面实时显示生成进度和状态
- **生成停止功能**：支持在生成过程中停止操作
- **错误处理**：完善的错误处理机制，包括参数验证和异常捕获

## 安装说明

### 环境要求

- Python 3.6 或更高版本
- 可选依赖：pyautogui（用于自动填充功能）

### 安装依赖

如果需要使用自动填充功能，请安装pyautogui库：

```bash
pip install pyautogui
```

## 使用方法

### 图形界面模式

运行以下命令启动图形界面：

```bash
python brute_force_dict.py --gui
```

或者直接运行：

```bash
run.bat
```

在图形界面中，您可以：
1. 设置密码长度范围
2. 选择或自定义字符集
3. 设置输出文件路径
4. 调整线程数
5. 配置自动填充选项
6. 点击"开始生成"按钮开始生成字典

### 命令行模式

基本用法：

```bash
python brute_force_dict.py [参数]
```

### 命令行参数

| 参数 | 说明 | 默认值 |
|------|------|--------|
| -m, --min-length | 密码最小长度 | 1 |
| -M, --max-length | 密码最大长度 | 4 |
| -c, --charset | 字符集 | 0123456789 |
| -o, --output | 输出文件 | dictionary.txt |
| -t, --threads | 线程数 | 4 |
| --gui | 使用图形界面 | 不使用 |
| --auto-fill | 自动填充到输入框 | 不使用 |
| --delay | 填充延时(秒) | 0.0 |
| --key | 填充后按键 | None |

### 示例

1. 生成数字密码字典（长度1-4）：
   ```bash
   python brute_force_dict.py
   ```

2. 生成字母密码字典（长度2-6）：
   ```bash
   python brute_force_dict.py -m 2 -M 6 -c abcdefghijklmnopqrstuvwxyz
   ```

3. 生成混合字符密码字典并自动填充：
   ```bash
   python brute_force_dict.py -c "abcdefghijklmnopqrstuvwxyz0123456789" --auto-fill --delay 0.5 --key return
   ```

## 安全注意事项

- **仅供合法用途**：本工具仅用于安全测试和教育目的，请确保在合法授权的情况下使用
- **自动填充风险**：使用自动填充功能时，请确保目标窗口是您想要填充的窗口，避免填充到错误的位置
- **性能考虑**：生成大规模字典时可能会消耗大量系统资源，请根据您的系统配置调整参数

## 项目结构

```
open_password/
├── brute_force_dict.py  # 主程序文件
├── dictionary.txt       # 默认输出文件
├── run.bat              # 运行脚本
├── test_dict.txt        # 测试文件
└── test_gui.txt         # 测试文件
```

## 核心功能说明

1. **字典生成**：使用itertools.product生成指定字符集和长度范围的所有组合
2. **多线程处理**：使用线程池提高生成速度
3. **自动填充**：使用pyautogui模拟键盘输入，包含3秒倒计时提示
4. **图形界面**：使用tkinter创建用户友好的界面

## 字符集预设

图形界面模式提供了以下字符集预设：

| 预设名称 | 包含字符 |
|---------|---------|
| 数字 | 0123456789 |
| 小写字母 | abcdefghijklmnopqrstuvwxyz |
| 大写字母 | ABCDEFGHIJKLMNOPQRSTUVWXYZ |
| 字母数字 | abcdefghijklmnopqrstuvwxyz0123456789 |
| 全部字符 | abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()_+ |

## 常见问题

### 1. 自动填充功能不可用

如果出现"未安装pyautogui库，自动填充功能将不可用"的提示，请运行以下命令安装pyautogui：

```bash
pip install pyautogui
```

### 2. 生成速度较慢

可以尝试增加线程数来提高生成速度：

```bash
python brute_force_dict.py -t 8
```

### 3. 生成的字典文件过大

请合理设置密码长度范围和字符集，避免生成过大的字典文件。

## 作者

xkx

## 许可证

本项目采用MIT许可证。

## 免责声明

本工具仅供学习和安全测试使用，请勿用于任何非法用途。使用本工具产生的任何后果由使用者自行承担。