Skip to content

Yomichan Setup Tutorial

What is Yomichan?

Yomichan is a browser extension that allows you to look up Japanese words with both the meaning and the reading on web pages with ease.

Getting Started

Yomichan is available for both Chromium and Firefox based browsers. You can find the respective versions below.
Chrome Web Store
Firefox Add-Ons
Once installed, it will open a new tab page, just close it for now so we don't confuse each other.

Acquiring Dictionaries

When you first install Yomichan, you need to load dictionaries into it in order to use it.
These files use the .zip extension and are not to be extracted by the user.

You can find my collection of Yomichan dictionaries below. This will have everything you need and (probably) don't need. πŸ™‚
β†’β†’β†’β†’Shoui's Yomichan Dictionary Collection←←←←  

I recommend you install the following dictionaries:
- Bilingual/[Bilingual] JMdict (English).zip
- Bilingual/[Bilingual] ζ–°ε’Œθ‹±.zip
- Kanji/[Kanji] KANJIDIC (English).zip
- Grammar/Dictionary of Japanese (NEW!)

Installing Dictionaries and basic usage

  1. Click on the yomichan-icon icon in the browser toolbar.
  2. Click on the cog icon to access the settings page.
  3. On the left sidebar, click on "Dictionaries" and then click on "Configure installed and enabled dictionaries…"
  4. Click the "Import" button on the bottom.
  5. Here's where you select the dictionaries to import. Please only import the following.

    • [Bilingual] JMdict (English).zip
    • [Bilingual] ζ–°ε’Œθ‹±.zip
    • [Kanji] KANJIDIC (English).zip
    • Grammar/Dictionary of Japanese (NEW!)
  6. Please wait for the dictionaries to import. This could take a while.

  7. Once complete, you can test Yomichan by holding down the Shift key and hovering over Japanese text. Here is a sample: ζ—₯本θͺž. It will display a pop up box displaying the definitions separated by dictionary.

Yomichan Demo

Click anywhere outside of the box or press the Esc key to dismiss. Click on an individual kanji in the headword to view kanji information (only functional with KANJIDIC installed).

  1. You can click the audio button to hear the word being pronounced by a native speaker.

In your browser extensions toolbar, if you click on the Yomichan logo, then on the search icon icon or the Alt+Ins keyboard shortcut to access Yomichan Search, this is where you can use Yomichan as a standalone Japanese to English dictionary.

Pop up box size can be edited with advanced settings enabled.
A full dark mode can be enabled in the settings too.

JMdict is the dictionary hosted on is not its own dictionary, rather it's a portal that accesses JMdict. This is the most common Japanese to English dictionary.

ζ–°ε’Œθ‹± (Shinwaei) is a Japanese-English dictionary intended for Japanese people. It has many example sentences which can prove to be very useful for Japanese learners. A variation of this with even more example sentences is called [Bilingual] η ”η©Άη€Ύγ€€ζ–°ε’Œθ‹±ε€§θΎžε…Έγ€€η¬¬οΌ•η‰ˆ.zip can also be found in my dictionaries collection.

KANJIDIC is a kanji dictionary, it allows you to view information of individual kanji.

Dictionary of Japanese Grammar, or ζ—₯本θͺžζ–‡ζ³•θΎžε…Έ(全集), is a dictionary that helps you look up grammar (duh!).

Allowing access to file URLs

Enabling this allows you to use Yomichan on local files such as .HTML files.

PDF Files

On Chrome, it is impossible to use Yomichan on PDF files.

- Right click the yomi icon
- Click "Manage Extensions"
- Enable "Allow access to file URLs"

- Enabled by default.

Bonus: Adding Forvo extra audio source

You may encounter missing audio with the default Yomichan audio sources, adding Forvo will help fill in the gaps.

Thanks to jamesnicholas for this wonderful add-on!

This requires you to have Anki (2.1 and newer) installed and open on your computer to work.

  1. Copy this code 580654285
  2. In Anki, in the menu at the top, click on Tools, then Add-ons.
  3. In the new window, click Get Add-ons... and paste the code 580654285 into the text box and click OK
  4. Restart Anki by closing it and opening it back up again.
  5. In the Yomichan settings page cog, click Audio on the left, and then click on Configure audio playback sources...
  6. Click Add and then select Custom from the drop down menu.
  7. Now where it says Custom audio source (?), select the type JSON from the drop down menu.
  8. In the URL text box, enter this http://localhost:8770/?expression={expression}&reading={reading}

Bonus: Android use with Kiwi Browser

Kiwi Browser is a Chromium browser that supports extensions, including Yomichan. You can download it below.
Google Play

You can access the Yomichan settings page by going in > Yomichan yomi icon > Settings.

Please see above for link to download the extension, link to the dictionaries collection and recommended starter dictionaries.
Importing a dictionary is a very processor intensive process and will take a long time depending on your phone. Please be patient.

Tap on a word to look it up. In the case that it is not working, you may need to turn off the modifier key.

Yomichan Android

Anki Setup

See AnimeCards Site

Offline audio server

This is entirely optional but people who may be limited by internet access may want to consider this as it allows Yomichan's audio functionality to work offline.

Yomichan Local Audio Server Addon version 7

Credits to Zetta (original author) η₯žε‡Ίι¬Όζ²‘ (added support for NHK 2016)

How to Install:

CAUTION: Backup your audio files if they're not in user_files. See next message for CHANGES.

  1. Download localaudio_v07.ankiaddon

  2. Double click it and install

  3. Download jpod101 audio files (The other jpod101 dump has some missing audio files, should use this one): HERE and extract it to addons21\955441350\user_files and replace the jpod_files with the extracted folder

  4. Download jpod101 alternate audio files (I tried to scrape everything I can, but I kept getting IP banned every time, so there may be some missing audio files, still have +100k audio files though, should be 99% of them): HERE and extract it to addons21\955441350\user_files and replace the jpod_alternate_files with the extracted folder

  5. Download NHK 2016 audio files: HERE (Thanks kezi ) and extract it to addons21\955441350\user_files and replace the nhk16_files with the extracted folder

  6. In Yomichan Settings, click Configure audio playback sources, Add Custom URL (JSON) and URL: http://localhost:5050/?sources=jpod,jpod_alternate,nhk16&term={term}&reading={reading} You can reorder sources to be sources=nhk16,jpod,jpod_alternate if you wantnhk16 to be the first one

user_files folder structure

β”œβ”€β”€ jpod_alternate_files
β”‚   └── γ‚ˆγ‚€ - θͺ­γ‚€.mp3
β”‚   └── ...
β”œβ”€β”€ jpod_files
β”‚   └── γ‚ˆγ‚€ - θͺ­γ‚€.mp3
β”‚   └── ...
└── nhk16_files
    β”œβ”€β”€ audio
    β”‚   └── 20170616125910.aac
    β”‚   └── ...
    └── entries.json

Once installed, scan a word like θͺ­γ‚€ and play audio. It will be slow for the first time because it needs to build the map and cache it as a file. (η·¨ι›†ζΈˆ)

Found this useful? Consider supporting me on Patreon!

Support me on Patreon