Random Jisho Word Widget

iOS 14 widget to display random words from a jisho.org search (e.g. a selected JLPT grade). Powered by jisho.org and Scriptable

What is it?

iOS 14 supports adding more flexible widgets to your home screen. The app Scriptable opens up widget development to all of us, not needing to publish an app to the App Store just to build a widget. This widget is meant to assist Japanese learners by providing an easy way to display Japanese words with their readings and definitions in either a small, medium, or large format for review. Which words are shown can be customized by specifying a search parameter (see details below).

Installation

Installation is done in two steps: copying the script file to your device and then adding a Scriptable widget utilizing the script.

Prerequisites

Scriptable must be installed.

Download the script file

An iOS >Shortcut< is provided to make this easier. It will download the latest script content and place it where Scriptable expects it. Note: If you do not want to enable untrusted Shortcuts (necessary for running any shared ones) you can also do this step by manually copying the contents of RandomJishoWords.js into a new script in Scriptable.

Add a new Widget

Long press the home screen and tap the + button.
Scroll down and select Scriptable as the app for the widget
Choose a size (all three are supported) and select Add Widget
Tap the widget and for Script, select 'Random Jisho Word Widget'
Under Parameter, enter a jisho.org search string. Examples: #jlpt-n1, #jlpt-n3 #common. If not specified, #jlpt-n5 will be used.

Usage

Feel free to adjust the search at any time by modifying the widget and entering a new Parameter. If you'd like to resize the widget, it needs to be removed and re-added. Colors used can be easily changed by modifying the script content inside Scriptable.

jisho.org provides some very interesting and useful tags that you can set as your Parameter to see selected words on your home screen for practice. The full list is here. Some examples I picked that you might try:

#comp Computer terms
#bus Business terms
#counter Counter words
#id Idiomatic expressions
#wasei Wasei, words made in Japan
#station Railway stations
#on-mim Onomatopoeic or mimetic word
#yoji Yojijukugo (four character compound)

Acknowledgments

Many thanks to MaximiliumM for publishing this widget which performs a very similar function. I wanted an app to display a wider variety of words with more open-ended configuration and was able to use their code as a starting point. I also would like to express gratitude to all of the contributors to jisho.org, including its authors and everyone who curates the data it links us to. It is a wonderful tool. If you'd like to access the Jisho.org API yourself you can find a lot of discussion about it here.

okuraku / random-jisho-word-widget Goto Github PK