Skip to content

Getting Started with Yomitan

This introduction will help you quickly familiarize yourself with the basics and set you up for a smooth language learning experience.

  • Learn Faster

    Hover over words to see what they mean instantly.

  • Create Flashcards

    Send words straight to Anki in one click, exactly as you encounter them while reading.

  • Works Everywhere

    Use Yomitan on news articles, novels, subtitles, PDFs, and more.

  • Hear Pronunciation

    Play native audio directly from native speakers from local sources or over the internet.

Migrating from Yomichan?

Learn how to migrate to Yomitan here.

Installation

To get started, get Yomitan for your browser:

Manual Installation Required

Firefox doesn't allow testing extensions in the marketplace. Download your desired version and side-load it manually. You only need to do this once—updates are automatic.

Yomitan Setup

After a successful installation, Yomitan will display a welcome page. If you don’t see it, that’s okay—you can complete setup at any time by opening Settings from the Quick Actions menu.

Quick Actions

Click the yomitan icon Yomitan button in the browser bar to open the quick-actions popup.

Browser action popup

  • profile icon Profile

    Quickly switch between profiles with different settings or languages.

    To create new profiles, head to Settings.

  • cog Settings

    Your control hub.

    Make profiles, configure dictionaries, switch themes, and more.

  • magnifying glass Search

    Open the search page to easily look up whole sentences and more.

  • question mark Help

    See the relevant links and information about Yomitan.

Installing Dictionaries

Dictionary Required

Yomitan requires at least one dictionary to function. An orange exclamation mark over the icon indicates no dictionaries are enabled.

To install dictionaries:

  1. Navigate to Yomitan's Welcome or Settings page.
  2. Choose your desired language from the Language dropdown.
  3. Click on Get recommended dictionaries...

You will see a list of publicly available Yomitan dictionaries for the selected language. Install as many as you like — you can enable, disable, or reorder them later.

Custom dictionaries list
Dictionary management interface

If you want to upload your own dictionaries to Yomitan, you can do so via Configure installed and enabled dictionaries → Import. For more on dictionaries, head over to the Dictionaries page.

Learning multiple languages

To use Yomitan with multiple languages, it’s best to create a separate profile for each language.

Go to Settings → Profile → Configure Profiles… → Add to create a new profile. When setting it up, you can:

  • Assign a unique modifier key (for example, Alt)

  • Add conditions so the profile activates only on specific websites or URLs

Once the profile is created, return to the same section and set Active Profile to the new profile. Then, install the dictionaries needed for that language.

Repeat this process for each language you want to use. After setup, you can switch languages instantly by changing profiles from the Quick Actions menu or by using the assigned modifier keys.

Basic Usage

Now that we have our dictionaries installed, you can now use Yomitan to read anything in your desired language.

Info

Open any webpage, such as:

  • News articles
  • Wikipedia
  • Online novels or blogs
  • Social media

Yomitan works anywhere selectable text exists.

Scanning local files and PDFs

In order to use Yomitan with local files in Chrome, you must first tick the Allow access to file URLs checkbox for Yomitan on the extensions page.

In addition, to scan PDF files on your local machine, use the Yomitan PDF Viewer.

Using Yomitan

To read unknown words,

  1. Hold the modifier key (default: Shift)
  2. Move your cursor over the word.

If a definition is found, a popup window will appear.

Popup with search terms
Try it yourself! Hover over text while holding Shift
.

Tip

You can customize the modifier key in Settings to suit your preferences (e.g., Ctrl, Alt, or No Modifier to have the popup open on every word).

Listen to Audio

  • Audio Pronunciation

    If you want to hear the word pronounced by native speakers, click the loudspeaker icon speaker button in the popup.

    No Audio

    If an audio sample isn't available, you'll hear a short click. For more audio sources and configuration options, see Audio Configuration.

    Set up Audio

Export Flashcards to Anki

  • Spaced Repetition

    Yomitan integrates with Anki, a spaced repetition flashcard app loved by many language learners. To export the word as a flashcard, click the add icon export to Anki button in the popup.

    Anki Integration

    If Anki is not running or the connection settings are incorrect, this button will appear grayed out. If you haven't set up Anki integration this button will not appear.

    Make sure Anki is running in the background and that the integration is configured correctly. For more configuration options, see Anki Integration.

    Set up Anki Integration

Need Help?

  • Frequently Asked Questions

    Find answers to common questions about setup, usage, troubleshooting, and more.

    Go to FAQ

  • Community

    Join our community for support and tips, or just to hang out!

    Go to Tech Support

    or visit our home at Discord · Reddit · GitHub !