如何安装
从 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
- 最新版本的 x86 Node.js for Windows,注意不要安装 x64 版本。
- 安装 Visual C++ 2010 Express。
- 安装 Python 2.7, installed in the default location of
C:\Python27
。
如果遇到无法解决的问题,请到 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 tool 或 libav 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)
});
致谢
豆瓣电台命令行版作为一款开源命令行播放器,有你们的参与才能日趋完善:- 感谢 ZoomQuiet 不遗余力地试用和建议。
- 感谢 zhuangya 改良了配置账户的操作 #32
- 感谢 anson0370 解决了退出后光标消失的 bug #53
- 感谢 youxiachai 增加了对 windows 的分享支持 #54
- 感谢 buhe 增加显示歌词的功能 #58
- 感谢 JacksonTian 改善了
player
模块 #2
单元测试 (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