# keylogger

**Repository Path**: chen-pusheng/keylogger

## Basic Information

- **Project Name**: keylogger
- **Description**: 一个基于 Python 的全局键盘记录器，能够监控 Windows 系统中所有进程的键盘输入。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-08
- **Last Updated**: 2026-01-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 全局键盘记录器

一个基于 Python 的全局键盘记录器，能够监控 Windows 系统中所有进程的键盘输入。

## 🌟 特性

- **全局监控** - 记录所有应用程序中的键盘输入
- **进程识别** - 自动识别当前活动窗口进程
- **智能适配** - 支持控制台交互模式和后台运行模式
- **快捷键终止** - 使用 Ctrl+F6 组合键终止程序
- **单实例运行** - 防止重复启动多个实例
- **无时间戳日志** - 提高日志可读性
- **横向排列** - 按键记录横向排列，便于阅读
- **无需管理员权限** - 普通用户权限即可运行

## 📋 系统要求

- Windows 7/8/10/11
- Python 3.6+
- 无需管理员权限

## 📦 安装

### 方法一：直接运行 Python 脚本

1. 克隆或下载本项目
2. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```
3. 运行程序：
   ```bash
   python keylogger_unified.py
   ```

### 方法二：使用预编译的可执行文件

从 [Releases](https://github.com/dubaishun/keylogger/releases) 页面下载预编译的可执行文件。

## 🚀 使用方法

### 交互模式（有控制台）
```bash
python keylogger_unified.py
```
或双击运行 `keylogger_unified.exe`

### 后台模式（无控制台）
```bash
start keylogger_unified.exe
```

### 程序控制

- **终止程序**：按 `Ctrl+F6` 组合键
- **交互命令**（仅在有控制台时）：
  - `status` - 显示当前状态
  - `start` - 开始记录
  - `stop` - 停止记录
  - `clear` - 清屏
  - `help` - 显示帮助
  - `quit` - 退出程序

## 📁 日志文件

- **保存位置**：`C:\Users\Administrator\`
- **文件命名**：`keylog_YYYYMMDD_HHMM.txt` (如: keylog_20250911_1909.txt)
- **记录格式**：
  ```
  2025-09-11 19:09:00 开始记录
  >>> 记事本
  hello world
  >>> Chrome
  username password
  2025-09-11 19:15:00 结束 (总按键:25)
  ```

## 🔧 打包为可执行文件

使用 PyInstaller 打包：

```bash
pip install pyinstaller
pyinstaller --onefile --noconsole keylogger_unified.py
```

生成的可执行文件位于 `dist` 目录中。

## 🎥 视频演示


[开发键盘记录器](https://www.bilibili.com/video/BV1TuHvzSEbS/?share_source=copy_web&vd_source=006da7075749a21ab785d48b321d105c)


## ⚠️ 免责声明

本软件仅供教育和研究目的使用。使用者需遵守当地法律法规，不得用于任何非法用途。作者不对任何滥用行为负责。

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。


---

<p align="center">
  <strong>💻 项目开发</strong>
</p>

<p align="center">
  <strong>速光网络软件开发</strong> • <a href="https://suguang.cc">suguang.cc</a> • 📱 15120086569（vx同步）
</p>

<p align="center">
  <sub>专业软件开发服务 | 高质量代码实现 | 快速响应维护</sub>
</p>