Total Pageviews

Monday 17 March 2014

简洁优雅的豆瓣电台命令行版,基于 Node.js

如何安装

从 NPM 中安装稳定的版本:
$ [sudo] npm install douban.fm -g
更推荐使用 cnpm 镜像源加速安装
$ [sudo] npm install douban.fm -g \
         --disturl=http://dist.u.qiniudn.com \
         --registry=http://r.cnpmjs.org
从 Git 仓库中安装最新的开发版本:
$ [sudo] npm install git://github.com/turingou/douban.fm.git -g \
         --disturl=http://dist.u.qiniudn.com \
         --registry=http://r.cnpmjs.org

模块依赖

由于需要使用到 speaker 等模块,安装时需要编译文件,对安装环境有一定要求。 推荐在 Mac OSX 下使用,在安装之前或安装遇到问题时,确保以下依赖状态正常:

linux & mac

  • 安装了 python 2.x 并配置好环境变量
  • 安装了 node-gyp 编译工具
  • 安装了 xcode,或已安装 xcodebuild 工具和 command line tools 工具集
  • 曾经安装过 xcode 并已同意用户协议,确保更新 xcode 版本后同意过用户协议
  • 非 Mac OSX 用户需要检查 node-speaker 模块的外部依赖情况,详见 node-speaker 文档,按照你使用的操作系统安装相应外部依赖
  • 确保权限一致。如果没有使用 sudo 则尝试使用 sudo 安装
  • 各种 linux 发行版外部依赖问题,先确认是否安装了 libasound2,如果没有,尝试 sudo apt-get install libasound2-dev,fedora 下 yum install alsa-lib-devel

windows

安装的时候都用默认的下一步吧,保险起见再重启一下电脑,现在,你的windows系统就可以安装带有c++ addons的Node.js 模块了。
如果遇到无法解决的问题,请到 issue 板块先检索是否有人遇到相同的错误,或者直接发帖求助。

使用方法

开启你的命令行豆瓣电台:
$ douban.fm
收听私人频道需要设置账户信息。账户信息、配置文件将会保存在 ~/.douban.fm.profile.json( >= 0.1.2 版本后) 歌曲将会默认保存在 ~/douban.fm 目录下,当然你也可以通过配置自定义歌曲保存的目录。
配置账户信息的方法:
$ douban.fm config
$ prompt: Douban Email: 输入豆瓣账户邮箱
$ prompt: Douban Password: 输入豆瓣账户密码
配置歌曲下载目录的方法,假设我们想要保存在 Music 目录下的 douban.fm 目录
$ cd ~/Music
$ mkdir douban.fm && cd douban.fm
$ douban.fm home
当然,你也可以不用 cd 到那个目录以保存,直接填写 home 参数即可:
$ douban.fm home /Users/YourName/Music/douban.fm

菜单快捷键列表

在相应的命令行菜单中,按下以下快捷键,可以在收听豆瓣电台的过程中,标注自己喜欢的红心歌曲, 跳转到专辑的介绍页面,或者分享这首歌曲到你的新浪微博。
[return]      - >     播放另一个频道,或者重新播放当前频道 (PLAY)
[backspace]   - >     停止播放当前歌曲或频道 (DELETE)
[n]           - >     本频道列表的下一首歌曲 (NEXT)
[l]           - >     添加到红心列表或者删除红心 (LOVE)
[s]           - >     分享当前歌曲到新浪微博 (SHARE)
[r]           - >     开启或关闭歌词,默认关闭歌词显示 (LRC)
[g]           - >     跳转到当前播放歌曲的专辑页面 (GOTO)
[q]           - >     退出豆瓣电台 (QUIT)
如果你忘了快捷键设置,可以打开帮助菜单:
$ douban.fm help

支持 Pro 用户高码率音乐

支持 pro 用户收听高码率 mp3,pro 用户默认会先寻找 192kbps 的歌曲播放,非 pro 用户不受影响。 在同样的网络情况下,收听高码率的电台可能意味着加载资源的速度更慢,但是目前豆瓣电台命令行版还不支持随时自定义码率。

歌词显示

豆瓣电台命令行版 >= 0.1.2 版本支持显示歌词功能,这个功能尚在调试中,歌词可能无法与音乐精确匹配,歌词显示默认关闭,可以使用快捷键 R 开启,开启后在下一首歌曲播放时将会加载歌词。

本地电台

豆瓣电台命令行版 >= 0.1.2 版本支持本地电台功能,这意味着在离线情况下,或者网络不佳,通信失败的情况下,豆瓣电台命令行版会自动切换到本地电台进行播放,方便您在旅行时使用豆瓣电台。

ID3 信息补全

豆瓣电台命令行版 >= 0.1.2 版本支持本地 ID3 信息补全,方便用户同步到 iTunes 等播放软件,使用 douban.fm id3 同步离线曲库可用歌曲的 ID3 信息。目前暂不支持为歌曲添加封面。此功能需要外部依赖 ffmpeg 使用前确保已经安装 ffmpeg command-line toollibav fork

范例代码

这样在你的项目中引用 douban.fm 的 SDK。 这些范例可能和最终的结果不一致,在使用前,最好参考 ./libs/sdk.js 这个文件,以防出现意想不到的错误
var Fm = require('douban.fm'),
    fm = new Fm;

// 豆瓣账户模拟登录
fm.sdk.auth({
    email: 'xxx',
    password: 'xxx'
},function(err, result){
    // do sth with result token.
});

// 获取频道
fm.sdk.channels(function(err, channels){
    console.log(channels)
});

// 获取歌曲列表
// 详见: http://zonyitoo.github.io/blog/2013/01/22/doubanfmbo-fang-qi-kai-fa-shou-ji/
fm.sdk.fetch({
    id: channel.id,
    type: 'n'
},user,function(err, songs){
    console.log(songs)
});

// 搜索歌词
fm.sdk.lrc(title, artist, function(err, lrc){
    console.log(lrc)
});

致谢

豆瓣电台命令行版作为一款开源命令行播放器,有你们的参与才能日趋完善:

单元测试 (Mocha)

$ git clone https://github.com/turingou/douban.fm.git
$ cd douban.fm
$ npm install --disturl=http://dist.u.qiniudn.com --registry=http://r.cnpmjs.org
$ npm test 
 
from https://github.com/turingou/douban.fm