# usbipd_tray

**Repository Path**: maplerian/usbipd_tray

## Basic Information

- **Project Name**: usbipd_tray
- **Description**: 用 ChatGPT 生成的 windows11 usbipd 托盘管理软件
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# USBIPD 系统托盘管理工具

用ChatGPT生成的一个轻量级的托盘图标工具，图形化管理 Windows 下 [`usbipd`](https://github.com/dorssel/usbipd-win) 共享的 USB 设备。

支持：
- 一键共享 / 取消共享设备
- 自动刷新设备状态
- 开机自启
- 多语言界面
- 可生成独立 `.exe` 文件，免 Python 运行环境

---

## 🧩 功能特性

- 托盘显示 USBIPD 状态图标
- 单击设备即可切换共享状态
- 自动刷新设备状态（可配置刷新间隔）
- 开机自启（Windows 系统）
- 多语言支持（从 `i18n/` 文件夹加载）
- 配置自动保存至 `config.json`
- 支持一键构建独立可执行文件

---

## 🖥️ 运行方式

### ✅ 方法一：直接运行源码（需安装 Python）

1. 安装依赖：

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

2. 启动程序：

   ```bash
   python usbipd_tray.py
   ```

### 🛠️ 方法二：构建可执行文件（推荐）

Windows
双击运行：

   ```bat
   build_win.bat
   ```

### ⚙️ 配置说明（config.json）

配置文件位于程序当前目录下：

   ```json
    {
    "lang": "en",
    "auto_start": true,
    "refresh_interval": 10
    }
   ```

| 配置项                | 类型  | 含义                     |
| ------------------ | --- | ---------------------- |
| `lang`             | 字符串 | 界面语言（如 `"en"`, `"zh"`） |
| `auto_start`       | 布尔值 | 是否开机自启（仅 Windows）      |
| `refresh_interval` | 整数  | 自动刷新设备间隔（单位：秒）         |

### 🌐 多语言支持

   ```pgsql
    i18n/
    ├── en.json
    ├── zh.json
   ```

示例 en.json：

   ```json
    {
    "menu_refresh": "Refresh",
    "menu_quit": "Quit",
    "menu_language": "Language",
    ...
    }
   ```

若语言文件缺失或出错，将自动回退为内置英文。

### 📁 项目结构

   ```bash
    usbipd_tray/
    ├── usbipd_tray.py      # 主程序
    ├── build_win.bat       # Windows 构建脚本
    ├── build_unix.sh       # Linux/macOS 构建脚本
    ├── build.py            # 通用构建入口
    ├── i18n/               # 语言文件目录
    ├── assets/             # 图标文件
    ├── config.json         # 用户配置
    └── requirements.txt    # Python 依赖
   ```

### 📦 依赖组件

- pystray：托盘图标支持
- Pillow：图标渲染
- usbipd-win：依赖系统已安装
- pywin32（仅 Windows）：开机启动项管理

### 📜 许可协议

本项目采用 MIT License，欢迎修改、分发或商用。

### 🙋 常见问题

Q: 无法加载 config.json？
A: 可能是文件格式损坏，可手动删除或修复，程序将自动生成默认配置。

Q: 图标不透明或模糊？
A: 请确保 logo.png 使用 256x256 PNG 并带透明通道。