WaniKani Usercripts on Safari for iPadOS

WaniKani API And Third-Party Apps
1

Hi All!

Useless Intro

So ever since I started to get serious with my Japanese learning, I went ahead and read a few level 60 celebration posts. I noticed that all of them had used userscripts for the quality of life. I’m not a big fan of coding in general so I try to avoid it if I can. However, when I tried to look into the userscripts and installed the first one which was Back2Back, I gotta say I got hooked. Now, I don’t usually have my work laptop with me. I actually leave it in the office when I go home, all for good reason: it’s too bulky. And it’s not mine, at the end of the day. I also don’t wish to bring it all the time just to do my reviews with the userscripts. I have my iPad and it’s become my daily driver for consuming media and etc. So, I want to have the userscripts on Safari as well. I still use the Tsurukame App if I do my reviews during commute since it’s more convenient that way. But at home, when I don’t have my laptop with me, I usually use Tsurukame + WK on Safari (Vanilla).

image
image526×790 68.4 KB

As the title says, I want to share how to enable userscripts for WaniKani on Safari for iPadOS. Right now, I have an iPad Pro 11" m2. I’ve read some topics about it in here but some of them were from 3 years ago, or not really helpful. The first topic I saw that gave me a ray of hope was using Userscript App from Appstore. I tried it and it worked yesterday. But I had issues with other userscripts loading, or just generally not working. Then when I tried it today, it just completely stopped working. Maybe I’m just so 下手(へた)。

I found another userscript App called Stay for Safari and so far it has been working pretty well.

Here are the scripts that are currently working with Stay for Safari browser extension:

  • WKOF
  • WKOF Additional Filters
  • WK Word Frequency Filter
  • WK Back2Back
  • WK Dashboard Level Progress
  • WK Self-Study Quiz
  • WK Pitch Info
  • WK Heatmap
  • WK Confusion Guesser
  • WK Rendaku Information
  • WK Better Lesson Picker
  • Niai Visually Similar Kanji
  • WK Show Context Sentences - This one shows up during review so it might look disabled in the WK main dashboard

The ones in bold are what I believe to be essential in terms of quality of life. In my opinion, these are the bare minimum userscripts that you would need to replicate the desktop browser experience with the amazing Tampermonkey. There are still more that I tried but I found them to not be working.

If you have other userscripts that you are using, please do share!

Disclaimer: I have not tried it on my iPhone yet, so I’m not sure if it will be the same.

How to Install Stay for Safari:

  1. Needs iPadOS 15.0+

  2. On your iOS device, open Appstore and search for Stay for Safari.

  3. Open the Stay app and you may register for an account so you can backup the list of userscripts that you will install.

  4. Find a userscript in this forum (you can reference the list above if you wish, but make sure to install WKOF and WKOF additional filters first before anything else).

  5. Go to the greasyfork page and copy the download link. It usually links directly to the .js file like this.

  6. Open the Stay app and click the plus (+) sign on the left side panel.

    image
    image2388×1668 217 KB

  7. Add the download link as “Link” and it will ask you to “Allow paste” to place the download link

    image
    image1149×637 101 KB

  8. The Stay app downloads the .js userscript and loads it up on the app page. This also loads it on the Safar browser. And just like any desktop browsers, you need to refresh the page (sometimes multiple refreshes) to load the extensions.

  9. You can see the extension settings on your profile

    image
    image1085×1026 106 KB

or on the lessons/review page and tweak it to your preference.

image
image2388×1461 318 KB

Additional Info

  1. Sometimes there are scripts that are not updated but another community member posts their own version of it. In that case, copy the whole userscript in the clipboard (Ctrl+C) and in the Stay app, click the plus (+) sign and create a New Userscript. Paste the script to replace everything and click Create. This saves the script on the Stay app and loads it on the browser as well.

    image
    image2388×1668 230 KB

    image
    image2388×1668 502 KB

  2. You can also rearrange the userscripts in the Stay app. I’m not sure if that actually does anything at all. But it’s quite neat.
    rearrange scripts

Other Issues and Concerns:

These are the userscripts that I have installed and found not working with Stay. I’m not sure if it’s within the code itself or with the Stay app, so I went ahead and sent an email to the dev regarding this. I will update this topic once I got a reply. :slight_smile: I’ve searched for the error as well but I didn’t see any related documentations. Or I just got lazy XD

  • Niai Visually Similar Kanji - This works but somehow I need to disable and enable this userscript when in lessons/review. So I just turn it off
  • WK Better Progress Bar
  • WK Level Duration 2
  • Jitai
  • WK Progress Percentage
  • WK Overall Progress
  • WK Forecast Details

I have not tried any other userscripts app aside from UserScripts and Stay for Safari. I don’t know if other userscripts app in the Appstore are better than the one I’m using. But so far, I’ve got the essential userscripts so I can just leave my laptop in the office and not worry about not having similar experience in iPad.

I definitely did not sacrifice some lessons and review time in order to write this. N-not that I intended to do that! I-In my defense, I didn’t want to forget this.

5 Likes