# \[Userscript\] Item List Filter (for Self-Study Quiz)

**URL:** <https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595>\
**Category:** API And Third-Party Apps\
**Created:** [August 25, 2020, 5:50pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595 "2020-08-25T17:50:24Z")\
**Posts on this page:** 19\
**Page:** 1

<div class="post-metadata">

**Author:** ![rfindley](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rfindley/32/35202_2.png) [@rfindley](https://community.wanikani.com/u/rfindley)\
**Post date:** [August 25, 2020, 5:50pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/1 "2020-08-25T17:50:24Z")

</div>

## Item List Filter (for Self-Study Quiz)

A filter for creating a list of specific items to quiz on.

> ⚠ This is a third-party script/app and is not created by the WaniKani team. By using this, you understand that it can stop working at any time or be discontinued indefinitely.

👉 **[[“Item List Filter” script](https://greasyfork.org/en/scripts/409955-wanikani-item-list-filter-for-self-study-quiz)]**

### Other things you need:

**[[General Script Installation instructions](https://community.wanikani.com/t/visual-guide-on-how-to-install-a-userscript/12136)]**  
**[[Open Framework Installation](https://community.wanikani.com/t/installing-wanikani-open-framework/28549)]**  
**[[Self-Study Quiz](https://community.wanikani.com/t/userscript-self-study-quiz/13191)]**

### Setup

 ![image](https://global.discourse-cdn.com/wanikanicommunity/original/4X/d/8/8/d885dfa26041ec24b673beb3120a102f44a03d7d.png)

**NOTE:** When setting up a list of items to quiz on, it is important to understand how these filters work, because they have a slightly non-intuitive behavior:

Suppose you want to quiz on a set of vocabulary. When you enable the [Vocabulary List] and specify your vocab items, it will remove all vocabulary except the ones you specified. (Duh, right?). But… it DOES NOT remove any kanji or radicals from the quiz, so you will still have _all_ kanji and radicals in your quiz unless you also check “Vocabulary” in the [Item Type] filter.

Essentially, the filters do this:

- **Radical List** - If the item is a radical and it’s not in the specified list of radicals, remove it.
- **Kanji List** - If the item is a kanji and it’s not in the specified list of kanji, remove it.
- **Vocabulary List** - If the item is vocabulary and it’s not in the specified list of vocabulary, remove it.

So, suppose you want to quiz yourself on:

- Vocab: 大きい and 小さい
- Kanji: 大 and 小
- Radicals: -none-

Then you would:

- Enable the [Vocabulary List] filter and add the two vocab words.
- Enable the [Kanji List] filter and add the two kanji.
- Enable the [Item Type] filter and check both Kanji and Vocabulary (and leave Radicals unchecked).

---

<div class="post-metadata">

**Author:** ![Joeni](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/joeni/32/632588_2.png) [@Joeni](https://community.wanikani.com/u/Joeni)\
**Post date:** [August 25, 2020, 5:52pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/2 "2020-08-25T17:52:47Z")

</div>

The anticipation is palpable!

---

<div class="post-metadata">

**Author:** ![Powerpuncher](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/powerpuncher/32/231125_2.png) [@Powerpuncher](https://community.wanikani.com/u/Powerpuncher)\
**Post date:** [August 25, 2020, 6:16pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/3 "2020-08-25T18:16:01Z")

</div>

placeholder

---

<div class="post-metadata">

**Author:** ![jprspereira](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/jprspereira/32/389740_2.png) [@jprspereira](https://community.wanikani.com/u/jprspereira)\
**Post date:** [August 25, 2020, 6:24pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/4 "2020-08-25T18:24:03Z")

</div>

Great script, recommend it to everyone!

---

<div class="post-metadata">

**Author:** ![Joeni](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/joeni/32/632588_2.png) [@Joeni](https://community.wanikani.com/u/Joeni)\
**Post date:** [August 25, 2020, 6:26pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/5 "2020-08-25T18:26:21Z")

</div>

> [@Powerpuncher](#):
>
> placeholder

A custom implementation of vacation mode, perhaps.

Or a way to keep your review session open when you close the browser.

The possibilities are endless…

---

<div class="post-metadata">

**Author:** ![rfindley](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rfindley/32/35202_2.png) [@rfindley](https://community.wanikani.com/u/rfindley)\
**Post date:** [August 25, 2020, 6:38pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/6 "2020-08-25T18:38:29Z")

</div>

Oops… I fixed the link to the script in the top-post.

---

<div class="post-metadata">

**Author:** ![prouleau](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/prouleau/32/376127_2.png) [@prouleau](https://community.wanikani.com/u/prouleau)\
**Post date:** [September 1, 2020, 1:06pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/7 "2020-09-01T13:06:16Z")

</div>

@rfindley this is a bug report.

I have tested this script with Item Inspector.

> [@\[Userscript\] Wanikani Item Inspector](https://community.wanikani.com/t/userscript-wanikani-item-inspector/44564):
>
> warning This is a third-party script/app and is not created by the WaniKani team. By using this, you understand that it can stop working at any time or be discontinued indefinitely. Requirements: [[General Script Installation instructions](https://community.wanikani.com/t/visual-guide-on-how-to-install-a-userscript/12136)] point_left You’ll need a script host plugin like TamperMonkey [[Open Framework Installation](https://community.wanikani.com/t/installing-wanikani-open-framework/28549)] [[Open Framework Additional Filters Installation](https://community.wanikani.com/t/userscript-wanikani-open-framework-additional-filters-recent-lessons-leech-training-related-items-and-more/30512)] [[Self Study Quiz Installation](https://community.wanikani.com/t/userscript-self-study-quiz/13191)] [[Kanji Stroke Order Font](https://www.nihilist.org.uk/Home) ] Download the script here: Descriptio…

The new filter shows in the Item Inspector settings and I can configure it. Item Inspector uses this filter but it seems that there is a bug. Not all items in the list show up in the table. I tried the same configuration with Self-Study Quiz and I have the same bug there too. So it seems to be a problem with the filter itself.

The problematic configuration:

 ![Bug](https://global.discourse-cdn.com/wanikanicommunity/original/4X/9/0/7/90775dc90e9ce0812d966758cc3921c8d5f0925e.png)

Only the radicals ground and gambler and the kanji 一 are shown in the table or used in a quiz. The other two kanji and the vocabulary items don’t show up.

For testing purposes I find that Item Inspector is more convenient than Self-Study Quiz because it displays all items at once on the dashboard. You can see at a glance if something is missing instead of having to run through a quiz.

---

<div class="post-metadata">

**Author:** ![OldBigDog54](https://cdck-file-uploads-global.s3.dualstack.us-west-2.amazonaws.com/wanikanicommunity/original/3X/f/d/fd4c154120954695f788402f3bcf4e616499bc2d.png) [@OldBigDog54](https://community.wanikani.com/u/OldBigDog54)\
**Post date:** [October 2, 2020, 10:59am UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/8 "2020-10-02T10:59:18Z")

</div>

Hi,  
I have just started using the Self Study Quiz app and it all works fine except for the audio. I have toggled the speaker icon to the different colours and nothing. I am using Safari on a Mac. Any ideas. Thanks.

---

<div class="post-metadata">

**Author:** ![rfindley](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rfindley/32/35202_2.png) [@rfindley](https://community.wanikani.com/u/rfindley)\
**Post date:** [October 2, 2020, 7:33pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/9 "2020-10-02T19:33:03Z")

</div>

First, note that you only get audio on Vocabulary.  
Second… just to be 100% sure everything else about your audio is set up correctly, try playing some audio from an item page (such as [[here](https://www.wanikani.com/vocabulary/%E5%A4%A7%E3%81%8D%E3%81%84)]) by clicking on the speaker icon:

![image](https://global.discourse-cdn.com/wanikanicommunity/original/4X/c/5/d/c5dea9c3c22aebce3b3bfdf74f08b1480f41c9f6.png)

Third, open the Javascript console (you’ll have to google how to do that on Mac since I can never remember the process) and see if any errors related to audio files are reported.

---

<div class="post-metadata">

**Author:** ![prouleau](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/prouleau/32/376127_2.png) [@prouleau](https://community.wanikani.com/u/prouleau)\
**Post date:** [October 8, 2020, 6:38pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/10 "2020-10-08T18:38:06Z")

</div>

I have looked at the code and found the bug reported in the post I am replying to. The regex handling the white spaces doesn’t do its job. White spaces are breaking the script. If you replace the `split_list` function with this one it will be OK.

`function split_list(str) {return str.trim().replace(/\s*,\s*/g, ',').split(',').filter(function(name) {return (name.length > 0);});}`

---

<div class="post-metadata">

**Author:** ![rfindley](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rfindley/32/35202_2.png) [@rfindley](https://community.wanikani.com/u/rfindley)\
**Post date:** [October 9, 2020, 8:21pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/11 "2020-10-09T20:21:49Z")

</div>

@prouleau,  
Just fyi, I saw your message, but it’s going to be about a week before I can look at this.  
Thanks for the heads-up!

---

<div class="post-metadata">

**Author:** ![prouleau](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/prouleau/32/376127_2.png) [@prouleau](https://community.wanikani.com/u/prouleau)\
**Post date:** [October 28, 2020, 9:57pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/12 "2020-10-28T21:57:06Z")

</div>

Maybe this is due to your lack of time but I noticed this script hasn’t been updated on greasyfork with the new `split_list()` yet.

---

<div class="post-metadata">

**Author:** ![rfindley](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rfindley/32/35202_2.png) [@rfindley](https://community.wanikani.com/u/rfindley)\
**Post date:** [October 28, 2020, 10:36pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/13 "2020-10-28T22:36:26Z")

</div>

I had it updated on my PC, but missed pushing the update to Greasyfork. It’s updated now.

---

<div class="post-metadata">

**Author:** ![prouleau](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/prouleau/32/376127_2.png) [@prouleau](https://community.wanikani.com/u/prouleau)\
**Post date:** [October 28, 2020, 10:44pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/14 "2020-10-28T22:44:44Z")

</div>

I confirm. i have the new version on my end. Japanese commas work fine.

---

<div class="post-metadata">

**Author:** ![sgsundstrom1s](https://cdck-file-uploads-global.s3.dualstack.us-west-2.amazonaws.com/wanikanicommunity/original/3X/f/d/fd4c154120954695f788402f3bcf4e616499bc2d.png) [@sgsundstrom1s](https://community.wanikani.com/u/sgsundstrom1s)\
**Post date:** [October 5, 2023, 8:38am UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/15 "2023-10-05T08:38:15Z")

</div>

hey there sorry if I missed the answer to this but couldn’t find any filters for this. I want to quiz my entire item list EXCEPT certain items. Is it possible to use this or any other filter in a subtractive way? For example, I would like to put in the filter “大きい”, and then no longer be quizzed on that item.

My end goal here is to remove the items that I personally have already etched into my brain

---

<div class="post-metadata">

**Author:** ![rfindley](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rfindley/32/35202_2.png) [@rfindley](https://community.wanikani.com/u/rfindley)\
**Post date:** [October 5, 2023, 11:00am UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/16 "2023-10-05T11:00:12Z")

</div>

[[Blacklist Filter](https://greasyfork.org/en/scripts/420050-wanikani-blacklist-filter-for-self-study-quiz)]

---

<div class="post-metadata">

**Author:** ![fgolos](https://cdck-file-uploads-global.s3.dualstack.us-west-2.amazonaws.com/wanikanicommunity/original/3X/f/d/fd4c154120954695f788402f3bcf4e616499bc2d.png) [@fgolos](https://community.wanikani.com/u/fgolos)\
**Post date:** [September 20, 2024, 8:05am UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/17 "2024-09-20T08:05:48Z")

</div>

Just wanted to check if this script is no longer working as expected? For example, I am trying to create a filter by setting Vocabulary List to “場所,近所,欠ける”. But instead of returning just 3 items, it comes back with thousands.

 ![Results](https://global.discourse-cdn.com/wanikanicommunity/original/4X/a/7/d/a7d24c769002cb8c2cdcf206f6a669bdab52b517.png)  
 ![Settings](https://global.discourse-cdn.com/wanikanicommunity/original/4X/5/7/b/57b19191e4c6881d956ba78e03b6bda919d4bdb9.png)

---

<div class="post-metadata">

**Author:** ![rfindley](https://sea1.discourse-cdn.com/wanikanicommunity/user_avatar/community.wanikani.com/rfindley/32/35202_2.png) [@rfindley](https://community.wanikani.com/u/rfindley)\
**Post date:** [September 20, 2024, 12:29pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/18 "2024-09-20T12:29:55Z")

</div>

“Vocab List” only applies to vocab, so it’s letting kanji and radicals through. To get just the vocab, select Vocab in the “Item Type” filter.

The reason for that filter allowing kanji and radicals, by the way, is so you can use the Vocab List, Kanji List, and Radical list at the same time.

---

<div class="post-metadata">

**Author:** ![fgolos](https://cdck-file-uploads-global.s3.dualstack.us-west-2.amazonaws.com/wanikanicommunity/original/3X/f/d/fd4c154120954695f788402f3bcf4e616499bc2d.png) [@fgolos](https://community.wanikani.com/u/fgolos)\
**Post date:** [September 20, 2024, 12:54pm UTC](https://community.wanikani.com/t/userscript-item-list-filter-for-self-study-quiz/45595/19 "2024-09-20T12:54:26Z")

</div>

Worked like a charm. Thanks, @rfindley! I can’t believe I didn’t think to try this approach myself 🙂
