# pyncm

**Repository Path**: June_King/pyncm

## Basic Information

- **Project Name**: pyncm
- **Description**: NeteaseCloudMusic APIs for Python 3.x 适用于 Python 3 的网易云音乐 API
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-02-28
- **Last Updated**: 2021-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PyNCM
NeteaseCloudMusic APIs for Python 3.6+ 适用于 Python 3.6+ 的网易云音乐 API

# 安装
    pip install pyncm

# 直接使用
API 可以通过命令行直接访问，请参照下列命令输出进行操作
    python -m pyncm -h

# 命令行使用说明
## 配置
- `pyncm config` 可以将输入的参数存储在 ~/.pyncm 中，一劳永逸
		python -m pyncm config --phone [your phone number] --password [your password] --output Downloads --clear-temp --quality lossless --logging-level 30
	- 解释
	`--phone --password` 登录令牌；将会以 cookie 的形式被保存
	`--output` 输出文件夹
	`--clear-temp` 自动清除下载临时文件
	`--quality` 下载质量
	`--logging-level` 日志过滤等级
	- **优先级:** 若在使用中设置了其他参数，命令行的参数会作为该会话的设置

## 使用
### 下载歌曲
`pyncm song --id [歌曲 ID]`
### 下载歌单
`pyncm playlist --id [歌单 ID]`
### 下载专辑
`pyncm album --id [专辑 ID]`
### 关于 ID
可通过网易云音乐的“分享链接”功能取得

如 `https://music.163.com/playlist?id=3199245372&userid=315542615`，该ID即为`3199245372`

其他功能详见 [Wiki](https://github.com/greats3an/pyncm/wiki) *API部分用了中文解释，别的懒得动了🙄*


# Python 使用示例
    from pyncm import apis
    # 获取歌曲信息    
    apis.track.GetTrackAudio(29732235)
    `{'data': [{'id': 29732235, 'url': 'http://m701.music.126.net/20200313090222/479f50d5748625d59d405c7a219f3f5b/jdyyaac/040f/565c ...`    
    # 获取歌曲详情
    apis.track.GetTrackDetail(29732235)    
    `{'songs': [{'name': 'Supernova', 'id': 29732235, 'pst': 0, 't': 0, 'ar': [{'id': 38725, 'name': 'Laszlo', 'tns': [], ...`
    # 获取歌曲评论
    apis.track.GetTrackComments(29732235)    
    `{'isMusician': False, 'userId': -1, 'topComments': [], 'moreHot': True, 'hotComments': [{'user': {'locationInfo': None, 'liveIn ...`

详见 [Wiki](https://github.com/greats3an/pyncm/wiki) (WIP) 或自翻代码😶

# Credit
[decompilation of `libposion.so`](https://juejin.im/user/2383396938455821)

[Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi/blob/master/util/crypto.js)

*...自然还有网易*

# PR
本项目（截至 2020/08/24）已补全网易云所用加密算法，欢迎各位提交 PR ，补全API

### 衍生项目
[PyNCMd](https://github.com/greats3an/pyncmd)