# hottransfer

**Repository Path**: Silfra/hottransfer

## Basic Information

- **Project Name**: hottransfer
- **Description**: 在两台使用热点建立的局域网的设备间传输文件，基于C/S原理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-21
- **Last Updated**: 2024-11-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 热点文件传输助手

本项目旨在通过两台通过热点连接的主机传输文件，基于C/S原理，通过socket技术实现。文件传输过程不需要依赖互联网，文件传输速度取决于热点文件传输速度。

设主机A要向主机B传输文件，则主机B视为服务器端，需要运行服务器端应用，即`HostTransfer Server.exe`，主机A视为客户端，需要运行客户端应用，即`HostTransfer Client.exe`。

## 平台

- Windows

## 功能

- 单文件传输

## 使用界面

### 服务器端

![服务器端](./assets/%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%AB%AF.png)

### 客户端

![客户端](./assets/%E5%AE%A2%E6%88%B7%E7%AB%AF.png)

## 使用说明

- 已经将源代码打包为 `exe`，在 `dist` 目录中，直接运行即可使用。

- 传输文件需要首先开启服务器端程序，使服务器处于监听状态，客户端才能进行连接，并向服务器端主机传输文件。

### 服务器端

输入“IP地址”和“端口”，点击启动服务即可开始监听。

> **获得“IP地址”：**
>
> 基于C/S原理，你需要手动查看“IP地址”，查看方式为在命令提示符（cmd）中输入 `ipconfig` 指令，如下示例：
>
> ```cmd
> C:>ipconfig
> 
> Windows IP 配置
> 
> 
> 无线局域网适配器 本地连接* 1:
> 
>    媒体状态  . . . . . . . . . . . . : 媒体已断开连接
>    连接特定的 DNS 后缀 . . . . . . . :
> 
> 无线局域网适配器 本地连接* {xx}:
> 
>    媒体状态  . . . . . . . . . . . . : 媒体已断开连接
>    连接特定的 DNS 后缀 . . . . . . . :
> 
> 无线局域网适配器 WLAN:
> 
>    连接特定的 DNS 后缀 . . . . . . . : {xx}
>    本地链接 IPv6 地址. . . . . . . . : {xx}
>    IPv4 地址 . . . . . . . . . . . . : 192.168.{xx}
>    子网掩码  . . . . . . . . . . . . : {xx}
>    默认网关. . . . . . . . . . . . . : 192.168.{xx}
> 
> 以太网适配器 蓝牙网络连接:
> 
>    媒体状态  . . . . . . . . . . . . : {xx}
>    连接特定的 DNS 后缀 . . . . . . . : {xx}
> ```
>
> 查找的“IP地址”应为“无线局域网适配器 WLAN”中的“IPv4 地址”。
>
> 端口号用户自定义，但不要和已经占用的端口号冲突，一个可能的设置为 `12345`。

### 客户端

1. 客户端需要填写和服务器相同的“IP地址”和“端口”；
2. 点击“选择文件”，选择需要传输到另一台主机的文件，选择后会在输入框中填充选择文件的路径，你也可以手动修改该路径，最后传输文件路径以输入框中数据为准；
3. 点击开始传输，文件进入传输过程，传输完成后，保存文件到应用所在文件夹。

## 打包

你可以手动使用 `pyinstaller` 对源代码进行打包，打包指令可参考 `packaging instruction.txt` 文件。