####Table of contents (toc is generated by ghtoc)
- 针对xiami近期更改链接以及API的修复
- Introduction/简介
- Dependencies/依赖
- Features/功能
- Installation/安装
- Usage/使用
- Screenshots
- Change logs
- Contributions
针对[虾]近期更改链接以及API的修复
因为[虾]变更了它的api链接以及处理方式，原zhuaxia(version 2.1.x)的[虾]下载部分无法正常工作。在v2.2.0版本做了相应的修复。目前已修复的[虾]的功能有：
- [虾]歌曲下载
- [虾]专辑下载，包括封面
- [虾]下载专辑时保存介绍(
v2.3.0+) - [虾]精选集下载
- [虾]歌手热门下载 (max Top20)
- [虾]用户收藏下载 (
v2.3.0+)
- [虾]针对新的用户收藏的歌曲解析方法，http的请求比以前多了很多次，频繁请求会被虾ban 10分钟，加入实验性-p选项用proxy pool来解析和下载。此选项也用于[易]
xiami还屏蔽海外ip的访问，这给修复和测试又带来难度。我会尽快解决剩下的问题。到目前为止，网易部分下载还正常。(从虾米屏蔽海外ip我就用网易了)
zhuaxia(抓虾) (MIT Licensed) is a little tool to batch download music resources in multiple threads from www.xiami.com and music.163.com. Due to the localization of site, the output/log messages contain Chinese. Moreover, this readme was written in Chinese as well. However all comments in codes are in English.
zhuaxia 是一个基于命令行的虾米音乐 ( www.xiami.com 以下简称[虾])和网易云音乐( music.163.com 以下简称[易]) 多线程批量下载工具
zhuaxia was written and tested with:
- python 2.7.6
##Dependencies
- requests module
- mutagen module
- beautifulsoup4 module
##Features
- 自动识别解析URL. 目前支持：
- [虾] 歌曲，专辑，精选集，用户收藏[todo], 歌手热门
- [易] 歌曲，专辑，歌单，歌手热门
- 下载歌手热门歌曲:数量可配置([虾]max:20) ，默认Top10。 配置项:
download.artist.topsong，需要艺人页面链接 - 支持包含音乐资源URL的文件作为输入进行批量下载. URL可以是[虾]和[易]混合, 可以不同音乐类型混合 (
-f参数) - 当以文件作为输入批量下载时, 多线程(可配置线程池)解析URL
- 多线程(可配置线程池)下载歌曲
- [虾]支持以VIP账户登录下载高音质(320kbps) mp3, 并不消耗VIP的下载额度 (
-H选项) - [易]支持下载高音质(320kbps) mp3 (
-H选项) - 进度显示 (色彩高亮，终端宽度改变自动适应，总进度，下载线程进度...)
- mp3文件重命名, 更新mp3 meta信息，自动下载专辑封面, 专辑文本介绍(仅[虾])...等等
- [虾]配置项
xiami.proxy.http=ip:port来设置国内的代理服务进行xiami连接的解析。详见："Usage -> 海外IP下载xiami资源" 一节 - 加入实验性
-p选项，尝试解决频繁请求被服务器ban的问题
##Installation
Archlinux 用户, zhuaxia可以从AUR中获取
稳定版本(master branch)：
稳定版本：
yaourt -S zhuaxia
最新git版本(bleeding branch):
yaourt -S zhuaxia-git
其他用户:
sudo python setup.py install
-
配置文件， 第一次运行
zx后， 在$HOME/.zhuaxia/会有配置文件zhuaxia.conf配置参数有中文说明 -
使用：
zhuaxia (抓虾) -- 抓取[虾米音乐]和[网易云音乐]的 mp3 音乐 [CONFIG FILE:] $HOME/.zhuaxia/zhuaxia.conf [OPTIONS] -H : 首选HQ质量(320kbps), > 虾米音乐 < - 配置文件中需给出正确登录信箱和密码, 登录用户需拥有VIP身份 - 用户需在xiami vip设置页面设置默认高音质 - 此选项对不满足上两项情况无效，仍下载128kbps资源 > 网易音乐 < -无需特殊要求,直接下载高音质资源 -p : (实验性选项)使用代理池下载 在下载/解析量大的情况下，目标服务器会对禁止频繁的请求，所以zhuaxia可以自动获取 代理来解析和下载资源。因为获取的代理速度/可靠性不一，下载可能会缓慢或不稳定。 -h ：显示帮助 -f ：从文件下载 -v ：显示版本信息 [USAGE] zx [OPTION] <URL> : 下载指定URL资源, 抓虾自动识别链接, 支持 - [虾] 歌曲，专辑，精选集，用户收藏,艺人TopN - [易] 歌曲，专辑，歌单，艺人TopN 例子： zx "http://www.xiami.com/space/lib-song/u/25531126" zx "http://music.163.com/song?id=27552647" zx [OPTION] -f <file> : 多个URL在一个文件中，每个URL一行。 URLs可以是混合[虾]和[易]的不同类型音乐资源。例子： $ cat /tmp/foo.txt http://music.163.com/artist?id=5345 http://www.xiami.com/song/1772130322 http://music.163.com/album?id=2635059 http://www.xiami.com/album/32449 $ zx -f /tmp/foo.txt
海外IP下载xiami资源
xiami.com屏蔽了海外ip的http请求。在配置文件中添加（如果不存在的话）xiami.proxy.http=ip:port 可以让zhuaxia通过代理来解析xiami资源。
例如：
xiami.proxy.http=127.0.0.1:8080
这里ip:port构成的http代理是国内的代理服务器。 如果你的机器已经是国内的ip，请注释或删除这个选项。获取国内代理的简单方法：到http://proxy-list.org/ 搜索China的代理就好。
-
downloading (gif animation)
-
parse input file
-
parse url
感谢 lyj 提供一个限时VIP测试帐号，这给HQ资源下载部分的完成很大帮助。