WaniPOP! - A WK popup application

Hello, friends!

Long winded rant about why I made this and how I suck at studying Japanese

I have been on and off this website for over half a decade now. I have reset once (maybe twice, not sure), and every single time, I get to around level 15 or so (like I am now) and then completely burn out and stop using this application.

I’ve been living in Japan for almost 2 years now and have recently started really feeling the burn of not having my vocabulary be where it should be (despite getting really lucky and passing N2, I still feel like I only know enough to do decent on the vocab section of N3). I have been telling myself that I was going to start studying vocabulary again for like a year now and have simply not done so.

I managed to get myself to open WaniKani recently and was immediately reminded that I had a huge mound of reviews to slog through before I’d feel comfortable starting new lessons, and even just looking at the number of reviews made me feel burnt out, and I hadn’t even studied vocab in forever.

I started thinking, “What if I just did like 50 reviews a day or something?” which was quickly followed up with, “I’d probably forget to do them on time again and then end up with another huge pile and get burnt out again.”

Finally, the other day, I thought to myself, “Man… I sit at my computer for work and for pleasure for multiple hours throughout the day. If only there was something that would automatically pop up, bug me to do like 5 reviews once an hour. I feel like that would be such a small amount that I could knock that out in about 30 seconds and go back to what I was doing. That would be like between 40 and 50 reviews a day, and it probably wouldn’t even feel like it.”

So I started digging into the API again and bugging ChatGPT to brainstorm using Tauri to build it out (I also decided to try to use React instead of Vue like I’m used to and greatly regret doing so. I don’t doubt at some point I’ll end up just redoing the UI part in Vue). I’ve been using it over the past couple days and am pretty happy with it.

That being said, I think it’s about time that I’m just real with myself: I hate studying vocabulary. I like all the other parts of language study so much more than studying vocabulary, but I hope that this tool will finally help me get past this hump and start making my way through to fluency. However slow of a crawl it may be, a slow crawl is better than no crawl, and after 10 years of Japanese study, while I am great with conversations, I need to get better, and I’m hoping this helps me do it.

So without further ado:

WaniPOP!

An application that runs in your system tray and automatically pops up every now and then to bug you to do a few WaniKani reviews.

Note: To find the installers, click on “Releases” on the right hand side of the GitHub page.

Note: The API key will need access to be able to get and submit results on your behalf!

About the app & Screenshots


If you get something wrong, it will reappear at the end of the list to go over it until you get it right. Getting it correct here will allow you to finish the study, but the review is marked wrong since you got it wrong the first time.

The Flip button can be used to flip something from correct to incorrect and vice versa. For example, here, I made a typo. I’m ok with marking this as correct, so I’d hit tab to swap to Flip and then press enter. Use this button responsibly! You’re using this to learn. If you double tap enter and miss this, don’t worry! The next screen has you covered!

Once you’re done with the review items, a confirmation screen will appear. You can make a final set of edits to things in case you made a typo and moved forward to quickly or something. To change something to correct or incorrect, simply click the switch. Again, use this screen responsibly!

To finish the study session, scroll down (or tab down) and click submit!

At the end, a small overview pops up to let you know how things changed and what SRS stage the items are.

From here you can simply close the window, and then the program will pop back up in however many minutes you have set in the config, defaulted to 1 hour. Defaults to 5 review items at a time. Both of these settings can be changed (as well as hiding window decorations if you want, which I do because I hate titlebars).

Settings menu:

Known Bugs
  • Radicals that do not have unicode characters, such as Creeper, do not appear
  • WaniKani will occasionally give 500 errors (causing the application to freeze at “Submitting to WaniKani”). If this happens, just close the window and it should work the next time WaniPOP! comes up
Changelog

v0.2.0

  • Add confirmation screen that allows you to have a final chance to choose whether or not something was correct
  • Show SRS stages on results screen
  • Add screen that shows API errors
  • Stop window from automatically popping up if there are no reviews to do at the time

v0.1.0

  • The OG
9 Likes

Ahh, the brainworms for Clair Obscur are everywhere.

1 Like

tried to compile from github but is frozen here:

1 Like

Hey, thanks for checking this out and helping me squash some bugs. :bug:

Can you press CTRL + SHIFT + i and let me know what errors you’re getting in the console?
I just realized I didn’t add which permissions are required on the API key (which I’m not 100% on just yet, to be honest) to the main post.

I think everything save user:update is required.

I’m not doing anything with study_materials yet, but I believe that’s where user defined synonyms for stuff lives, which I plan on adding in soon.

sorry nothing happening when I hit ctrl+shift+i. I am not very technical and don’t know tauri, I just barely scraped by to compile the thing. I couldn’t find a place to put my api key, so that’s probably it. No way to do that in the app, right? any way to distribute an installer with this instead of just the sources?

1 Like

Yeah, there’s no way to do it in the app just yet. I’m actually working on that now. I actually planned on doing some normal installers once I got that set up. I’ll let you know once I have them ready! It shouldn’t be too long. Maybe another couple days.

1 Like

Updated! You can find the Windows .exe installer here. Let me know if it gives you any trouble!

I think it can still error out sometimes when submitting reviews (I sometimes get an internal server error from WK, but I’m sure it’s something I’m doing wrong), but I’ve gone an entire day without it messing up as well, so I’m not 100% sure what’s going on there yet.

It works pretty well though, and it’s helping me whittle down that pile of reviews, so it’s doing its job.

ദ്ദി ˉ͈̀꒳ˉ͈́ )✧

tested it but frozen on submission:


Other than that, seems to work fine!

Ah yeah, that happens to me sometimes as well. Sometimes the WK server will error on submission, and I haven’t figured out why yet (looks like some people were complaining about something similar in some of the other API threads as well). I probably just need to wait a minute and try again after a bit if the server errors out.

I plan on adding in a bit better error handling, so it will get better, but if you just close the window and leave it running in the system tray, it should pop back up a bit later. It should submit correctly most of the time! I get that error once every 8 or 9-ish popups.

As a small update (as I’m sure there are still bugs. I haven’t found out what it’s like when there are no reviews to do. I imagine that will cause an issue. Just thought about that today. Didn’t cross my mind since I had a bunch of reviews to do lol), I have been using this for a little while now (it actually literally just popped up for me to do 5 more reviews) and haven’t run into any issues in a few days. I’m down from 650 review items to 110! ♪┏(・o・)┛♪

Finally felt comfortable enough to take on some new lessons and starting making progress again. Feels good. :blush:

[edit]
Spoke too soon :weary_face:
Gonna have to figure out how to handle weird radicals

2 Likes

Been working on an update. Still testing it to make sure I’m not breaking anything, but adding in the ability to see how far along the different levels for reviews you are, as well as changing the Apprentice color away from red, since it’s used as the “off” or “wrong” color everywhere else. No more thinking you got something wrong for a second, like I always did.

Also making it so that the window will just stay closed if there aren’t any reviews, and optionally display a notification that it checked and there wasn’t anything, as well as handling errors better. :call_me_hand:

Gonna see if I can’t add in some sort of logging as well so if people have issues, I can have them post logs so I can see what’s going on.

Would also like to add in a screen at the end that lets you confirm your correct/incorrect before submitting to WK. Been a few times I get ahead of myself and double tap enter on a misspelling or something, and it gets marked as wrong. Would like a safety net for when my habit of trying to go to the next review as quickly as possible shoots me in the foot.

1 Like

v0.2.0 has been uploaded to the releases here! This should fix a couple bugs and add in a few niceties. I believe the installer should just install on top of the old one, but if it creates a second install, please let me know! I may need to set some sort of configuration flag somewhere or something. Still learning how that part works.

Also updated the original post with new screenshots, including the new confirmation screen.

It’s been small chipping away at stuff, but I can say that thanks to constantly getting popups and it only taking like maybe 30 seconds to do a quick 5 item review, not only did I get caught up and have time to do lessons, I’ve finally made it to level 16! :tada: I think this is the highest I’ve ever been on this website before.

There’s still a lot of words I already know, so I went through and unlocked all of the remaining vocab I had for level 15 to get it into my review queue. I was in between study sessions and wanted to try 10 items per review instead of just 5 and see how that felt, bringing my daily review count to between 80 and 100 but spread out throughout the day. I realized I don’t have a way to pull up the settings menu when the application is sitting in the system tray. I think that’ll be the next thing that I work on.

1 Like