Yomitan Installation and Configuration Guide: A Beginner's Handbook

By The ReadSavor Team | Published on 2025-12-07

Yomitan Installation and Configuration Guide: A Beginner’s Handbook

For Japanese learners, Yomitan (formerly Yomichan) is undoubtedly a “god-tier” browser extension. With its powerful pop-up dictionary and one-click Anki card creation features, it significantly lowers the barrier to reading native Japanese materials, allowing countless learners to immerse themselves in the authentic Japanese world.

However, this “god-tier” tool is not plug-and-play. Its complex initial configuration process often deters many eager beginners, exhausting their patience at the very first step. From finding compatible dictionaries to setting up Anki integration, every step can become a “roadblock” to your efficient learning.

Don’t worry! This guide will provide you with a detailed Yomitan installation and configuration tutorial, walking you through these initial obstacles step-by-step, so you can easily master this tool and truly enjoy the pleasure of immersive reading. At the same time, we will also explore how ReadSavor further surpasses the limitations of traditional tools in the pursuit of an ultimate seamless learning experience.

What is Yomitan/Yomichan?

Simply put, Yomitan (pronounced Yomi-chan) is a browser extension designed specifically for Japanese learners. Its core function is “pop-up dictionary lookup”. When you browse a Japanese webpage, hold down the Shift key (default setting) and hover your mouse over a word, and a small window will immediately pop up, displaying information such as the word’s reading, meaning, and pitch accent.

More importantly, Yomitan also supports seamless integration with the memory software Anki, enabling “one-click card creation.” When you look up an unfamiliar word, click the ”+” sign in the pop-up window, and it will automatically create a new flashcard in your Anki deck, including the word, reading, definition, example sentence, and even audio pronunciation. This process, known as “sentence mining,” greatly saves the time spent on manually creating word cards.

⚠️ Important Note: The original Yomichan project ceased maintenance in 2024. The community-recommended successor is now Yomitan. Both have almost identical features and settings, so it’s recommended to install Yomitan directly.

Step One: Install the Yomitan Browser Extension

Yomitan supports popular browsers like Chrome and Edge.

  1. Open your browser’s app store:
  2. Search for “Yomitan”: Enter “Yomitan” in the store’s search bar and press Enter.
  3. Add to browser: Find the Yomitan extension, click “Add to Chrome” or “Get,” and then confirm adding the extension.
  4. Pin the extension icon: After installation, click the puzzle piece icon (Extensions management) in the top right corner of your browser, find Yomitan, and click the pin icon to pin it to the toolbar for easy access.

Step Two: Import Japanese Dictionary Files

Yomitan itself does not come with dictionaries; you need to import them yourself. This is where many beginners get confused.

  1. Download dictionary packs:
    • Due to copyright reasons, Yomitan official does not provide commercial dictionary downloads. You will need to search online for “Yomitan Dictionaries” or “Yomichan dictionary packs.”
    • Recommended dictionary sources are usually open-source projects on GitHub or shared by Japanese learning communities. Common dictionaries include:
      • JMdict (Japanese-English dictionary, basic)
      • JMnedict (Japanese proper nouns)
      • Kanjidic2 (Japanese Kanji information)
      • Daijirin / Kōjien (Japanese-Japanese dictionaries, suitable for advanced learners)
    • Downloaded dictionary files are usually in .zip format; please do not unzip them.
  2. Open Yomitan settings:
    • Click the Yomitan icon on your browser toolbar and select “Options.”
    • Select “Dictionaries” from the left-hand menu.
  3. Import dictionaries:
    • On the “Dictionaries” page, find the “Import” section.
    • Click the “Browse” button, select your downloaded .zip format dictionary file, and then click “Import.”
    • Repeat this step to import all the dictionaries you need.
  4. Adjust dictionary order: After importing, you can drag and drop to adjust the priority of the dictionaries. It’s generally recommended to place Japanese-Chinese/Japanese-English dictionaries first, followed by Japanese-Japanese dictionaries.

Anki integration is Yomitan’s “killer feature,” but it can be relatively complex to set up.

  1. Install Anki Desktop: If you don’t have Anki yet, go to the Anki website to download and install the desktop version.
  2. Install the AnkiConnect Add-on:
    • Open Anki Desktop, click “Tools” -> “Add-ons” -> “Get Add-ons” in the menu bar.
    • Enter the AnkiConnect add-on code: 2055492159 in the pop-up window and click “OK” to install.
    • After installation, restart Anki.
  3. Configure Yomitan with AnkiConnect:
    • Reopen Yomitan’s “Options,” and select “Anki” from the left-hand menu.
    • Ensure that “AnkiConnect URL” is set to the default value http://127.0.0.1:8765.
    • Card Template Settings: This is the most crucial step. You need to select an Anki Deck and a Note Type.
      • Deck: It’s recommended to create a dedicated deck for Yomitan, such as “Japanese Vocabulary.”
      • Note Type: Yomitan’s default note types may not fully meet your needs. You can use Anki’s built-in “Basic” or “Basic (and reversed card)” note types, or customize one.
      • Field Mapping: You need to map Yomitan’s lookup result fields (e.g., Expression, Reading, Definition, Sentence) to the corresponding fields in your Anki note type. For example:
        • Expression -> Front
        • Definition -> Back
        • Sentence -> Example Sentence
        • Audio -> Audio
      • Modifying Card Style: If you want to modify the style of your Anki cards (e.g., put example sentences first, or add color), you need to edit the note type in Anki and modify its HTML/CSS template. This can be a challenge for non-programmer users.

Yomitan’s Limitations: Why ReadSavor Goes Further?

Yomitan is an excellent tool that plays an important role in Japanese learning. However, as we previously analyzed in depth in “The Ultimate Yomichan/Yomitan Guide: From Beginner to Master, and How ReadSavor Surpasses Traditional Lookup Tools”, it also has some clear pain points:

  1. High “Initial Configuration” Barrier: As shown in this guide, the installation and configuration process is not beginner-friendly, requiring users to have certain technical skills and patience.
  2. Fragmented Mobile Experience: Yomitan is primarily designed for desktop browsers, and its experience on mobile phones and tablets is suboptimal, failing to meet users’ needs for fragmented learning.
  3. Poor Support for “Non-Text” Content: For non-text content like manga, images, and PDFs, Yomitan often cannot directly recognize the text, requiring the use of other tools, which increases the complexity of learning.
  4. Difficulty with Polysemous Words: Yomitan lacks AI contextual understanding capabilities. When faced with polysemous words, it cannot intelligently recommend the most contextually appropriate definition, which can lead to learners choosing incorrect meanings or memorizing inaccurately.
  5. Prone to “Squirrel Syndrome”: The ease of one-click card creation can lead users to blindly collect a large number of new words, ultimately falling into “review hell” and discouraging learning motivation.
  6. Inability to Parse Complex Sentence Structures: Yomitan is a dictionary tool, not a grammar analyzer. It can provide word definitions but cannot help users understand the grammatical structure and logic of complex sentences. If you want to understand the roles of Yomichan and ReadSavor in immersive learning, you can read “Japanese Immersive Learning: The Roles of Yomichan and ReadSavor”.

ReadSavor’s design philosophy is precisely to address these pain points, providing a frictionless, integrated, and intelligent immersive language learning system. We believe that learning tools should “feel invisible,” allowing learners to focus on the content itself.

  • Out-of-the-box, no configuration needed: ReadSavor requires no tedious installation or configuration; simply register and use. All features (including AI contextual translation, automatic vocabulary saving, and immersive review) are integrated.
  • Large-screen immersive experience: ReadSavor is designed specifically for large-screen reading, providing a consistent and optimized immersive reading and learning experience, allowing you to learn efficiently on your desktop. For how ReadSavor solves the dilemma of desktop reading, you can refer to “ReadSavor: Desktop Seamless Reading of Selectable Text PDFs and Various Web Content, Bidding Farewell to Yomitan’s ‘Non-Pure Text’ Dilemma”.
  • AI contextual deep understanding: ReadSavor utilizes advanced AI technology to provide three layers of deep analysis (direct translation, contextual meaning, grammar analysis), and can intelligently handle polysemous words and complex sentences, helping you achieve true anatomical understanding.
  • Automated, frictionless vocabulary review: All looked-up words are automatically saved and contextually highlighted in the original text, allowing you to naturally review them when re-reading, saying goodbye to “squirrel syndrome” and “review hell.” We are not selling a lookup function, but an uninterrupted immersive flow state.

Conclusion: Upgrading from a “Tool” to a “System”

Yomitan is a powerful tool that opens the door to native materials for Japanese learners. Through this guide, we hope to help you successfully install and configure Yomitan and fully leverage its advantages.

However, on the path to a more efficient, seamless, and intelligent language learning experience, ReadSavor offers an upgrade from a “tool” to a “system.” It not only addresses many of Yomitan’s pain points but also, through its unique product philosophy, helps learners unify intensive and extensive reading, eliminate the friction of flow interruption, and truly achieve the principle that “interest is the only criterion for choosing reading material.” ReadSavor is particularly well-suited for deep reading and learning on large screens, providing an unparalleled immersive experience.

If you are tired of switching between multiple tools and yearn for a learning environment that allows you to focus on reading itself while efficiently building vocabulary and understanding grammar, then give ReadSavor a try. It will usher you into a new era of immersive language learning.