meidlinger1024/tune-tree repository overview

⁠TUNE-TREE⁠

自托管音乐库整理工具。扫描、浏览、重组本地音乐收藏，在线获取、编辑原数据，在线获取、编辑歌词，快速编辑时间轴。

⁠功能特性

• 目录扫描 -- 递归扫描音乐根目录，将所有曲目索引到 SQLite，支持并行处理
• 待定文件 -- 列出缺少完整元数据的文件，支持在线编辑元数据
• 元数据读取 -- 通过 mutagen 提取 ID3v2 / Vorbis Comment 标签、内嵌封面和歌词
• 元数据刮削 -- 自动从网易云音乐、酷狗 获取缺失的标签、歌词和封面
• 歌词编辑 -- 支持在线编辑歌词，包括时间轴同步
• Web 浏览 -- 按艺术家、专辑、曲目浏览，单页前端界面，支持夜间模式
• 文件格式化 -- 预览并执行批量重命名与移动，整理为 {艺术家}/{专辑}/ 目录结构
• 重复检测 -- 识别音乐库中的重复文件
• 访问控制 -- 基于 Token 的简单认证

⁠平台预览

⁠艺术家列表及详情

⁠搜索艺术家头像

⁠编辑元数据

⁠搜索元数据标签

⁠搜索歌词、编辑歌词和时间轴

⁠单艺术家格式化预览

⁠艺术家多选格式化预览

⁠目录浏览

⁠上传文件冲突检测

⁠批量获取标签

⁠艺术家多选格式化

⁠专辑多选格式化

⁠统计概览

⁠艺术家统计面板 统计概览

⁠艺术家统计面板 相似度检测

⁠专辑统计面板 统计概览

⁠专辑统计面板 时间轴

⁠重复文件详情

⁠设置面板

⁠夜间模式

⁠快速启动

⁠使用 Docker Compose（推荐）

services:
  tune-tree:
    image: meidlinger1024/tune-tree:latest
    container_name: tune-tree
    restart: always
    ports:
      - "15000:5000"
    volumes:
      - /path/to/your/music:/app/music
      - /path/to/your/db:/app/db
    environment:
      - TZ=Asia/Shanghai
      - ACCESS_KEY=tunetree-2026
      - DB_ROOT=/app/db

⁠使用 Docker Run 命令

docker run -d \
  --name tune-tree \
  --restart always \
  -p 15000:5000 \
  -v /path/to/your/music:/app/music \
  -v /path/to/your/db:/app/db \
  -e TZ=Asia/Shanghai \
  -e ACCESS_KEY=tunetree-2026 \
  -e DB_ROOT=/app/db \
  meidlinger1024/tune-tree:latest

⁠配置说明

⁠访问

启动后浏览器打开 http://localhost:15000，默认密钥⁠ tunetree-2026

⁠支持格式