You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
chee db98a8b524 add note about jag in README 4 years ago
bin add jag script, mv cli to bin directory 4 years ago
.gitignore add a nodey gitignorial 4 years ago add note about jag in README 4 years ago
index.js add an initial implementation 4 years ago
package-lock.json 1.1.0 4 years ago
package.json add jag script, mv cli to bin directory 4 years ago


get the japanese audio urls for a word from


this isn't on, so if you want to install it you'll need to do this:

$ npm i -g

librarial interface

const ja = require('ja')

  term: '犬',
  reading: 'いぬ'
}).then(results => {
  // =>

you can pass raw: true to get a newline separated list as a string, instead of an array

command line interface

# everything
$ ja dog

# by reading
$ ja 犬 -r いぬ

# by filetype
$ ja dog | grep [.]ogg$

# as json (for piping to jq/jshon)
$ ja inu -r いぬ -j

# when there are no results
$ ja pleased to meet you
$ echo $?


in the bin directory there is also a script called jag, which is macos only and will only really work if you have the japanese speech to text installed on your macintosh and set up as your default speech to text.

everyone should do that and enable notification reading so she says アレルト! ロウ バテリ! to you. it warms.

anyway it will fetch the first word it finds for your term and optional reading as an ogg and save it, then open finder with that new file highlighted. then you can drag it into anki or burn it to cd or put it on your zip drive.

if it can't find a file for you on the interconnected network of computers, it will create one with say(1).

thanks kyoko

interface is like:

$ jag $term $reading

# like

$ jag あれ

# now you'll have a file called あれ.ogg

# you can force it to use say by setting the env variable SAY to
# something truthy

$ SAY=下さい jag 犬

it's not installed when you install this repo with npm, you'd have to download it yourself


  • more sources