# FileTransfer

**Repository Path**: xipis/file-transfer

## Basic Information

- **Project Name**: FileTransfer
- **Description**: 这是一个小工具用于在局域网内电脑和手机进行文件互传
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-11-05
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件传输工具

这是一个使用Python和Qt开发的跨平台文件传输工具，允许电脑和手机之间通过扫描二维码来建立连接并传输文件。

## 功能特点

- 通过二维码扫描建立连接
- 支持电脑和手机之间双向文件传输
- 可自定义文件保存位置
- 配置自动保存到加密文件
- 直观的图形用户界面
- 支持多文件选择传输

## 预览图

### 主界面
![主界面](pic/screen1.PNG)

### 手机端界面
![手机端界面](pic/screen2.jpg)

## 安装依赖

```bash
pip install -r requirements.txt
```

## 运行应用

```bash
python app.py
```

## 使用说明

1. 在电脑上运行该应用
2. 应用会自动生成一个包含连接信息的二维码
3. 在手机上使用二维码扫描应用扫描该二维码（或者手动输入显示的IP地址和端口）
4. 连接建立后，可以：
   - 点击"发送文件到手机"按钮从电脑向手机发送文件（支持多选）
   - 通过手机浏览器上传文件到电脑（文件将保存到指定目录）
5. 可以通过"浏览"按钮更改文件保存位置，设置会自动保存

## 配置文件

用户设置（如文件保存目录）会自动保存在以下位置的加密文件中：
- Windows: `C:\Users\{用户名}\.file_transfer\config.dat`
- macOS: `/Users/{用户名}/.file_transfer/config.dat`
- Linux: `/home/{用户名}/.file_transfer/config.dat`

配置文件使用AES加密保护用户隐私，密钥存储在同目录的 `.key` 文件中。

## 许可证

本项目采用 GNU General Public License v3.0 开源许可证。详情请参见 [LICENSE](LICENSE) 文件。

## 注意事项

- 确保电脑和手机在同一个网络中
- 防火墙可能需要配置以允许端口通信
- 默认端口是12345，如需更改可在代码中修改