Yomichan Settings
Questions, comments, and other feedback is welcome and can be shared on Github.
Dictionaries (# installed, # enabled)
Web browsers will sometimes clear stored data if the device is running low on storage space. This can result in the imported dictionaries being deleted unexpectedly, causing Yomichan to stop functioning. Enabling persistent storage tells the browser that the data should not be deleted in those circumstances.
On Firefox and Firefox for Android, the storage information feature may be hidden behind a browser flag. To enable this flag, open about:config and search for dom.storageManager.enabled. Setting its value to true should allow storage information to be calculated.
It may not be possible to enable Persistent Storage on Firefox for Android.
Chromium-based browsers should not need to enable this setting since the Yomichan extension has
the unlimitedStorage permission, which should prevent data deletion.[1]
- No grouping - Every definition will be listed as a separate entry.
- Group term-reading pairs - Definitions for the same term with the same reading will be grouped together.
-
Group related terms - Related terms that share the same definitions will be grouped together.
The Primary dictionary option should be assigned to a dictionary which contains related term information, and configuring the Secondary dictionaries will allow definitions for the related terms to be included from other dictionaries.
Not all dictionaries are able to be selected as the Primary dictionary.
A keyboard modifier key can be used to activate text scanning when the cursor is moved. Alternatively, the No key option can be used to scan text whenever the cursor is moved, without requiring any key to be held.
More advanced scanning input customization can be set up by enabling the Advanced option and clicking Configure advanced scanning inputs.
To enable text scanning when using devices with a touch screen, either the Touch inputs or the Pointer inputs option must be enabled. Touch inputs supports generic touches on a touch screen device, but do not distinguish between touch and pen inputs. Pointer inputs supports supports the detection pen devices, but may not work on all devices. If both options are enabled, Pointer inputs takes precedence.
The Pointer inputs option is only visible when the Advanced option is enabled.
By default, scanning text inside of an embeded <iframe> element will open
a new popup inside of that frame, which can sometimes be limiting due to the frame's size.
When this option is enabled, the popup will be created in the root of the page, if possible.
Note that when this option is enabled, there is a possibility that the extension can interfere with the underlying webpage, since it must send messages to the webpage in order to determine the correct position of the popup. This typically does not cause issues, but if anything unexpected happens, this option could be the cause.
The Default mode will position the popup relative to the scanned text. The Full Width mode will anchor the popup to the top or bottom of the screen and take up the full width of the screen, which can be useful on devices with touch screens.
Auto-scaling will scale the popup automatically based on the browser's zoom levels in order to keep the popup at a constant physical size, regardless of the zoom level. Zoom level uses the zoom level that is typically used on desktop browsers, and Viewport uses the zoom level that is typically used on mobile browsers.
Instead of showing definitions in a popup embedded into the webpage, a native browser window containing the popup content will be opened instead. This window will be shared across all tabs.
When Japanese text is copied to the clipboard, a browser window popup searching for the clipboard text will be opened. This can be useful for using Yomichan to scan text from external applications.
This feature requires Yomichan to have clipboard reading permissions, and when this option is enabled, the clipboard will be frequently polled for new text.
Alternatively, this feature can be enabled only on the search page, and clipboard contents polling will only be performed when the search page is already open.
Yomichan can attempt to parse entire sentences or longer text blocks on the search page, adding furigana above words and optional space between words.
Yomichan can scan and parse sentences which can be used as contextual information for Anki cards.
The following options are used during the translation process to create 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. Most of the conversions 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.
Yomichan supports automatic flashcard creation for Anki, a free application designed to assist in remembering information. This feature requires installation of the AnkiConnect plugin.
Attempting to connect to Anki can sometimes return an error message which includes "Invalid response", which may indicate that the value of the AnkiConnect server address option is incorrect. Resetting it to the default value may fix issues that are occurring.
The default address for a server on the same device is http://127.0.0.1:8765. If Anki is running and AnkiConnect is installed, clicking this URL should open a page showing the current version of AnkiConnect.
A card is considered a duplicate if the value of the first field matches that of any other card. By default, this check will include cards across all decks in a collection, but this constraint can be relaxed by using either the Deck or Deck root option.
The Deck option will only check for duplicates in the target deck. The Deck root option will additionally check for duplicates in all child decks of the root deck. This allows adding cards that are unique for decks including a subdeck structure. For decks which don't have any parent-child hierarchy, both options function the same.
Yomichan includes keyboard shortcuts for some common actions that can be configured using the web browser's settings. To configure these shortcuts:
- Open chrome://extensions/shortcuts in a new tab.
- Find the Yomichan section and configure the shortcuts.
- Open edge://extensions/shortcuts in a new tab.
- Find the Yomichan section and configure the shortcuts.
- Open the extensions page (about:addons)
- Click the button on the right with the gear icon, then click Manage Extension Shortcuts.
- Find the Yomichan section and configure the shortcuts.
On supported browsers,
a popup's iframe element will be embeded inside of a container with a closed shadow DOM.
This container prevents scripts running on the underlying web page from being able to discover the iframe,
which helps avoid situations where the web page might try to modify or use the Yomichan popup for an unintended purpose.
When this option is enabled, the URL of the iframe element will be assigned by
directly changing the location of the iframe's internal document, rather than using
the iframe's src
attribute. This results in the extension URL not being exposed to the underling web page, and thus making it harder
to detect the presence of Yomichan.