Skip to content

a tiny and smart cli player of douban.fm based on Node.js

License

Notifications You must be signed in to change notification settings

JacksonTian/douban.fm

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

douban.fm

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

screenshot

如何安装

从 NPM 中安装稳定的版本,使用 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 目录

$ douban.fm config
$ prompt: Douban Email: 输入豆瓣账户邮箱
$ prompt: Douban Password: 输入豆瓣账户密码

如果你忘了快捷键设置,可以打开帮助菜单:

$ douban.fm help

菜单快捷键列表

在相应的命令行菜单中,按下以下快捷键,可以在收听豆瓣电台的过程中,标注自己喜欢的红心歌曲, 跳转到专辑的介绍页面,或者分享这首歌曲到你的新浪微博。

[return]      - >     播放另一个频道,或者重新播放当前频道 (PLAY)
[backspace]   - >     停止播放当前歌曲或频道 (DELETE)
[n]           - >     本频道列表的下一首歌曲 (NEXT)
[l]           - >     添加到红心列表或者删除红心 (LOVE)
[s]           - >     分享当前歌曲到新浪微博 (SHARE)
[r]           - >     开启或关闭歌词,默认关闭歌词显示 (LRC)
[g]           - >     跳转到当前播放歌曲的专辑页面 (GOTO)
[q]           - >     退出豆瓣电台 (QUIT)

Pro 用户

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

歌词显示

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

范例代码

这样在你的项目中引用 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

Changelog

详见 History.md

MIT license

Copyright (c) 2013 turing <i@guoyu.me>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


docor built upon love by docor v0.1.2

About

a tiny and smart cli player of douban.fm based on Node.js

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%