Notice!
This script is no longer under active development and will stop functioning the 18th of April. Potential users are suggested to use the lesson cap script, which has the same functionality as this script, but is under active development.
What is it?
This script limits your lessons to avoid burnout, and displays some information at the top of the lessons page.
Why would I want this?
From time to time, the question “How many apprentice items should I keep” is asked. The answer is generally given as a value between 70 and 150. While the idea behind this is sound (avoiding burnout by limiting lessons), the approach is limited. This script is more accurate, as it counts not only items in all SRS groups (apprentice, guru[…]), but also all SRS levels, from one to nine. It automagically blocks you from adding too many lessons if it detects you will have too many reviews.
How does it work?
Put simply, it calculates a score for the amount of items you have in each SRS level. Currently, the script multiplies the amount of items in the level with 3, 1.5, 0.52, 0.255, 0.07, 0.035, 0.015 and 0.005, ascending with level (burned items obviously do not count towards your score). One newly learned item is worth 3 points, after one successful review, it’s worth 1.5 and so on. You can adjust the aggressiveness of the script with the “spiciness” option. A low spiciness will mean fewer reviews per day, a high spiciness will mean more reviews per day.
How do I use it?
You have to have a userscript manager installed, like Greasemonkey (Firefox) or Tampermonkey (Chrome). After you have that, you can navigate to the URL provieded below, under “Download”, and click install. You then navigate to your lessons page, where you will be asked for your API v2 key, a number for spiciness and items per lesson. You can find your API v2 Key on the account settings page, and “items per lesson” under “Lesson batch sizing” on the app settings page. I suggest you set this to 3, but you can use the script with any setting you want.
Further usage instructions
The bar at the top of the page shows you the amount of items in each SRS level. In parenthesis is the spiciness score for that level. ie, if you have 4 level one items, the score is 12, if you have 19 level two items, the score for that level will be 28.5. The total is added up in the box with the text: “全額”. You can adjust your settings if you click the text “設定”
The number showed next to “Start session” in the box with the text “回”, is the amount of sessions of lessons you can do without exceeding your max spiciness score. Try not to do more than this amount, or this script will be quite pointless. If one session of lessons would put you over max spice, the script will remove the link to start your session. This is why I suggest a low setting for lesson batch sizing in your account page and in this scripts options.
Does it work?
Yes!
Disclaimer
This script is made with the new API V2, and likely to break at some/many points. I’ll try to update the script then, but buyer beware anyway. It is also not tested to any real extent. If any breakage occurs, it was not on purpose. Sorry.
I’m not a computer programmer by trade. This script is probably stupid and inefficient. It seems to work for me though, so I wanted to share it.
On the bright side, if you want to make the script better, feel free to copy it and use it any way you want. License information. Maybe you can make a better script than me. I’d probably download it.
Download
You can find the script on Greasyfork.
Use without userscript
You can see your scores on this site. Press the [設定]-key to reset your API-key.