Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fengliufeseliud/pycloudmusic
优雅的异步高性能 Python 音乐 API 库 (网易云音乐)
https://github.com/fengliufeseliud/pycloudmusic
api netease netease-cloud-music python rewrite
Last synced: 2 months ago
JSON representation
优雅的异步高性能 Python 音乐 API 库 (网易云音乐)
- Host: GitHub
- URL: https://github.com/fengliufeseliud/pycloudmusic
- Owner: FengLiuFeseliud
- License: mit
- Created: 2022-07-16T05:16:43.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-19T11:33:59.000Z (about 1 year ago)
- Last Synced: 2023-12-07T11:57:15.961Z (about 1 year ago)
- Topics: api, netease, netease-cloud-music, python, rewrite
- Language: Python
- Homepage: https://fengliufeseliud.github.io/pycloudmusic/
- Size: 5.22 MB
- Stars: 25
- Watchers: 1
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pycloudmusic
**优雅的异步高性能 Python 音乐 API 库**
开箱即用/简单/快速 Python >= 3.9
[基于 NeteaseCloudMusicApi 改写](https://github.com/Binaryify/NeteaseCloudMusicApi)
[项目文档 (移动至 Github Pages): https://fengliufeseliud.github.io/pycloudmusic](https://fengliufeseliud.github.io/pycloudmusic)
# 快速入门
## 安装
使用 pip 即可安装 pycloudmusic
```bash
pip install pycloudmusic
```
## 输出对象
pycloudmusic 下的所有对象被打印时都会格式化输出类所有变量， 方便查看对象数据
```python
from pycloudmusic import Music163Api
import asyncio
async def main():
musicapi = Music163Api()
# 获取歌曲 421531
# https://music.163.com/#/song?id=421531
music = await musicapi.music(421531)
# 打印歌曲信息
print(music)
print("=" * 50)
asyncio.run(main())
```
此处数据为打印歌单对象
## 可迭代对象
pycloudmusic 下的部分对象可以被迭代使用
如下获取歌单 PlayList 对象后可以直接 for in PlayList 对象， 将迭代返回按歌单曲目生成的 Music 对象
```python
from pycloudmusic import Music163Api
import asyncio
async def main():
musicapi = Music163Api()
# 获取歌单 7487291782
# https://music.163.com/#/playlist?id=7487291782
playlist = await musicapi.playlist(7487291782)
# 打印歌单信息
print(playlist)
print("=" * 50)
# 打印歌单曲目
for music in playlist:
print(music.name, music.artist_str, music.id)
asyncio.run(main())
```
因此可以使用推导式快速生成 task 列表下载歌单曲目
```python
from pycloudmusic import Music163Api
import asyncio
async def main():
musicapi = Music163Api()
# 获取歌单 7487291782
# https://music.163.com/#/playlist?id=7487291782
playlist = await musicapi.playlist(7487291782)
# 创建任务
tasks = [asyncio.create_task(music.play()) for music in playlist]
# 等待任务
await asyncio.wait(tasks)
asyncio.run(main())
```
## 模拟登录
pycloudmusic 支持邮箱登录， 二维码登录， 手机密码登录， 手机验证码登录
这里可以用邮箱登录长期保持 Cookie 有效性，邮箱登录不需要人为操作
```python
from pycloudmusic import LoginMusic163
import asyncio
async def main():
login = LoginMusic163()
# 邮箱登录
code, cookie, musicapi = await login.email("you login email", "you login password")
# 验证登录
print("=" * 60)
print(code, cookie, musicapi)
print("=" * 60)
print(await musicapi.my())
asyncio.run(main())
```
## 评论
pycloudmusic 支持网易云的所有评论， 对支持评论的对象使用 Music163Comment 的方法即可
```python
"""获取歌曲评论"""
from pycloudmusic import Music163Api, Page
import asyncio
async def main():
musicapi = Music163Api()
# 获取歌曲
# https://music.163.com/song?id=1902224491&userid=492346933
music = await musicapi.music(1902224491)
# 按时间获取评论
async for comments in Page(music.comments, hot=False):
for comment in comments:
print(f"{comment.user_str}: {comment.content}")
asyncio.run(main())
```
## 错误处理
API 返回 200 以外状态码触发 Music163BadCode 错误
错误对象.code 获取 API 状态码，错误对象.data 获取 API 数据
```python
from pycloudmusic import Music163Api, Music163BadCode
import asyncio
async def main():
musicapi = Music163Api()
try:
playlist = await musicapi.playlist(7487291782)
except Music163BadCode as err:
print(err, err.code, err.data)
asyncio.run(main())
```
## 代理设置
pycloudmusic 支持 proxy 时出现错误触发回调来更新 proxy
```python
from pycloudmusic import Music163Api, set_proxy, set_proxy_callback
import asyncio
# 正常这里是多个 proxy ip
proxy = [
"http://117.114.149.66:55443"
]
# 设置 proxy
set_proxy(proxy[0])
# proxy 更新回调
def proxy_callback(err):
# 如果 proxy 时出现错误这里更新
# 第一个返回值新的 proxy ip
# 第二个返回值 aiohttp.BasicAuth proxy 身份验证, 没有为 None
return proxy[0], None
# 设置 proxy 更新回调
set_proxy_callback(proxy_callback)
async def main():
musicapi = Music163Api()
# 获取歌曲 421531
# https://music.163.com/#/song?id=421531
music = await musicapi.music(421531)
await music.play()
# 打印歌曲信息
print(music)
print("=" * 50)
asyncio.run(main())
```