Skip to main content

japanese cli&web dictionary based on jmdict/kanjidic

Project description

GitHub Release PyPI Version Python Versions CI Android Build AGPLv3+ Sponsor

jiten - japanese android/cli/web dictionary based on jmdict/kanjidic

→ available online at https://jiten.obfusk.dev

Get it on Google Play Get it on F-Droid

NB: unfortunately, jiten is not (yet) available in the official F-Droid repository. You can use obfusk's f-droid repo instead: this contains the exact same APKs available via Google Play, as well as occasional beta versions (which are only installed when selected manually).

Screenshots

app screenshot cli screenshot

Features

  • Fine-grained search using regexes (regular expressions)
    • simple searches don't require knowledge of regexes
    • quick reference available in the web interface and android app
  • JMDict multilingual japanese dictionary
    • kanji, readings (romaji optional), meanings (english, dutch and/or german) & more
    • pitch accent (from Wadoku)
    • browse by frequency/jlpt
  • Kanji dictionary
    • readings (romaji optional), meanings (english), jmdict entries, radicals & more
    • search using SKIP codes
    • search by radical
    • browse by frequency/level/jlpt
  • Example sentences (from Tatoeba)
    • with english, dutch and/or german translation
    • some with audio
  • Stroke order
    • input a word or sentence and see how it's written

Interfaces

  • Android app
    • wraps the web interface (running locally on your device) in a webview
    • completely offline, no internet access required
    • easily share and open jiten.obfusk.dev links
  • Web interface
    • available online at https://jiten.obfusk.dev
    • light/dark mode
    • search history (stored locally)
    • tooltips to quickly see meanings and readings for kanji and words
    • use long press for tooltips on mobile
    • converts romaji to hiragana and between hiragana and katakana
    • can be run on your own computer
  • Command-line interface
  • WebView GUI
    • wraps the web interface (running locally on your computer)

CLI

JMDict

$ jiten -v jmdict --max 1 --word cat
$ jiten -v jmdict --max 1 --word kat --lang dut
$ jiten -v jmdict --max 1 --exact 誤魔化す

$ jiten -v jmdict +random         # random entry
$ jiten -v jmdict --prio +random  # random "priority" entry"
$ jiten -v jmdict -n 4-5 +random  # random JLPT N4 or N5 entry

Kanji

$ jiten -v kanji --max 1 --word cat
$ jiten -v kanji --max 1 --exact cat
$ jiten -v kanji --max 1 --word 

Web Interface

$ jiten -v serve

Help

$ jiten --help

WebView GUI for Linux/macOS/Windows

NB: requires pywebview (Debian/Ubuntu users can apt install python3-webview).

$ jiten-gui

Bugs & Feature Requests

Issue Tracker

Questions & Feedback

Discussions

jiten@obfusk.dev

Requirements

Python >= 3.5 + Flask + click.

To build the (not yet optional) SQLite PCRE C extension: a C compiler (e.g. gcc/clang) and the sqlite3 & pcre libraries & headers.

Basic build tools like make and patch.

Debian/Ubuntu

$ apt install python3-dev build-essential libsqlite3-dev libpcre3-dev
$ apt install python3-flask   # optional: Flask & click w/o pip

Installing

Using pip

$ pip install jiten

From git

NB: this installs the latest development version, not the latest release.

$ git clone https://github.com/obfusk/jiten.git
$ cd jiten
$ make
$ pip install -e .

NB: you may need to add e.g. ~/.local/bin to your $PATH in order to run jiten.

To update to the latest development version:

$ cd jiten
$ git pull --rebase
$ make

Miscellaneous

Web Interface on Android

You can also run the web interface locally (& offline) on your android phone. First, install termux, then run:

$ apt install clang python
$ pip install jiten

You can then run the web interface with:

$ jiten serve

and open http://localhost:5000 in your browser.

The web interface will keep running until you close termux or reboot.

Generating the DB

$ jiten setup

Forcing HTTPS

$ export JITEN_HTTPS=force

Forcing Domain Name

$ export JITEN_DOMAIN=jiten.obfusk.dev

License

Code

© Felix C. Stegerman

AGPLv3+

JMDict & KanjiDic

© James William BREEN and The Electronic Dictionary Research and Development Group

CC-BY-SA

Wadoku (pitch)

© Ulrich Apel & Wadoku.de contributors

Non-commercial

Tatoeba (sentences & audio)

© Tatoeba contributors

CC-BY

Audio by huizi99, Mizu & yomi (CC BY-NC 4.0).

KanjiVG (radicals)

© Ulrich Apel

CC-BY-SA

Stroke Order Font

© Ulrich Apel, the AAAA project and the Wadoku project

BSD-3-Clause

JLPT Data

© Jonathan Waller

CC-BY

Kana Tables

© Wikipedia contributors

CC-BY-SA CC-BY-SA

Material Design Icons

© Google

CC-BY

Project details


Download files

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

Source Distribution

jiten-0.4.0.tar.gz (65.1 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page