# ToolBoxApp

**Repository Path**: chenyx119/tool-box-app

## Basic Information

- **Project Name**: ToolBoxApp
- **Description**: ToolBoxApp 是一个集成了多个实用工具的小应用程序。它提供了一个图形用户界面（GUI），用户可以通过该界面轻松访问和使用这些工具。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-12
- **Last Updated**: 2025-04-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ToolBoxApp 项目说明文档

## 简介

ToolBoxApp 是一个集成了多个实用工具的小应用程序。它提供了一个图形用户界面（GUI），用户可以通过该界面轻松访问和使用这些工具。

## 功能

ToolBoxApp 包含以下工具：

- **重复文件查找器**：帮助用户查找并删除指定目录下的重复文件，支持图片和视频文件。
- **JSON 解析器**：提供一个简单的界面，用于格式化和转换 JSON 数据。
- **时间计算器**：允许用户进行时间相关的计算，如计算两个日期之间的差异。
- **音频音量调整器**：支持调整音频和视频文件的音量大小，可批量处理整个文件夹中的文件。支持多种格式，包括mp3、wav、ogg、flac、m4a、mp4、mkv、avi、mov和wmv。
- **格式转换工具**：支持在不同的视频和音频格式之间进行转换，包括视频转视频、视频提取音频和音频转音频。

## 特性

- **直观的界面**：简洁明了的UI设计，让用户可以轻松地使用各种工具。
- **批量处理**：大多数工具支持批量处理功能，可以同时处理多个文件。
- **内置FFmpeg**：应用程序已经集成了FFmpeg，用户无需额外安装即可使用音频和视频处理功能。
- **自定义图标**：每个工具都有独特的图标，使导航变得简单明了。

## 安装依赖

在运行 ToolBoxApp 之前，需要安装以下依赖：

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

## 打包命令

使用 PyInstaller 打包 ToolBoxApp 为单个可执行文件：

```bash
pyinstaller --noconsole --onefile -F main.py
```

如果需要打包带有FFmpeg的完整版本，请确保在打包命令中包含FFmpeg可执行文件：

```bash
pyinstaller --noconsole --add-data "ffmpeg.exe;." --add-data "ffprobe.exe;." --onefile -F main.py
```

## 使用方法

运行以下命令启动 ToolBoxApp：

```bash
python main.py
```

或直接双击打包后的可执行文件运行。

## 项目结构

项目包含以下主要文件和目录：

- `main.py`：应用程序的入口点。
- `ToolBox.py`：定义了 ToolBoxApp 的主要框架和逻辑。
- `com/cyxcoder/tools/panel/`：包含各种工具面板的实现文件
  - `HomePage.py`：首页面板，显示所有可用工具。
  - `DuplicateFileFinder.py`：实现了重复文件查找功能。
  - `JsonParser.py`：实现了 JSON 数据的格式化和转换功能。
  - `TimeCalculator.py`：实现了时间计算功能。
  - `AudioVolumeBooster.py`：实现了音频音量调整功能，支持多种音频和视频格式。
  - `FormatConverter.py`：实现了格式转换功能。
- `icons/`：包含应用程序使用的所有图标。
- `create_icons.py`：用于生成应用程序所需的图标。
- `requirements.txt`：列出了项目所需的Python依赖。
- `ffmpeg.exe`和`ffprobe.exe`：用于音频和视频处理的工具，已预先包含在项目中。

## 系统要求

- Python 3.6 或更高版本
- Windows、macOS 或 Linux 操作系统

## 贡献

如果您有任何建议或想要贡献代码，请随时提交 Pull Request 或创建 Issue。

## 许可证

该项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

---

© 2024 ToolBoxApp 团队

请注意，为了保护隐私和安全，本文档中已删除了所有个人可识别信息（PII）和某些网站的超链接。