# QRFileCoder

**Repository Path**: firexmoon/qr-file-coder

## Basic Information

- **Project Name**: QRFileCoder
- **Description**: 基于二维码的视觉文件传输工具，通过二维码序列化传输文件数据。提供编码器和解码器功能：可对任意文件进行二维码编码，生成顺序编号的二维码图片。通过扫描指定目录中的二维码图片序列自动识别并恢复原始文件。
主要使用Trae+kimiK2开发。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-05
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QRFileCoder - 二维码文件传输工具

基于二维码的视觉文件传输工具，通过二维码序列化传输文件数据。无需网络连接，通过截屏、拍照即可实现文件传输。

## 🚀 功能特性

### 发送端功能
- 📁 支持任意类型文件编码（文档、图片、视频、压缩包等）
- 🔢 智能计算所需二维码数量，实时显示预估信息
- 🖼️ 生成二维码图片序列，自动编号管理
- ▶️ 可调节播放速度的二维码循环展示
- 📊 实时显示生成每个二维码的数据详情和进度
- 🗜️ 智能压缩算法，自动优化文件大小

### 接收端功能
- 📸 批量扫描识别二维码图片
- 🧩 自动重组分片数据，恢复完整文件
- 🔍 智能容错：处理缺失、重复、损坏的二维码
- 📂 支持乱序二维码自动排序
- 📈 实时显示恢复进度和状态
- 🎯 支持单图多码识别


## 📋 系统要求

### 依赖安装
使用国内镜像源快速安装：

```bash
# 使用清华镜像源
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 或使用阿里云镜像源
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
```

## 🎯 快速开始

### 1. 启动程序
```bash
python qr_file_coder.py
```

### 2. 发送文件（编码器）
1. 切换到"编码器"标签页
2. 点击"浏览"选择要传输的文件
3. 查看预计二维码数量和文件大小信息
4. 点击"生成二维码"创建二维码序列
5. 点击"播放二维码"开始展示

### 3. 接收文件（解码器）
1. 切换到"解码器"标签页
2. 点击"浏览"选择包含二维码图片的目录
3. 点击"扫描并恢复"开始处理
4. 查看恢复进度和结果
5. 在输出目录获取恢复的文件

## 🔧 技术架构

### 核心模块
```
qr-file-coder/
├── qr_file_coder.py      # 主程序入口
├── sender_tab.py         # 发送端界面逻辑
├── receiver_tab.py       # 接收端界面逻辑
├── qr_encoder.py         # 二维码编码引擎
├── qr_decoder.py         # 二维码解码引擎
├── logger.py            # 日志管理系统
├── auto_screenshot.py   # 自动截图工具
├── requirements.txt     # 依赖包列表
├── run.bat             # Windows启动脚本
└── README.md           # 项目文档
```

### 数据存储
```
qr/                     # 二维码输出目录
├── file_name_001.png   # 二维码图片序列
├── file_name_002.png
└── ...
out/                    # 文件恢复输出目录
└── restored_file.ext   # 恢复后的文件
```