Installing Wanikani Open Framework

Why you’re reading this:

If you recently installed a userscript, and you suddenly find yourself reading this, it’s (probably) because the script requires the Wanikani Open Framework, an open-source, user-created project for making it easier to write scripts for Wanikani.

Below are the instructions for properly installing the framework.

(If you’re reading this thread for any other reason… well, hello :slightly_smiling_face:. Feel free to look around!)

Installing the Open Framework

1. Install a script manager (TamperMonkey, etc.)

First, you’ll need a script manager plugin for your browser, such as TamperMonkey or ViolentMonkey (GreaseMonkey is currently not supported). TamperMonkey is currently the most commonly used and widely supported by the Wanikani community and its various script writers. Note that whichever script manager you choose, it must support the ability to specify the order that scripts load on the web page. (TamperMonkey and ViolentMonkey both support this).

2. Install the Wanikani Open Framework

Go to the following link, and click the Install button.


3. Set the Open Framework to run before all other scripts

Open your script manager’s options. The following image shows how to do this for TamperMonkey:


In the script manager’s options, set the Wanikani Open Framework to run first. The image below demonstrates how to do this in TamperMonkey. First, make sure your scripts are sorted by # as shown (click on the # if it doesn’t show the little arrow next to it). This turns on the ‘Sort’ column on the right side. Click-and-drag the Open Framework’s ‘Sort’ icon until it’s at the top of the list. When you release the mouse button, the script should be # 1. [Note: The ‘#’ column must be sorted in ascending order, with #1 on top, otherwise the ‘Sort’ column will not appear. Click the # again if #1 is not on top.]. If you still have trouble for some reason, try this [alternative method].


4. Install any script that uses the Open Framework.

Now you are ready to install any script that supports the Wanikani Open Framework. For a list of useful scripts (some of which use the Open Framework), check out [The New And Improved List Of API and Third Party Apps]. If you already installed a script, you can skip this step. However, as long as the script you installed shows up after the Wanikani Open Framework in the script-order window.


If you followed the above instructions and are still being redirected to this thread, please ask for help in this thread. It often helps to tell us which browser you’re using (including the version), and which script manager (e.g. TamperMonkey). Also, try posting a snapshot of any errors on your Javascript console. You can access your Javascript console by pressing F12 and clicking on the Console tab.

If you keep getting forwarded to this thread, and you really just want it to stop doing that, please disable your script manager until you can get some help fixing the issue.


If you have any trouble with these instructions, please ask for help in this thread. We have a friendly and helpful community here, so you’ll probably get some helpful replies quickly. Also, I’ll do what I can to improve the instructions as questions arise.

Wanikani Open Framework [developer thread]
[Userscript]: WaniKani Ultimate Timeline
Wanikani leeches to Anki
[Userscript] WaniKani Lesson Cap
[Userscript] WaniKani Lesson Hover Details
[Userscript] Self-Study Quiz
[Userscript] Level Duration 2.0
[iOS] Mobile AlliCrab for WaniKani
[Userscript] WaniKani Leech List
[Userscript] WaniKani Dashboard SRS and Leech Breakdown
[Userscript] Wanikani Show Item Level
Unofficial FAQ
[Userscript]: WaniKani Ultimate Timeline
[Userscript]: Reorder Ultimate 2 [newest]
[Userscript] WaniKani Lesson Examples Audio
[Userscript] WaniKani Open Framework Additional Filters (Recent Lessons, Leech Training, Related Items, and more)
[Userscript]: Double-Check (Version 2.x)
Wanikani Reorder Ultimate [old version, not working]
[Userscript] WaniKani Lesson Cap
[Userscript] WaniKani Dashboard Leech Tables - Notice your leeches
Level 60! Double Cake Day!
New People Questions! ~~~<3 [Lost?! Confused?! We're here to help!]
[Userscript] Progress Percentages
[Userscript]: WaniKani Ultimate Timeline
Should I get a WaniKani Subscription?
[Userscript] Wanikani Item Inspector
[Userscript] Exact Review Time
[Userscript] Total Progress Bar (Allows Level Progress Removal)(aka 2Cool4Progress)
[Userscript] Upcoming Lessons
[Userscript] Dashboard Level Progress Detail. update to broken script
[Userscript] Dashboard Level Progress Detail. update to broken script
Level 60 in 362 straight days of reviews
Wanikani Reorder Ultimate [old version, not working]
[Userscript]: Part of Speech Filter (for Self-Study Quiz)
Am I taking too much time to learn?
Powerpunching my way to the golden badge! (AKA my level 60 thread)
New Level on wanikani
How do I access user scripts?
[Userscript] Show Number of Learned Kanji, Vocab
Has something changed? All the scripts I use are broken
I've climbed the WaniKani summit, yet there are many mountains left to climb
Issue with Reorder Script?
After a long break
General Tips Needed
Can not click on the 'ignore answer' button
[UserScript] Leech List Burn-Only Upgrade
Mouseover Text in the new UI
[Userscript] ConfusionGuesser
API version 2 moving out of beta. Sunsetting API version 1
Which subscription option should I go for?
[Userscript] WK Review Forecast Clock Style
[Userscript] Extra Study: Audio Quiz
[Userscript] WaniKani Review Timer (Eggtimer Overhaul)
How's everyone like the new layout?
Please Send Help! - Scripts FIXED
Help with level reset
[Userscript] WK Dashboard Cockpit
Did my first review, but there's no countdown for the next review
[Userscript] Level SRS Details
[Userscript] Forecast details / critical reviews
JLPT 2022 thread
My Journey of 368 days (+ The Ultimate Guide for WK :open_book: )
[Userscript] WaniKani Open Framework Statistics Filters
[Userscript]: Double-Check (Version 2.x)
Is there a way to export learned Verbs and Adjectives?
[Userscript] Enhanced Levels Overview
Vocab sound cutting off?
[Userscript] WK Fake Numbers 1.4+
[Userscript] WK Reading Breakdown
[Userscript] Wanikani Real Score
[Userscript] WaniKani Open Framework Search Filters
My Journey of 352 days
[Userscript] Item List Filter (for Self-Study Quiz)
[Userscript] WaniKani Open Framework Date Filters
New to Tofugu and WaniKani
New to Tofugu and WaniKani
[Userscript] Open Framework Kanjidic2 and Traditional Radicals Filters
[Userscript] Simple Show Context Sentence
[Userscript] WaniKani Workload Graph
[Userscript] WaniKani Custom Immersive Dashboard
Finally level 4 ! My experience
[Userscript] SRS Counters
[Userscript] WK lesson cherry-picker
[Userscript] WaniKani Lesson User Synonyms 3
[Userscript]: Anime Context Sentences
[Userscript] WaniKani Kanji Review Vocabulary List
Problems with Niai script
What do you want now? (Request extensions here)
Frustrated with Answer Recognition
[Userscript] Burn Progress
[Workaround/Fix] Broken - Item Info/Kana Chart/Wrap Up
[Userscript]: Anime Context Sentences
[Userscript] The GanbarOmeter
[Userscript] WaniKani Review Clock
[Userscript] Reorder Buttons
[Userscript] WaniKani Lesson User Synonyms v2
Need to retype correct reading/meaning after undo
[Userscript] WaniKani Rendaku Information
What would be the easiest way to make a spreadsheet collecting all context sentences?
[Userscript]: Anime Context Sentences
[Userscript] Enhanced Search Results v0.0.6
[Userscript] WaniKani Dashboard Level Progress Detail 1.0+
Japanese WaniKani dashboard UserScript
[Userscript] Advanced Context Sentence 2
[Userscript] Anki Mode
[UserScript] Better Progress Bar
Thoughts upon reaching level 60
[Userscript] Wordle-Kani
[Userscript] Community Mnemonics 2 (WKCM2)
Inconsistent error acceptance
Showing Of Verbs
Knowing how Wanikani works is making everything way more stressful now
[Userscript] Dashboard Progress Plus
[Userscript] Self-Study Hide Info
Scripts for Wanikani not working
Help installing Burn Manager
Add ons?! dying?!
More Reviews Text Replacer
[Userscript] WaniKani Prioritize Overdue Reviews (reorder script)
[Userscript]: WaniKani Ultimate Timeline
[UserScript] Advanced Context Sentence
Ah! Everything looks different!
Reviewing/using notes with SRS?
Is there an easy way to study mistakes?
Olympians (medalists announced - congrats everyone!)
[Userscript] Wanikani Leaderboard
Add ons?! dying?!
What do you want now? (Request extensions here)
[Userscript] Levels by SRS
Wanikani reorder ultimate 2 down
WaniKani Routine Thread
Lessons not coming quick enough in level 3
The 0/0 Streak Challenge

Having trouble moving Wanikani Open Framework to the #1 slot?

If you have trouble setting the order of your scripts in TamperMonkey, there is an alternate way to move the Wanikani Open Framework to the #1 spot:


For any scripters using the Open Framework:
If you’d like to have your script redirect your users to this thread if the Open Framework isn’t installed (correctly), I’m currently recommending adding the following code to the top of your scripts:

If you don’t need a certain version of the Open Framework:

    // Initialization of the Wanikani Open Framework.
    var script_name = 'Your Script Name Here';
    if (!window.wkof) {
        if (confirm(script_name+' requires Wanikani Open Framework.\nDo you want to be forwarded to the installation instructions?'))
            window.location.href = '';

If you do need a certain version of the Open Framework:
(be sure to change the version after pasting!)

    // Initialization of the Wanikani Open Framework.
    var script_name = 'Your Script Name Here';
    var wkof_version_needed = '1.0.29';
    if (!window.wkof) {
        if (confirm(script_name+' requires Wanikani Open Framework.\nDo you want to be forwarded to the installation instructions?'))
            window.location.href = '';
    if (wkof.version.compare_to(wkof_version_needed) === 'older') {
        if (confirm(script_name+' requires Wanikani Open Framework version '+wkof_version_needed+'.\nDo you want to be forwarded to the update page?'))
            window.location.href = '';

Something seems to be going wrong ever since I installed the script. Synonyms are unable to be added from the reviews window and there seems to be a limit to the amount of synonyms I can add outside of it. I don’t know if it’s another particular script that is doing this or if it is the open framework, but I seem to be having this problem.

What scripts do you have installed? And what script prompted you to install the framework?
Although I think it’s unlikely that the Framework is the cause, I certainly won’t rule it out.

Sorry, it took me a few minutes. Here is a screenshot of my dashboard

That’s a lot of scripts!! :slight_smile:
Could you first try disabling the scripts that rely upon the Open Framework, one at a time, and check if the problem goes away? And once all of them (that rely on the framework) are disabled, then disable the Framework itself and see if it goes away?

If you want to try this repeatedly without affecting your reviews, you can temporarily install this script:
[Wanikani Disable Review Submission]

1 Like

Ha, yeah I did kind of get carried away after seeing how useful they could be.:sweat_smile:

How do I figure out which scripts use the Open Framework. I’m a little lost on that front.

You could disable the Open Framework first, then any scripts that use it should pop up a message box and then forward you to this thread if they detect that it’s not running… assuming all of the script writers followed my suggestion for forwarding people to this thread if their script fails to detect the framework.

[edit: I’ll be away from the keyboard until evening]

1 Like

Thanks for the help! So, from the looks of it the problem had something to do with the WaniKani Fast Abridged Wrong/ Multiple Answer. I’ll try switching it on and off again and contact the makers if that doesn’t work. The Open Framework seems to be doing fine.

1 Like

Yeah, Wanikani fast abridged is broken. Just checked and it’s the only script giving me the message that redirects to this thread. Which is really confusing because when I edit Wanikani fast abridged script, I can’t find the little line of code that redirects here!
Nvm, found it. Removing the code doesn’t fix it.

Broken? Details?

BTW, @DaisukeJigen, I just noticed the text in the alert box says “SRS Grid requires Wanikani Open Framework.”

1 Like

That’s what I get for working on two things at once I guess. Stupid cut and paste mistakes.

1 Like

It just doesn’t work after the framework update which I assume was recent. I installed your script just two days ago and it was working fine before.

Maybe a silly question, but did you install the framework?
(And according to instructions, since it has to run before other scripts?)

Jumping in here just to say that either Open Framework or WK Fast/Abridged is preventing me from adding synonyms during reviews. I click the “Add synonym” button and it vanishes, but no text field to type in appears.

I disabled both of these scripts (and nothing else), then was able to add synonyms again.

Yes, but I use a different script manager, violentmonkey. Though, I don’t think that should make a difference… I’m gonna try disabling other scripts and see if that fixes it.
EDIT: Nope. :pensive:
EDIT2: Tried running the scripts on tampermonkey and it didn’t work there either, so it’s not a script manager problem.

re: synonyms,
We discovered an incompatibility between Wanikani and jQuery UI. I released a workaround last night, so it should work after you update the Framework script.

Just upgraded to 1.0.12 but I’m out of reviews to test it on for now. I’m used to my script manager updating scripts automatically though, does it only check once a day or something? (I’m using Tampermonkey)