https://github.com/luren-dc/qqmusic-downloader

🐧 QQ 音乐解析/下载工具
https://github.com/luren-dc/qqmusic-downloader

downloader music qqmusic rich typer

Last synced: 2 months ago
JSON representation

🐧 QQ 音乐解析/下载工具

• Host: GitHub
• URL: https://github.com/luren-dc/qqmusic-downloader
• Owner: luren-dc
• Created: 2024-11-10T07:50:19.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-08-11T12:54:10.000Z (2 months ago)
• Last Synced: 2025-08-11T13:26:15.178Z (2 months ago)
• Topics: downloader, music, qqmusic, rich, typer
• Language: Python
• Homepage:
• Size: 375 KB
• Stars: 49
• Watchers: 4
• Forks: 10
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


    

        

    

    

        

    

    

        

    

    

        

    

    

    

      

    



---

> [!NOTE]

> 重构中

**欢迎向本项目提出[Issues](https://github.com/luren-dc/QMDown/issues),贡献[Pull Requests](https://github.com/luren-dc/QMDown/pulls)**

> [!IMPORTANT]

> 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途

>

> **音乐平台不易，请尊重版权，支持正版。**

## 安装

### pip/pipx/uv 安装

```bash

# 通过 pip

pip install QMDown

# 使用 pipx

pipx install QMDown

# 或者使用 uv

uv tool install QMDown

```

### 体验 main 分支最新特性

```bash

# 通过 pip

pip install git+https://github.com/luren-dc/QMDown@main

# 通过 pipx

pipx install git+https://github.com/luren-dc/QMDown@main

# 通过 uv

uv tool install git+https://github.com/luren-dc/QMDown.git@main

```

## 特色

- 支持登录

  - [x] 二维码

    - [x] QQ

    - [x] WX

  - [x] 手机号

- 支持类型

  - [x] 歌手

  - [x] 专辑

  - [x] 歌单

  - [x] 歌曲

  - [x] 排行榜

### 已支持下载类型

| 类型   | 示例链接                                                                                                                                 |

|------|--------------------------------------------------------------------------------------------------------------------------------------|

| base | `https://c6.y.qq.com/base/fcgi-bin/u?__=jXIuFz8tBzpA`                                                                                |

| 歌曲   | `https://y.qq.com/n/ryqq/songDetail/004Ti8rT003TaZ` 
 `https://i.y.qq.com/v8/playsong.html?songmid=004UMhHW33BWSk`               |

| 歌单   | `https://y.qq.com/n/ryqq/playlist/1374105607` 
 `https://i.y.qq.com/n2/m/share/details/taoge.html?id=7524170477`                 |

| 专辑   | `https://y.qq.com/n/ryqq/albumDetail/003dYC933CfoSi` 
 `https://i.y.qq.com/n2/m/share/details/album.html?albumId=50967596`       |

| 排行榜  | `https://y.qq.com/n/ryqq/toplist/3` 
 `https://i.y.qq.com/n2/m/share/details/toplist.html?id=26`                                 |

| 歌手   | `https://y.qq.com/n/ryqq/singer/001BLpXF2DyJe2` 
 `https://i.y.qq.com/n2/m/share/profile_v2/index.html?singermid=0025NhlN2yWrP4` |

## 基本使用

```console

 

 用法： QMDown [OPTIONS] URL

 QQ 音乐解析/下载工具

╭─ 参数 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────╮

│ *    urls      URL  歌曲或专辑的 URL(可包含其他字符) [必需]                                                          │

╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

╭─ 选项 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────╮

│ --no-color            禁用彩色输出                                                                                   │

│ --debug               启用调试日志输出                                                                               │

│ --version   -v        输出版本信息                                                                                   │

│ --help                显示此帮助信息并退出                                                                           │

╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

╭─ 下载 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────╮

│ --quality    -q      [master|atmos_2|atmos_51|flac|ogg_640|ogg_320|  首选音频品质 [默认值：MP3_128]                  │

│                      mp3_320|ogg_192|mp3_128|ogg_96|acc_192|acc_96|                                                  │

│                      acc_48]                                                                                         │

│ --output     -o      目录                                            下载文件存储目录                                │

│ --workers    -n      INTEGER RANGE [x>=1]                            并发下载协程数量 [默认值：5]                    │

│ --overwrite  -w                                                      覆盖已存在文件                                  │

╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

╭─ 登录 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────╮

│ --login        [qq|wx|phone]  第三方登录方式                                                                         │

╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

```

### 音质说明

点击展开

| 音频格式     | 说明    |

|----------|-------|

| MASTER   | 臻品母带  |

| ATMOS_2  | 臻品全景声 |

| ATMOS_51 | 臻品音质  |

## Licence

本项目基于 **[MIT License](https://github.com/luren-dc/QMDown?tab=MIT-1-ov-file)** 许可证发行。

## 免责声明

由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害（包括但不限于因商誉损失、停工、计算机故障或故障引起的损害赔偿，或任何及所有其他商业损害或损失）由使用者负责

## 贡献者

[![Contributor](https://contrib.rocks/image?repo=luren-dc/QMDown)](https://github.com/luren-dc/QMDown/graphs/contributors)