# ElegantApp

**Repository Path**: stud619/elegant-app

## Basic Information

- **Project Name**: ElegantApp
- **Description**: 音量统一小工具
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 音量统一 (Volume Unified)

一个轻量级的 Windows 桌面程序，用于批量标准化音频文件的响度到 -16 LUFS。

## ✨ 特性

- 🎯 递归扫描文件夹，支持 `.mp3`、`.flac`、`.wav`、`.m4a` 格式
- 📊 使用 ffmpeg loudnorm 精确分析响度
- ⚡ 智能跳过已在目标范围内的文件
- 💾 安全处理：临时文件机制，成功后才替换原文件
- 🎨 简洁优雅的 WPF 界面

## 📋 系统要求

**操作系统**：Windows 10 或更高版本（64位）

**必需组件**：
- .NET 8 Runtime（如果未安装，程序会提示下载链接）
  - 下载地址：https://dotnet.microsoft.com/download/dotnet/8.0
  - 选择 ".NET Desktop Runtime 8.0.x - x64"

> 💡 **提示**：Windows 10/11 通常已内置大部分运行时组件，只需安装 .NET 8 Runtime 即可。

## 🚀 快速开始

### 对于最终用户

1. 从 [Releases](../../releases) 页面下载最新版本
2. 解压到任意目录
3. 双击 `VolumeUnified.exe` 运行
4. 点击"选择文件夹"，选中要处理的音频文件夹
5. 点击"开始处理"

### 对于开发者

**环境要求**：
- .NET 8 SDK: https://dotnet.microsoft.com/download/dotnet/8.0

**编译运行**：
```bash
dotnet restore
dotnet run
```

**发布**：
```bash
# 使用批处理脚本（推荐）
publish.bat

# 或手动发布
dotnet publish -c Release -r win-x64 --self-contained false
```

发布后的文件位于 `dist/` 目录。

## 📖 使用说明

1. **选择文件夹**：点击按钮选择包含音频文件的根目录
2. **开始处理**：程序会递归查找所有支持的音频文件
3. **查看进度**：实时显示处理日志和进度条
4. **完成**：所有音频文件响度被标准化到 -16 ±0.5 LUFS

## 🔧 技术细节

- **目标响度**：-16 LUFS（符合播客和流媒体标准）
- **容差范围**：±0.5 LUFS（在此范围内的文件会被跳过）
- **处理方式**：先分析后处理，避免不必要的重编码
- **文件格式**：
  - FLAC：保持无损压缩
  - MP3：使用 LAME 编码器，质量等级 2
  - 其他：转换为 AAC

## 📦 发布包内容

```
dist/
├── VolumeUnified.exe          # 主程序（包含嵌入的 ffmpeg.exe 和 bg.jpg）
├── D3DCompiler_47_cor3.dll   # WPF 必需组件
├── PenImc_cor3.dll           # WPF 必需组件
├── PresentationNative_cor3.dll # WPF 必需组件
├── vcruntime140_cor3.dll     # WPF 必需组件
├── wpfgfx_cor3.dll           # WPF 必需组件
└── zh-Hans/                  # 简体中文资源（可选）
```

**总计**：约 7-8 个文件，15-20 MB

## ⚠️ 注意事项

- 处理过程会**覆盖原文件**，建议先备份重要音频
- 大文件处理可能需要较长时间
- 确保有足够的磁盘空间（需要临时文件空间）

## 📝 许可证

本项目仅供个人学习和使用。

## 🙏 致谢

- [ffmpeg](https://ffmpeg.org/) - 强大的音视频处理工具
- .NET Team - 优秀的跨平台开发框架