Skip to main content

Japanese/English command-line dictionary

Project description

myougiden is a command-line, Japanese/English English/Japanese dictionary. It’s based on EDICT (JMdict), the venerable collaborative project. It’s currently functional, if a bit (a lot) rough in the edges.

  • Fully Unicode-aware.
  • Regular expression support.
  • Partial, full, whole-word, and start-of-field queries.
  • Intelligently figure out what kind of query is intended.
  • Optional rōmaji input and output.
  • Option for tab-separated output, easily manipulable with Unix tools. (beta)
  • Full color output, including partial match highlighting. No seriously, this thing has a lot of color. I mean we’re talking Takashi Murakami material right here.
  • Displays JMdict restricted readings and senses.
  • Auto-pager, auto-color, auto-nice, auto-greppable output, and other small niceties.

myougiden saves EDICT data in sqlite3 format. This costs some disk space (currently about 53MiB), but with indexes, it seems to be reasonably fast.

Sample usage

Some example queries:

$ myougiden -h             # long help
$ myougiden tea ceremony   # guess what kind of query to run
$ myougiden 茶             # ibid
$ myougiden -p 茶          # include partial matches
$ myougiden -p -f 茶       # ...but limit to frequent words
$ myougiden -p -f -t 茶    # ...and tab-separated, single-line output
$ myougiden -x '茶.'       # regexp search
$ myougiden sakura         # if no match is found, treat as rōmaji
$ myougiden -r kanji       # forces rōmaji
$ myougiden -a uK          # consult documentation for EDICT-style abbreviations


myougiden needs Python 3 and pip. In Debian/Ubuntu, you can install them like this:

$ sudo apt-get install python3 python3-pip

Then install myougiden using pip:

$ sudo pip-3.2 install myougiden # use your version

Then, you need to compile the dictionary database at least once:

$ sudo updatedb-myougiden -f
# This command downloads and compile JMdict.
# It's a bit heavy, go have some coffee...

That’s it, have fun!

EDICT/JMdict is a frequently updated dictionary. If you’d like to keep up with new entries and corrections, consider adding updatedb-myougiden -f to cron (for example, in /etc/cron.weekly/myougiden ).


Just upgrade the pip package:

$ sudo pip install --upgrade myougiden

Installing in Debian squeeze

As of this writing, Debian squeeze has no python3-pip. You can install it manually like this:

$ sudo apt-get install python3.1 curl
$ curl -O
$ sudo python3.1
$ curl -O
$ sudo python3.1

Now you have a pip-3.1 to install any python3 pip packages!

Python ≤ 3.1 needs the package argparse

$ sudo pip-3.1 install argparse

Finally, install as above:

$ sudo pip-3.1 install myougiden
$ sudo updatedb-myougiden -f

Installing from sources

Required software:
  • Python 3
  • rsync (recommended)
Required python packages (available on pip):
  • romkan
  • termcolor
  • argparse (only for Python ≤ 3.1)
  • psutil (recommended; only for Python ≤ 3.2)

To install from github:

$ git clone git://
$ cd myougiden
$ sudo python3 install

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for myougiden, version 0.8.8
Filename, size File type Python version Upload date Hashes
Filename, size myougiden-0.8.8.tar.gz (38.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page