Yomichan Options

Profiles

Profiles allow you to create multiple configurations and quickly switch between them or use them in different contexts.

Active profile

Modifying profile

Profile name

Usage conditions

Usage conditions can be assigned such that certain profiles are automatically used in different contexts. For example, when Popup Content Scanning is enabled, different profiles can be used depending on the level of the popup.

Conditions are organized into groups which represent how the conditions are checked. If all of the conditions in any group are met, then the profile will automatically be used for that context. If no conditions are specified, the profile will only be used if it is selected as the Active profile.

General Options

Enable content scanning

Enable native popups when copying Japanese text

Show usage guide on startup

Compact tags

Compact glossaries

Show advanced options

Change popup size relative to page zoom level

Change popup size relative to page viewport

Show downstep notation for pitch accents

Show position notation for pitch accents

Show graph for pitch accents

Show iframe popups in root frame

Use a native popup window when scanning text on web pages

Use secure popup frame URL

Use shadow DOM container for popup

Show debug information

Result grouping

Popup display mode

Popup size multiplier

Maximum displayed results

Popup position for horizontal text

Popup position for vertical text

Popup width (in pixels)

Popup height (in pixels)

Horizontal popup offset (in pixels)

Vertical popup offset (in pixels)

Horizontal popup offset for vertical text (in pixels)

Vertical popup offset for vertical text (in pixels)

Popup theme

Popup shadow theme

Custom popup CSS

Custom popup outer CSS

Audio Options

Enable audio playback in search results

Play audio automatically

Audio playback volume (percent)

Custom audio source (URL)

Audio playback sources

Scanning Options

Middle mouse button scans

Touch input enabled

Select matched text

Search alphanumeric text

Automatically hide results

Layout-aware scan

Deep DOM scan

Scan delay (in milliseconds)

Scan length (in characters)

Scan modifier key

Translation Options

The following options can be used during the translation process to provide alternate versions of the input text to search for. This can be helpful when the input text doesn't exactly match the term or expression found in the database.

The conversion options below are listed in the order that the conversions are applied to the input text. Conversions commonly have three possible values:

Disabled
This conversion will never be applied to the input text.
Enabled
This conversion will always be applied to the input text.
Use both variants
The translator will check the database for two variations: the raw input text and the converted input text. When multiple options use variants, the translator will search for combinations of the converted text.

Convert half width characters to full width (ﾖﾐﾁｬﾝ → ヨミチャン)

Convert numeric characters to full width (1234 → １２３４)

Convert alphabetic characters to hiragana (yomichan → よみちゃん)

Convert hiragana to katakana (よみちゃん → ヨミチャン)

Convert katakana to hiragana (ヨミチャン → よみちゃん)

Collapse emphatic character sequences (すっっごーーい → すっごーい / すごい)

Text Parsing Options

Yomichan can attempt to parse entire sentences or longer text blocks on the search page, adding furigana above words and a small space between words.

Two types of parsers are supported. The first one, enabled by default, works using the built-in scanning functionality by automatically advancing in the sentence after a matching word.

The second type is an external program called MeCab that uses its own dictionaries and a special parsing algorithm. To get it working, you must first install it and a native messaging component that acts as a bridge between the program and Yomichan.

Enable text parsing using installed dictionaries

Enable text parsing using MeCab

Enable small spaces between parsed words

Reading mode

Dictionaries

Yomichan can import and use a variety of dictionary formats. Unneeded dictionaries can be disabled.

Main dictionary for merged mode

Select a dictionary to import for use below. Please visit the Yomichan homepage to download free dictionaries for use with this extension and to learn about importing proprietary EPWING dictionaries.

Dictionary Options

Enable prefix wildcard searches

This option only applies to newly imported dictionaries. Enabling this option will also cause dictionary data to take up slightly more storage space.

Storage

Web browsers may sometimes clear stored data if the device is running low on storage space. This can result in the stored dictionary data being deleted unexpectedly, causing Yomichan to stop working for no apparent reason. In order to prevent this, persistent storage must be enable by clicking the "Persistent Storage" button below.

Yomichan is using approximately of .

Yomichan is permitted unlimited storage.

Could not detect how much storage Yomichan is using.

On Firefox and Firefox for Android, the storage information feature may be hidden behind a browser flag. If you would like to enable this flag, open about:config and search for the dom.storageManager.enabled option. If this option has a value of false, toggling it to true may allow storage information to be calculated.

If you are using Firefox for Android, you will have to make sure you have enough free space on your device to install dictionaries.

It may not be possible to enable Persistent Storage on Firefox for Android.

It may not be possible to enable Persistent Storage on Chrome-based browsers. However, the Yomichan extension has permission for unlimited storage which should prevent Chrome from deleting data.^[1]

Anki Options

Yomichan supports automatic flashcard creation for Anki, a free application designed to help you remember. This feature requires installation of the AnkiConnect plugin.

Enable Anki integration

Notice for Mac OS X users: If Yomichan has issues connecting to AnkiConnect, you may have to tweak some system settings. See this link for more details.

Card tags (comma or space separated)

Sentence detection extent (in characters)

Interface server (Default: http://127.0.0.1:8765)

Duplicate scope

Screenshot format

Screenshot quality (JPEG only)

Specify the information you would like included in your flashcards in the field editor below. As Anki requires the first field in the model to be unique, it is recommended that you set it to {expression} for term flashcards and {character} for Kanji flashcards. You can use multiple markers per field by typing them in directly. See Flashcard Configuration on the Yomichan homepage for descriptions of the available markers.

Terms
Kanji

Deck

Model

Field	Value

Deck

Model

Field	Value

Fields are formatted using the Handlebars.js template rendering engine. Advanced users can modify these templates for ultimate control of what information gets included in their Anki cards. If you encounter problems with your changes, you can always reset to the default template settings.

Templates can be tested using the inputs below.

Preview text

Test field

Keyboard Shortcuts

Yomichan includes keyboard shortcuts for common actions which can be adjusted using the web browser's settings. Instructions on how to access this settings page are listed below for a few browsers.

Chrome

Open the settings page (chrome://settings/)
Click the "Extensions" link in the left sidebar (chrome://extensions/)
Open the left side panel using the hamburger (≡) menu button, then click "Keyboard shortcuts"

Firefox

Open the extensions page (about:addons)
Click the button on the right with the gear icon, then click "Manage Extension Shortcuts"

Backup

Yomichan can import and export settings files which can be used to restore settings, share settings across devices, or help to debug problems. These files will only contain settings and will not contain dictionaries. Dictionaries must be imported separately.

Support Development

Yomichan is provided to you completely free of charge. Unlike numerous other "free" services, you are not shown ads, pestered with "offers", or have your browser usage information analyzed and sold to third parties.

If you find Yomichan useful, please consider making a small donation as a way to show your appreciation for the countless hours that I have devoted to this extension.

• Search • Homepage • Legal