yubal 

如果你希望将 YouTube Music 中的音乐永久保存到本地，并获得一个结构清晰、元数据完整、可直接用于媒体服务器的音乐库，那么 yubal 正是你需要的解决方案。它不仅仅是一个下载器，更是一个全自动的音乐库管家。

核心理念：输入链接，输出完美音乐库

yubal 的设计哲学极为简洁：你只需提供一个 YouTube Music 的专辑、播放列表或单曲链接，它便会自动完成后续所有繁杂工作。最终，你会得到一个按艺术家和年份分类的文件夹结构，所有音频文件都带有准确的元数据标签（如歌曲名、艺术家、专辑、封面等），并且播放列表中的重复曲目会被智能去重，确保你的硬盘空间不被浪费[[2]]。

关键功能详解

• 直观的网页界面：通过浏览器即可管理所有下载任务。界面提供实时进度显示、任务队列管理，并适配各种设备屏幕，操作体验流畅。
• 全面的链接支持：无论是整张专辑、精心策划的播放列表，还是单首歌曲，yubal 都能完美处理。
• 智能去重系统：如果同一首歌出现在多个播放列表中，yubal 只会下载并存储一次该文件，然后在各个播放列表目录中创建引用，既节省空间又保持逻辑清晰。
• 稳定可靠的下载：内置自动重试机制，即使网络波动导致下载中断，也能自动恢复。用户也可以随时安全地中止任务，无需担心文件损坏。
• 自动歌词同步：当歌词可用时，yubal 会一并下载标准的 .lrc 格式歌词文件，方便在支持的播放器中使用。
• 灵活的音频格式：默认以 YouTube Music 原生的 Opus 格式下载，保证最佳音质。同时，也支持转码为更通用的 MP3 或 M4A 格式，以满足不同设备的兼容性需求。
• 即插即用的媒体服务器支持：生成的音乐库结构已通过 Navidrome、Jellyfin 和 Gonic 等主流媒体服务器的测试，导入后即可无缝使用，省去了手动整理的麻烦。

对于追求本地音乐库整洁、高效和高质量的用户而言，yubal 提供了一套从下载到归档的一站式自动化流程，彻底解决了从流媒体平台迁移音乐的痛点。