升级你的现有曲库:Downtify本地音乐文件夹扫描、M3U导入与Library Upgrade修复功能
发布时间:2026/10/28 15:49:36 锦皓数字建站

【免费下载链接】downtifyDownload and listen to your music, playlists, and podcasts, along with album art and metadata项目地址https://gitcode.com/gh_mirrors/do/downtify点击查看免费下载很多人手头已经积累了大量 MP3 文件和 M3U 歌单但一直苦于缺少一个现代化的管理方式。Downtify 是一个自托管的音乐下载与播放工具它不用重新下载就能把你已有的音乐纳入管理扫描本地音乐文件夹自动建库、导入现成的M3U 播放列表再用Library Upgrade一键修复旧文件的封面、歌词和标签。这个项目通过 Docker 容器运行内置 Web 播放器、歌词同步、多用户和移动端支持详细介绍见 README.md。一键纳管本地音乐文件夹Existing Music Folders 扫描步骤如果你有一整个 NAS 音乐目录Downtify 的Existing music folders现有音乐文件夹功能可以让它直接看见这些文件而不做任何复制。添加文件夹的4个步骤把宿主机音乐目录挂载进容器Docker 场景下volumes: - ./downloads:/downloads - /path/on/host/to/mp3s:/music/collection打开Settings → Library。在Existing music folders中填入容器内路径如/music/collection输入时会给出目录建议。点击Sync folders立即扫描也可先 Save 稍后同步。同步时Downtify做了什么读取标签解析每个文件的标题、艺术家、专辑、曲目号、年份没有标签时回退到文件名Artist - Title。跳过重复曲库中已有同一首歌相同艺术家标题时长相近就不重复入库。合并艺术家The Beatles和Beatles会归并为同一位艺术家新艺术家还会自动触发头像/简介抓取。补齐元数据若文件夹可写会像正常下载一样写入歌词含.lrc伴生文件、缺失的封面和 iTunes 流派只读挂载时则把封面、流派存到/data/cover_cache和曲库数据库MP3 文件原样不动。后台执行同步在后台运行期间可以离开页面完成后 Settings 会显示导入/重复/错误的日志。支持 MP3、M4A、FLAC、OGG、WAV、AAC、OPUS 等格式。文件始终留在原处不会拷贝进/downloads从列表中移除文件夹只是取消映射磁盘上的音频不受影响。功能实现在 downtify/external_library.py完整说明见官方文档 docs/features/external-library.md。 顺带一提如果你只有从其他服务导出的 CSV 清单Soundiiz、TuneMyMusic、Exportify 均可首页搜索框下方的Import a library CSV可一次性把每首歌加入下载队列详见 docs/features/library-import.md。M3U播放列表导入指南先预览、再选择不复制文件对于已有的 M3U / M3U8 歌单Downtify 提供专门的导入入口避免把几千首曲子逐首手动加进歌单。导入现有M3U歌单的操作进入Library → Playlists → Import folder playlists。Downtify 扫描已配置的额外音乐文件夹找出其中的M3U和 UTF-8 编码的M3U8文件Deemix 生成的通用playlist.m3u8会用所在文件夹命名。预览结果可看到哪些条目可用、哪些缺失、哪些重复通用歌单会先重新预览再确认。勾选想要的歌单每次最多 50 个确认导入。导入会创建私有的可编辑 Downtify 歌单直接引用磁盘上已有的音频文件不修改源歌单、不移动外部文件、不下载任何音频。只接受位于已配置音乐根目录内的文件URL 和越界路径一律排除重复导入同一账号会复用已导入的歌单。限制为每文件 2 MiB / 2 万行、500 个候选条目、扫描上限 10 万条。实现见 downtify/external_playlists.py 与文档 docs/features/external-playlists.md。M3U 的另一半自动生成的歌单文件Downtify 每下载完一首歌就会重写一次对应播放列表的M3U文件标准EXTM3U/#EXTINF格式、UTF-8、相对路径因此 Jellyfin、Navidrome、Plex、VLC、Kodi、Sonos 都能直接识别。播放列表路径、生成时机与封面保存规则见 docs/features/m3u-export.md核心渲染函数是 downtify/m3u.py 中的build_m3u_content。Library Upgrade 曲库修复封面、歌词、标签一键升级老曲库往往带着时代的眼泪早期版本下载时只存下了小尺寸封面、没有歌词、标签里缺专辑和年份。Upgrade library就是专门修复这些问题的全程不重新下载。入口Library → Upgrade library。三步修复流程Scan扫描读取曲库中每一首歌按类别统计落后的内容此阶段不写任何文件。Choose选择扫描发现问题的类别会列出歌数并提供开关不想修的取消勾选即可。Upgrade执行入选歌曲进入队列逐条处理支持暂停、继续、停止重启容器后队列自动恢复状态存于/data/downtify_library.db。能修复什么类别修复内容来源Upgrade artwork替换小于目标尺寸的封面Spotify、Apple Music (iTunes)、YouTube MusicAdd missing lyrics为没有歌词的歌补上内嵌 .lrc伴生文件你在设置中排序的歌词源Refresh tags补齐专辑、专辑艺术家、发行年份、曲目号Spotify需保留 Spotify track ID歌曲被判定落后的标准内嵌封面短边小于目标尺寸或完全没有封面、既无内嵌歌词也无.lrc、标签中缺少专辑/专辑艺术家/年份/曲目号中的任何一项。关键选项Upgrade artwork below300px/500px/600px默认/1000px/1200px。只写入严格更大的封面重复运行不会做无用功。Artwork source默认最高可用分辨率问遍所有源取最大图也可偏好 Spotify / Apple Music / YouTube Music 某一来源。Dont check a track again for7 / 30默认/ 90 / 365 天。已检查过的歌曲会按歌曲类别记忆一段时间避免大曲库反复查询升级到更新版本的 Downtify 会自动重新检查全部歌曲。安全机制为什么文件不会损坏每次写入都先落到临时副本name.downtify-upgrade.ext标记定义见 downtify/library_upgrade.py验证副本是可播放的同时长音频后才替换原文件验证失败则丢弃副本、原文件保持原样。保留原始修改时间升级不会打乱最近添加排序。只读文件系统上的歌曲会在查询远端元数据之前被跳过可播放、仍保留在歌单中若目录后来变为可写它们会被再次考虑。音频本身永远不会被普通升级替换——想换版本请手动使用 Replace audio 功能。核心修复逻辑在 downtify/library_upgrade.py 的upgrade_track中完整行为与 API 说明见 docs/features/library-upgrade.md。总结Downtify 对已有曲库的升级路径非常完整场景功能入口已有本地音乐文件夹Existing music folders 扫描入库Settings → Library已有 M3U/M3U8 歌单Import folder playlists 预览导入Library → Playlists已有 CSV 曲库清单Import a library CSV首页搜索框下方旧文件封面小、缺歌词、标签不全Upgrade library 原地修复Library → Upgrade library文件始终留在原处、修复过程可随时暂停、队列可跨重启恢复——把这些组合起来老曲库升级成现代化音乐库基本就是几次点击的事。赞分享【免费下载链接】downtifyDownload and listen to your music, playlists, and podcasts, along with album art and metadata项目地址https://gitcode.com/gh_mirrors/do/downtify点击查看免费下载相关推荐MusicFreeDesktop本地文件扫描终极指南快速导入你的音乐库MusicFreeDesktop本地文件扫描终极指南快速导入你的音乐库 MusicFreeDesktop是一款插件化、定制化、无广告的免费音乐播放器支持本地音视频桌面应用beets unimported 插件扫描音乐库文件夹中未入库文件的完整指南beets unimported 插件扫描音乐库文件夹中未入库文件的完整指南 导读 unimported 是 beets 自带的一款轻量级实用插件核心功能是音频CLIM3U导出与媒体服务器集成将Downtify曲库无缝接入Jellyfin、Navidrome和PlexM3U导出与媒体服务器集成将Downtify曲库无缝接入Jellyfin、Navidrome和Plex Downtify 是一款自托管音乐下载器下载 Spo创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。