What is it?
This is a new reorder script, which will prioritize giving you “overdue” reviews. This approach was modeled after iKnow’s review algorithm, but with some (user-customizable) randomness thrown in to minimize the chance of hurting your long-term retention.
In general the review items considered overdue will show up for review before the items not considered overdue. See the settings section below for more details.
How to Install?
- As always, make sure you have a script manager installed. If you don’t, follow these instructions.
- This script depends on the WaniKani Open Framework. Make sure you have that installed by following these instructions.
- Get the script here: WaniKani Prioritize Overdue Reviews
Script Details
What does “overdue” mean?
An item’s overdue percentage is how much time has passed since the review became available divided by the length of the SRS interval. Here are two simple examples:
- An Apprentice 1 item has been available to review for 1 hour.
- Since the Apprentice 1 interval is 4 hours, the overdue percentage is 1/4 = 25%.
- A Master item has been available to review for 3 days.
- Since the Master interval is 30 days, the overdue percentage is 3/30 = 10%.
Why should I use this instead of another reorder script?
Other popular reorder scripts let you reorder by things like WaniKani level and SRS level. Both of those approaches have a high chance of harming your long term retention. When you reorder strictly by WaniKani level or SRS level, your brain starts to consider if you’ve seen an item recently when answering the review. This could hurt your long-term retention, particularly your ability to differentiate between similar looking kanji.
On the surface, reordering by overdue percentage might seem similar to reordering by SRS level. After all, lower SRS level items will generally be overdue more often than higher SRS level items. But there are several important steps this script takes to minimize this risk.
- If you tend not to do all of your reviews the moment they appear, some higher level items will be more overdue than lower level items. Particularly if you tend not to clear your whole review queue very often, eventually higher level SRS items will become more overdue even compared to Apprentice 1 items, forcing you to eventually review them! This is the key difference between sorting by overdue percentage and sorting strictly by SRS level.
- With the default (and recommended) settings for the script, your overdue items will still be shuffled as is done in vanilla WaniKani. That means that when you have a lot of overdue items, they won’t be sorted in any particular way, even though you’ll (mostly) get to review your overdue items before your non-overdue items.
- Also with the default settings, occasional non-overdue items will be mixed in with overdue items. This is once again done to discourage the mindset of guessing based on how recently you learned an item.
Available settings
All of the settings are available to edit during a review session. Saving your settings will automatically update your active review session, so there is no need to refresh the page.
Display Overdue Count
By default, the number of overdue items you have is not displayed anywhere. However, if you turn this setting on, the UI will be updated to look like this:
Advanced Settings
See advanced settings
Overdue Threshold
This value represents the percentage at which your reviews are considered overdue. This setting is used to divide your reviews into an “overdue” queue and a “not overdue” queue.
Valid Values: 0% or greater
Default Value: 20%
Note: Setting this to 0% will make it so that all review items are considered overdue. Depending on your other settings, this will either make the script completely useless or it will increase the chance of harming your long-term retention.
Randomness Factor
This value represents what percentage of your overdue queue should be filled randomly with non-overdue items. This is done to minimize the chance of being able to guess if you’re reviewing an overdue item.
Valid Values: Between 0% and 100%
Default Value: 25%
Using 25% as an example, if you have 8 overdue items, 2 non-overdue items will randomly be mixed in with them.
Note: Setting this too low could harm your long-term retention since it would be easier to guess if you’re reviewing an overdue item.
Overdue Item Sorting
This setting allows you to decide between sorting the overdue part of your review queue or keeping it random.
Valid Values: Random
or Sorted
Default Value: Random
Note: Changing this to Sorted
could harm your long-term retention since it would make it significantly easier to guess the SRS level of the item you are reviewing.
WARNING
It is particularly dangerous to set Overdue Threshold
to 0%, Randomness Factor
to 0%, and Overdue Item Sorting
to Sorted
. This will result in a completely sorted review queue, which like sorting by WaniKani level or SRS level, has a significant chance of harming your long-term retention!
Support
- This script has only been tested in Chrome using Tampermonkey, but will likely work in Firefox as well.
- Please post any bugs/requests and I’ll get back to you as soon as I can.
Revision History
1.0.1 - Update script to use new API endpoint
1.0.0 - Initial release.