How Asoi Works

Three simple steps to personalized Japanese games

1. Connect Your Vocabulary

Your journey begins by connecting your known vocabulary. We offer two ways to do this:

Option 1: WaniKani Integration

Connect your WaniKani account to use vocabulary you've already learned.

Getting Your API Key

  1. Log into WaniKani
  2. Go to Settings → API Tokens
  3. Click Generate a new token
  4. Copy the token and paste it into Asoi

Your API key is stored securely in your browser and never sent to our servers.

Option 2: CSV Upload

Upload a list of Japanese words you already know.

Example Format (One word per line)



学生

日本
大きい
小さい

Save as .txt or .csv file. A sample file is available on the home page.

2. Choose Your Games

Once your vocabulary is connected, you can choose from our collection of games designed to reinforce your Japanese knowledge:

Jordle

Guess the reading of Japanese words in this Wordle-inspired challenge.

Word Split

Identify where words begin and end in continuous Japanese text.

Memory Match

Match pairs of words and meanings in this memory challenge.

Word Search

Find Japanese words hidden in a grid of characters.

Recall

Given English definitions, recall the Japanese words.

CrosswordComing Soon

Fill in a crossword puzzle with Japanese words.

All games use only your vocabulary. This ensures you're practicing words you already know, making the experience more effective.

3. Customize Your Experience

Each game offers customization options to match your learning style:

Game Settings

Adjust difficulty levels, input methods, and game length to fit your needs. Use helpful hints when you need assistance.

Vocabulary Filters

WaniKani users can filter by SRS stage to focus on specific sets of vocabulary at different learning stages.

Immediate Feedback

Each game provides immediate feedback on your performance:

  • See correct answers with kanji, readings, and meanings
  • Review your score and accuracy at the end of each game