# NodCatFTP

**Repository Path**: nodcat/NodCatFTP

## Basic Information

- **Project Name**: NodCatFTP
- **Description**: 一个简单实用的 FTP 文件夹同步工具，支持定时自动同步和系统托盘运行。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-06-07
- **Last Updated**: 2025-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NodCat FTP 同步工具

![NodCat图标](img/icon.png)

一个简单实用的 FTP 文件夹同步工具，支持定时自动同步和系统托盘运行。

## 功能特性

- 本地与 FTP 服务器文件夹同步
- 支持定时自动同步
- 支持中文路径
- 系统托盘运行
- 跨平台支持(Linux/Windows)
- 多线程的同步支持(v1.2)
- 主题自由切换(v1.2)

### Windows (EXE)

1. 下载最新版本的 EXE 安装包
2. 双击运行安装程序
3. 按照向导完成安装

### 从源代码构建

#### 依赖项

- Python 3.6+
- PyQt5
- PyInstaller (Linux)
- cx_Freeze (Windows)

#### Linux 构建

```bash
python setup_linux_deb.py
```

#### Windows 构建

```bash
python setup_windows_exe.py
```

## 使用方法

1. 安装程序会自动创建配置文件`config.json`
2. 点击"FTP 设置"配置服务器信息
3. 选择本地同步路径
4. 点击"同步"按钮开始手动同步
5. 使用"定时设置"配置自动同步

程序会最小化到系统托盘，右键托盘图标可打开主界面或退出程序。

## 软件截图

### 主界面

![主界面](md/img/1.jpg)

### FTP 设置

![FTP 设置](md/img/2.jpg)

### 快捷菜单

![快捷菜单](md/img/3.jpg)

### 定时设置

![定时设置](md/img/4.jpg)

## 配置说明

配置文件`config.json`示例:

```json
{
  "ftp": {
    "host": "ftp.example.com",
    "username": "your_username",
    "password": "your_password",
    "remote_path": "/remote/path"
  },
  "local_path": "/local/path",
  "schedule": {
    "frequency": "每天",
    "time": "00:00"
  }
}
```

## 开发与贡献

欢迎提交 Issue 和 Pull Request。

项目地址: [NodCatFTP 工具](https://gitee.com/nodcat/NodCatFTP)

如果这个解决方案对您有帮助，麻烦在项目仓库点亮小 ⭐️，您的支持是我们持续优化的动力！(点击右上角 ⭐️Star 按钮即可)

我们将继续：

- 🛠 保持技术方案更新
- 💡 增加更多实用功能
- 🚀 提供更高效的代码实现

感谢您的认可！(❁´◡`❁)