# flac-renamer

**Repository Path**: lrt99/flac-renamer

## Basic Information

- **Project Name**: flac-renamer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

最近在网上下载了很多的音乐

发现下载下来的全部都是这种命名的音乐文件

![输入图片说明](204930qowy75xl2c4o2uqb.png)
这让人咋分类啊，好在这些音乐文件内置标签都有名称和分类，于是就用deepseek+Reasonix做了现在这个飞牛应用：音乐批量重命名；有需要的朋友可下载使用

​![输入图片说明](205422mde2gc5wgczm2d9g.png)


配置可读取的文件夹
![输入图片说明](205516c6ab74yhy486hm28.png)
![输入图片说明](210106pp4y5bvv60vyvyxt.png)
![输入图片说明](210132r8t5oq4j33p5t333.png)

 🎵 FLAC 批量重命名工具 (FLAC Renamer)

一个轻量级的本地桌面应用，用于根据音频元数据标签（艺术家、专辑、曲目名等）批量规范化重命名 FLAC 文件。特别适配 **飞牛私有云 (fnOS)** 环境，适合家庭媒体库的日常维护。

## ✨ 核心功能
- 📂 **智能扫描**：递归检索指定目录下的所有 `.flac` 文件
- 🏷️ **深度解析**：精准提取 FLAC VORBIS 注释标签（Artist, Album, Title, Track, Disc, Year 等）
- 🔧 **模板引擎**：支持灵活的自定义命名规则拼接
- 👁️ **无损预览**：执行变更前提供清晰的文件映射对照表，支持一键取消
- ⚡ **冲突拦截**：自动检测重命名后的文件路径冲突，防止覆盖意外

## 🛠️ 技术架构
- **后端服务**：Node.js (`app/server.js`)
  负责 HTTP 通信、文件系统 I/O 调度及底层 FLAC 标签解析。
- **前端交互**：原生 Vanilla JS + HTML/CSS (`app/ui/`)
  零重型框架依赖，保障桌面端运行的轻量与稳定。
- **核心依赖**：`music-metadata`
  业界标准的音频元数据解析库。

## 📁 项目
```flac-renamer/
├── app/                 # 核心程序目录
│   ├── server.js        # 后端服务入口：处理标签读写、文件搜索、重命名逻辑
│   └── ui/              # 用户界面目录
│       ├── app.js       # 前端业务逻辑：UI渲染、预览生成、API请求
│       ├── index.html   # 页面结构
│       └── style.css    # 样式表
├── cmd/                 # 系统命令与回调钩子
├── config/              # 应用配置与默认值
└── README.md            # 本说明文档