- **智能下载管理**: 支持 YouTube 播放列表和专辑批量下载，自动去重，避免重复下载 - **完整元数据支持**: 自动嵌入艺术家信息、专辑封面、曲目编号等完整元数据 - **自动化调度**: 内置 Cron 定时任务，支持自动更新播放列表，保持音乐库最新 - **M3U 播放列表生成**: 自动生成标准 M3U 播放列表文件，兼容 Gonic 等音乐服务器 - **实时进度监控**: WebSocket 实时推送下载进度和日志，随时掌握下载状态 - **文件浏览器**: 内置文件管理器，支持在线预览和播放已下载的音乐 - **智能分类**: 自动按专辑分类音乐文件，未分类歌曲归入"Unsorted Songs" - **高级配置**: 支持超时设置、重试次数、并发限制等高级参数配置 - **Cookie 支持**: 支持导入 YouTube cookies，访问会员专属内容 注意：需要小猪佩奇或者小猫咪配合使用 ### Step 1: 访问应用 点击应用打开，或者网页打开 ### Step 2: 基础配置 首次使用建议先配置以下参数： 1. **音乐存储路径**: 默认为 `/music`，无需修改 2. **播放列表路径**: 默认为 `/playlists`，无需修改 3. **超时设置**: - 元数据获取超时: 建议 1200 秒 - 下载超时: 建议 3600 秒 4. **重试次数**: 建议设置为 5 次 ### Step 3: 添加播放列表 1. 打开 YouTube Music，找到您想下载的播放列表或专辑 2. 复制播放列表链接，格式如下： - 播放列表: `https://www.youtube.com/playlist?list=PLRBp0Fe2GpgmsW46rJyudVFlY6IYjFBIK` （无版权音乐，可测试用） - 专辑: `https://music.youtube.com/playlist?list=OLAK5uy_xxxxxx` 3. 在 Synthwave 界面中，将链接粘贴到"添加播放列表"输入框 4. 点击"添加"按钮 ### Step 4: 开始下载 1. 确认已添加所有需要下载的播放列表 2. 点击"开始下载"按钮 3. 在"下载进度"标签页查看实时进度和日志 **下载流程说明**: - **第一遍扫描**: 下载所有专辑（带 `OLAK5uy_` 标识的链接） - **第二遍扫描**: 下载播放列表中的歌曲 - 如果歌曲已存在于某个专辑中，则跳过下载，直接引用 - 如果歌曲不属于任何专辑，则下载到"Unsorted Songs"文件夹 - **生成播放列表**: 为每个播放列表生成 `.m3u` 文件 ### Step 5: 配置定时任务（可选） 如果您希望自动更新播放列表，可以启用定时任务： 1. 在"自动化"标签页中，启用"定时任务"开关 2. 配置 Cron 表达式，例如： - 每天凌晨 2 点执行: `0 2 * * *` - 每周日凌晨 3 点执行: `0 3 * * 0` 3. 点击"保存配置" 定时任务会自动检查播放列表更新并下载新增歌曲。 ### Step 6: 文件浏览与播放 在"文件浏览器"标签页中，您可以： - 浏览已下载的音乐文件 - 在线预览和播放音乐 - 查看文件元数据信息 --- ## 高级功能 ### Cookie 配置 如果需要下载会员专属内容或私有播放列表，可以配置 YouTube cookies： 1. 使用浏览器插件（如"Get cookies.txt"）导出 YouTube 的 cookies 2. 将 cookies 文件保存为 `cookies.txt` 3. 点击应用内Choose cookies.txt，选择文件上传，显示Status: V Cookies file uploaded and enabled即表示上传成功。 ### 下载模式配置 应用支持三种下载模式： - **both** (默认): 同时下载专辑和播放列表 - **playlists_only**: 仅下载播放列表，跳过专辑扫描 - **albums_only**: 仅下载专辑，跳过播放列表扫描 在配置页面的"下载模式"下拉菜单中选择即可。 ### 调试模式 如果遇到下载问题，可以启用调试模式获取详细日志： 1. 在配置页面启用"调试模式" 2. 重新开始下载 3. 在"调试日志"标签页查看详细的 yt-dlp 输出 --- ## 常见问题 ### Q1: 下载速度很慢怎么办？ **A**: 下载速度受以下因素影响： - YouTube 服务器限速 - 网络带宽限制 - 音频转码速度 建议： - 避免在网络高峰期下载 - 适当增加"下载超时"时间 - 减少并发下载数量 ### Q2: 某些歌曲下载失败怎么办？ **A**: 可能的原因： - 视频已被删除或设为私有 - 地区限制 - 版权限制 解决方案： - 检查视频是否可以在 YouTube 上正常播放 - 尝试配置 cookies（如果是会员内容） - 查看错误日志了解具体失败原因