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
- Log into WaniKani
- Go to Settings → API Tokens
- Click Generate a new token
- 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