zhuaxia: A Python repository from lwj0012

####Table of contents (toc is generated by ghtoc)

针对xiami近期更改链接以及API的修复
- 已完成修复
- Todos
Introduction/简介
Dependencies/依赖
Features/功能
Installation/安装
Usage/使用
- 海外IP使用xiami代理支持
Screenshots
Change logs
Contributions

Xiami Fix Note

针对[虾]近期更改链接以及API的修复

因为[虾]变更了它的api链接以及处理方式，原zhuaxia(version 2.1.x)的[虾]下载部分无法正常工作。在v2.2.0版本做了相应的修复。目前已修复的[虾]的功能有：

Fixed

[虾]歌曲下载
[虾]专辑下载，包括封面
[虾]下载专辑时保存介绍(v2.3.0+)
[虾]精选集下载
[虾]歌手热门下载 (max Top20)
[虾]用户收藏下载 (v2.3.0+)

Todos

[虾]针对新的用户收藏的歌曲解析方法，http的请求比以前多了很多次，频繁请求会被虾ban 10分钟，加入实验性-p选项用proxy pool来解析和下载。此选项也用于[易]

xiami还屏蔽海外ip的访问，这给修复和测试又带来难度。我会尽快解决剩下的问题。到目前为止，网易部分下载还正常。(从虾米屏蔽海外ip我就用网易了)

Introduction

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

Usage

配置文件，第一次运行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