音乐搜索、试听、下载一体工具，Material Design 3 Web 界面，支持视频下载。
基于 GD Studio Music API 构建。
功能
音乐
- 多源搜索 — 网易云、酷我、JOOX、Bilibili
- 在线试听 + 播放进度条
- 下载 + 元数据嵌入（MP3 / FLAC / M4A，封面，ID3 标签）
- 封面图自动获取（多源回退）
视频
- yt-dlp 驱动 — YouTube、Bilibili 等数百个站点
- 画质预设（最佳、1080p、720p、480p、纯音频）
- 播放列表 / 合集支持
- Cookie 支持登录限定内容
Web UI
- Material Design 3 暗色主题
- 音乐 / 视频模式切换
- 下载历史管理
- 分模式设置记忆
CLI
- 搜索、下载、歌词、封面全部支持
- Rich 进度条（速度 + ETA）
安装
git clone https://github.com/Tom8266/music_downloader.git
cd music_downloader
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
使用
# Web UI
./webui.py # http://127.0.0.1:8080
./webui.py --port 9090 --debug # 热重载开发模式
# CLI 搜索 & 下载
./music_dl.py search 周杰伦
./music_dl.py download <id> --name 大鱼 --artist 周深
# 视频
./music_dl.py video info <url>
./music_dl.py video download <url> -q 1080
技术栈
Python 3.10+ / Flask / requests / mutagen / yt-dlp / Rich / waitress
AGPLv3 开源协议 — 仅供学习 Python Web 开发和个人合理使用，严禁商业用途和侵权分发。