pymelodia 1.1.5

🎵 网易云音乐下载工具

🎵 Melodia

网易云音乐下载工具

🚀 快速开始

安装

pip install pymelodia

基本使用

# 下载单首歌曲
melodia download song 390345

# 下载歌单
melodia download playlist 123456

# 下载指定分类的音乐
melodia download category 华语

# 下载所有分类
melodia download all

# 获取下载链接
melodia get link 390345

# 清理重复文件
melodia clean /path/to/music

📖 详细使用

下载命令

# 单曲下载
melodia download song 390345

# 批量下载多首歌曲
melodia download song "['390345', '123456', '789012']"

# 歌单下载
melodia download playlist 2829883282

# 批量下载多个歌单
melodia download playlist "['2829883282', '3779629']"

# 分类下载（支持华语、欧美、日语等）
melodia download category 华语

# 下载所有支持的分类
melodia download all

配置选项

# 设置保存路径
melodia --save-path /path/to/music download song 390345

# 设置请求延时（避免频率限制）
melodia --delay 1 download category 华语

# 设置最大页数
melodia --max-pages 50 download all

# 设置用户Cookie（提升成功率）
melodia --cookie "your_cookie_here" download playlist 123456

# 启用多线程下载（默认开启，4个线程）
melodia --threading --thread-count 8 download playlist 123456

# 禁用多线程下载（单线程模式）
melodia --no-threading download playlist 123456

# 设置临时文件目录
melodia --temp-dir /tmp/melodia download category 华语

支持的音乐分类

语言分类：华语、欧美、日语、韩语、粤语

风格分类：流行、摇滚、民谣、电子、舞曲、说唱、轻音乐、爵士、乡村

场景分类：清晨、夜晚、学习、工作、午休、下午茶、地铁、驾车

情感分类：怀旧、清新、浪漫、伤感、治愈、放松、孤独、感动

主题分类：综艺、影视原声、ACG、儿童、校园、游戏、经典

🎯 界面预览

🎵 Melodia 🎵
════════════════════════════════════════════════════════════════

批量下载(12首)            [████████████░░░░░░░░░░] 60.0% (7/12)
线程状态                  [██████████████████░░] 90.0% (9/10)
歌单列表                  [████████████████████] 100.0% (8/8)

📝 实时日志
────────────────────────────────────────────────────────────────
[14:32:15] [INFO] ℹ️ 启用多线程下载，线程数: 4
[14:32:15] [INFO] ℹ️ 开始下载歌曲 ID: 390345
[14:32:16] [SUCCESS] ✅ [线程-1] 成功下载: 周杰伦 - 晴天
[14:32:16] [SUCCESS] ✅ [线程-2] 成功下载: 林俊杰 - 江南
[14:32:17] [INFO] ℹ️ 正在处理歌单...

⚙️ 高级配置

配置文件

程序会在用户目录下创建配置文件 ~/.melodia/config.json：

{
  "save_path": "./music/",
  "delay": 0,
  "max_pages": 20,
  "cookie": "",
  "music_class": "全部",
  "temp_path": "./temp.mp3",
  "temp_dir": "./temp/",
  "hashed_storage_enabled": false,
  "hashed_storage_digit": 30,
  "threading_enabled": true,
  "thread_count": 4
}

环境变量

export MD_SAVE_PATH=./music/
export MD_TEMP_PATH=./temp.mp3
export MD_TEMP_DIR=./temp/
export MD_CLASS=华语
export MD_DELAY=0
export MD_COOKIE=""
export MD_MAX_PAGES=20
export MD_HASHED_STORAGE=false
export MD_HASHED_STORAGE_DIGIT=30
export MD_THREADING_ENABLED=true
export MD_THREAD_COUNT=4

配置管理命令

# 显示当前配置信息
melodia config show
melodia get config

# 保存配置到文件
melodia config save --hashed-storage --hashed-storage-digit 30

# 保存多线程配置
melodia config save --threading --thread-count 8 --temp-dir ./temp/

# 禁用多线程并保存
melodia config save --no-threading

参数优先级

命令行参数 > 环境变量 > 配置文件 > 默认值

🛠️ 开发

本地开发

git clone https://github.com/yht0511/MusicSpider.git
cd MusicSpider
pip install -e .

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

⚠️ 免责声明

本工具仅供学习和研究使用，请勿用于商业用途。下载的音乐文件请在24小时内删除，如需长期使用请购买正版音乐。