QQ Music Web

项目简介

一个基于FlaskAPI的在线音乐播放和下载平台，提供友好的Web界面，支持在线搜索、播放和下载功能。

Github地址： https://github.com/tooplick/qqmusic_web

功能特点

  • Web界面: 响应式设计
  • 多音质支持: 标准音质(MP3)和高品质音质(FLAC)
  • 在线搜索: 实时搜索QQ音乐库
  • 下载功能: 支持本地下载
  • 歌词显示: 实时同步歌词
  • 容器化: 支持Docker一键部署

使用方法

Docker一键部署（推荐）

1
2
# 从Github部署
sudo -E bash -c "$(curl -fsSL https://raw.githubusercontent.com/tooplick/qqmusic_web/main/docker/install.sh)"

如果网络有问题，使用Gitee仓库

1
2
# 从Gitee部署
sudo -E bash -c "$(curl -fsSL https://gitee.com/tooplick/qqmusic_web/raw/main/docker/giteeinstall.sh)"

手动安装

Clono 到本地
1
2
git clone https://github.com/tooplick/qqmusic_web
cd qqmusic_web
安装依赖
1
pip install -r requirements.txt
启动应用
1
python run.py

访问应用

  • 打开浏览器访问 http://localhost:6022

  • 凭证管理界面 http://localhost:6022/admin

示例网站: qq.ygking.top

Docker 配置说明

  • 凭证文件夹: /root/qqmusic_web/credential
  • 音乐存储: /root/qqmusic_web/music

QQ Music Download

项目简介

功能强大的命令行音乐下载工具，支持单曲搜索下载和歌单批量下载，具备完整的登录体系和多音质选择。

Github地址：https://github.com/tooplick/qq_music_download

功能特点

  • 智能搜索: 支持单曲搜索和歌单批量下载
  • 多音质选择: FLAC、MP3_320、MP3_128等音质
  • 批量处理: 支持一键下载所有歌单
  • 元数据完善: 自动添加歌词和专辑封面
  • 凭证管理: 自动刷新登录状态

使用方法

Clone 到本地

1
2
git clone --depth=1 https://github.com/tooplick/qq_music_download
cd qq_music_download

安装依赖

1
pip install -r requirements.txt

1. 登录与凭证管理

1
python credential.py

2. 单曲下载

1
python song.py

输入歌曲名称，选择搜索结果，自动下载最高可用音质。

3. 歌单下载

1
python songlist.py

输入music id，选择歌单自动批量下载整个歌单。

配置参数

1
2
3
4
COVER_SIZE = 800                    # 封面尺寸[150, 300, 500, 800]
DOWNLOAD_TIMEOUT = 30               # 网络超时时间
MUSIC_DIR = Path("./music")         # 音乐保存目录
SEARCH_RESULTS_COUNT = 5            # 搜索结果数量

Nekro Order QQMusic

项目简介

基于Nekro Agent框架的智能点歌插件，为Nekro Agent AI提供音乐点歌功能，支持Web界面管理。

Github地址：https://github.com/tooplick/nekro_order_qqmusic

功能特点

  • AI集成: 为聊天机器人提供音乐点歌功能
  • Web管理: 提供Web界面用于凭证管理
  • 音质可选: FLAC、MP3_320、MP3_128

使用方法

凭证生成（方法一：Web界面）

  1. 访问 http://<服务器ip:NA端口>/plugins/GeQian.order_qqmusic
  2. 点击”QQ登录”或”微信登录”按钮
  3. 使用手机扫描二维码完成登录
  4. 凭证自动保存

凭证生成（方法二：外部工具）

  1. 使用外部工具生成凭证文件 qqmusic_cred.pkl
  2. 将文件放入插件配置文件夹：
    /nekro_agent/plugin_data/GeQian.order_qqmusic/qqmusic_cred.pkl

Nekro Agent 调用

Nekro Agent AI可以通过调用 send_music() 方法来发送音乐

1
2
# 手动调用
/exec send_music("onebot_v11-private_12345678", "晴天")

API接口

  • GET /api/get_qrcode/{type} - 生成登录二维码
  • GET /api/credential/status - 检查凭证状态
  • POST /api/credential/refresh - 刷新凭证
  • GET /api/credential/info - 获取凭证信息

通用注意事项

  • 下载的音乐请于24小时内删除
  • 请支持正版音乐
  • 禁止用于商业盈利
  • 遵循GPL-3.0开源协议

联系信息

  • 作者: GeQian