zhuaxia

zhuaxia 可以从 xiami.com 和 music.163.com 下载 MP3 文件和音频。

zhuaxia 是一个基于命令行的虾米音乐 ( www.xiami.com 以下简称[虾])和网易云音乐( music.163.com 以下简称[易]) 多线程批量下载工具

zhuaxia 的开发调试环境:

• python 2.7.6

依赖

• requests module

• mutagen module

• beautifulsoup4 module

特性

• 自动识别解析URL. 目前支持：

  • [虾] 歌曲，专辑，精选集，用户收藏[todo], 歌手热门

  • [易] 歌曲，专辑，歌单，歌手热门

• 下载歌手热门歌曲:数量可配置(<=0 无限制 [虾]只下载第一页) ，默认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的问题

• 中英文命令行界面. 配置项 lang=en|cn 默认中文(cn)

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

Proxy setting

海外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的代理就好。

Screenshots

• downloading (gif animation)

• parse input file

• parse url