voc-cli

voc

Download and play English vocabulary's audio via command line.

The audio will be downloaded to directory ~/vocabulary by default, and played by audio player command line.

Dictionary:

• Webster
• Collins
• Yahoo
• The Free Dictionary

Text-To-Speech:

• Google
• iSpeech
• Voice RSS

Change Log

Please see CHANGELOG.

Installation

$ npm install -g voc-cli

or

$ git clone https://github.com/zlargon/voc.git
$ cd voc/
$ npm link

Usage

Usage: voc <words...>

Options:

  -h, --help         output usage information
  -V, --version      output the version number
  -w, --webster      force download audio from webster
  -y, --yahoo        force download audio from yahoo
  -f, --freedic      force download audio from freedictionary
  -c, --collins      force download audio from collins
  -g, --google       force download audio from google
  -i, --ispeech      force download audio from ispeech
  -v, --voicerss     force download audio from voicerss
  -a, --audio <cli>  the command line to play .mp3 audio.
  -d, --dir <path>   set the download directory. set defaults to '~/vocabulary'
  -l, --list         list all the configuration
  -r, --reset        reset configuration to default

Example

$ voc hello              # download hello.mp3
$ voc hello world        # download both hello.mp3, world.mp3
$ voc hello_world -g     # download hello_world.mp3 from google service
$ voc "Hello World" -i   # download hello_world.mp3 from ispeech service

Audio Player Command Line

• MAC OSX : afplay

  https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/afplay.1.html

  • afplay is build-in command line on macOS; you don't have to do anything for it.

• UNIX : mpg123

  http://www.mpg123.de/

$ sudo apt-get install mpg123

• Windows : dlc

  http://dlcplayer.jimdo.com/

  • dlc is build-in now, so you don't have to install command line by self.
  • You still can download dlcplayer from here if you want.

Configuration

$ voc -d ~/my_vocabulary   # set download directory to '~/my_vocabulary'
$ voc -a mplayer           # set audio command line to 'mplayer'
$ voc -a "dlc -p"          # set audio command line to 'dlc' with argument '-p'

License

MIT

Changelog

1.8.5 (Dec 31, 2016)

• using HTTPS for online dictionary webster, yahoo, and collins.
• build in dlc command line for windows platform, so that users don't have to install command line by themselves.