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: Custom Vocabulary
Upload your vocabulary with word, reading, and meaning in 3 columns.
Required Format (word, reading, meaning)
犬,いぬ,dog
本,ほん,book
学生,がくせい,student
水,みず,water
日本,にほん,Japan
大きい,おおきい,big
小さい,ちいさい,small
Supports .csv, .txt, or .xlsx files. You can also download pre-made JLPT decks from the Downloads page.
2. Choose Your Games
Once your vocabulary is connected, you can choose from our collection of games designed to reinforce your Japanese knowledge:
Recall
Can you recall the reading for words from their English meanings?
Word Split
Can you split them right? Separate words joined together!
Kanji Twin
Spot the difference! Match kanji that look alike but aren’t the same.
Memory Match
Test your memory! Pair kanji with their meanings before time runs out.
Word Rush
Type readings before time runs out! Game speeds up as you build streaks.
Conjugate War
Master verbs by conjugating them into different forms!
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