Songloft音乐库管理全攻略：自动扫描、元数据提取、CUE整轨拆分与曲库分类浏览

Songloft音乐库管理全攻略自动扫描、元数据提取、CUE整轨拆分与曲库分类浏览【免费下载链接】songloft 插件化、无广告的免费音乐服务器项目地址: https://gitcode.com/gh_mirrors/so/songloftSongloft 是一款插件化、无广告的免费音乐服务器它的音乐库管理帮你解决四大痛点一键自动扫描导入本地音乐、双通道元数据提取自动填充歌曲信息、CUE 整轨无损拆分让专辑变单曲、14 个视图分类浏览曲库随心切换。这篇完整指南带你从零把几万个音乐文件变成井然有序的数字曲库 快速上手配置音乐目录与扫描参数扫描前只需两步指定音乐根目录按需添加排除项。音乐根目录默认相对数据目录的music扫描器会递归遍历所有子目录支持软链接且自动防环路死循环排除规则两级按目录名匹配任意层级命中即排除适合屏蔽 NAS 生成的eaDir缩略图目录或按完整路径精确排除格式白名单内置 20 余种音频/视频容器mp3、flac、wav、ape、ogg、m4a、mp4、opus等开箱即用。扫描器实现位于 internal/services/scanner.go详细流程见 docs/repowiki/核心功能实现/音乐管理.md。智能细节正在拷贝的文件不会入库修改时间在 10 秒以内的文件会被判定为正在传输而跳过避免把不完整的文件导入曲库——大批量往 NAS 拷歌时特别实用。自动扫描让曲库自己保持更新手动点扫描只适合偶尔更新。开启自动扫描后Songloft 会按固定间隔后台轮巡音乐目录只导入新增文件秒级增量更新。配置项说明开关默认关闭开启后立即生效无需重启扫描间隔60 秒 ~ 24 小时超出范围自动钳位到边界值防重入上一轮扫描未结束时自动跳过本轮修改音乐路径、排除目录等配置后系统会自动清理已移出扫描范围的旧记录曲库始终与磁盘保持一致。相关代码见 internal/services/auto_scan.go 与 internal/handlers/scan.go。元数据提取双通道解析歌曲信息自动补全扫描时每首歌曲的标题、艺术家、专辑、时长、封面、歌词、ISRC 都会被自动提取采用tag 库优先、ffprobe 兜底的分层策略实现于 internal/services/metadata.gotag 库快速通道MP3/FLAC/M4A 等主流格式直接读取内嵌标签不启动子进程批量扫描速度显著提升ffprobe 兜底通道tag 库解析失败或时长缺失如 VBR 文件时才调用 ffprobe 补充技术参数。几个值得了解的设计标题来源可配默认tag 优先缺失则用文件名也可强制始终使用文件名封面自动去重按 SHA-256 哈希分层存储整库相同封面只保留一份歌词优先级旁挂.lrc文件 内嵌歌词自动处理 UTF-16/GBK 编码垃圾 tag 防御同一目录下超过 50% 文件共享相同标题艺术家时判定为盗版广告 tag自动回退为文件名手动歌词受保护你手工修改过的歌词manual来源在重新扫描时不会被覆盖。CUE 整轨拆分一张专辑不用切直接当单曲播放刻录盘镜像一张 FLAC 对应整张专辑是 CUE 曲库的典型形态。Songloft 的按需拆分方案internal/services/song_service_cue.go、pkg/cue/不复制、不切割文件而是在扫描时解析 CUE Sheet把每一轨作为独立歌曲入库两种来源都支持外部.cue文件.cue/.CUE/.Cue均可识别以及 FLAC 文件内嵌的 CUESHEET block同名时外部 CUE 优先播放精准定位每轨记录起止时间播放时直接 seek音频文件只存一份零空间浪费重新导入友好CUE 源更新后重新扫描会先清除旧轨记录再重建避免重复条目源文件删除后对应曲目也会被自动清理指纹按轨采样重复检测时按各轨时间区间单独采样避免整轨镜像下所有曲目指纹雷同。曲库分类浏览14 个视图一键切换浏览维度扫完的曲库不止能列表播放。Songloft 的统一浏览页提供 14 个视图分三组配置见 internal/handlers/library_browse_setting.go分组视图说明 歌曲组全部 / 本地 / 网络 / 电台按来源过滤的扁平歌曲列表 分类组歌手 / 专辑 / 流派 / 年份 / 年代 / 语种 / 风格facet 聚合分类点一下即可下钻到该分类下的歌曲 歌单组全部歌单 / 普通歌单 / 电台歌单歌单卡片列表所有视图都支持显示开关和拖拽排序不常听的维度可以隐藏常用维度放前面曲库页完全按你的习惯组织。分类维度基于数据库聚合索引构建见 internal/database/queries/songs.sql几万首歌的分类聚合依然秒开。扫描后自动建歌单按目录结构一键整理开启扫描后自动创建歌单后每轮扫描结束会按你的目录结构重建auto_created歌单旧的先清除再重建永不产生僵尸歌单。三种归并模式任选directory每个目录独立建单粒度最细top_level只按一级目录建单适合歌手/专辑两级目录bubble_up子目录歌曲上卷到父级歌单兼顾层级与聚合。配合歌曲文件整理功能按艺术家/专辑批量移动重命名自动回滚保证数据库与磁盘一致本地曲库可以越理越干净。常见问题速查Q扫描会重复导入已有歌曲吗不会。扫描前会比对数据库中的本地文件已存在且时长完整的直接跳过只处理新增和变更。Q网络歌曲、电台也能入库吗能。除本地扫描外还支持通过插件批量添加远程歌曲按去重 key 自动防重复和电台源下载后还能一键转为本地歌曲。Q重复歌曲怎么找开启音频指纹计算Chromaprint扫描后自动计算默认关闭以省 CPU随后在重复歌曲检测页查看按指纹聚类的重复组可批量删除文件。写在最后Songloft 的音乐库管理把扫描 → 提取 → 拆分 → 分类 → 建单做成了闭环配置一次音乐目录开启自动扫描剩下的交给它。无论是几万首的 NAS 曲库还是一张 CUE 刻录镜像都能在几轮扫描后变得井井有条 音乐管理完整文档docs/repowiki/核心功能实现/音乐管理.md歌单管理设计docs/repowiki/核心功能实现/歌单管理.md扫描进度状态机internal/services/scan_progress.go【免费下载链接】songloft 插件化、无广告的免费音乐服务器项目地址: https://gitcode.com/gh_mirrors/so/songloft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考