Scriptable is a shelf of iOS widget scripts, not a library

A collection of standalone scripts rather than a library

The most useful thing to understand about this repository is that it is not a package and not a framework. It is a shelf of self-contained JavaScript files, one per widget, written for the Scriptable app on iOS and macOS. Each entry in the catalogue table is a script file such as ONE-oilprice.js, ONE-NBA.js or ONE-Today.js, and each is meant to be copied into the app and then attached to a home screen widget. There is no build step, no dependency graph, no module system and no test suite. The category list in the table of contents groups the scripts the way the author thinks about them, with automotive, calendar, health, telecom and mobile, music, reading, social, shopping, sports and utilities as the sections. This shape explains both the appeal and the limit. A single script is small enough to read end to end before you trust it on your own home screen, and it is also small enough that when the service it reads changes, nothing upstream will fix it for you.

Installation is a copy and paste, then a widget

There is no install command, and the four step procedure is the whole of it. You download the Scriptable app on your iPhone and keep the system on iOS 14 or newer. Inside the app you tap the plus sign in the top right corner and paste the code of the script you want. Then you long press your home screen, add a widget, choose Scriptable, open the widget settings and pick the script you just saved. The result is a widget that renders whatever the script returns. Two practical consequences follow from this being a manual procedure. First, there is no update channel, so a script that breaks when its upstream data source changes stays broken until you notice and paste a new version yourself. Second, the code you run is whatever happens to be in the file, which makes reading it before you paste it a reasonable habit rather than a paranoid one. The project states that all code is open source and that pull requests are welcome, and it asks for issues or pull requests when a workflow can be improved.

The subscription file and the downloader solve the copy problem

Copying long scripts by hand on a phone is the annoyance the project attacks first. The portfolio section lists three answers. The first is a Select All and Copy iOS Shortcut, described as a way to solve the code copying problem for Scriptable on mobile devices, offered as a download link for anyone who hits the same wall. The second is a Script Subscription, pointing at an install.json file in the repository, which is the mechanism Scriptable uses to let a script install other scripts rather than pasting each one by hand. The third is a Script Downloader, a script that downloads all of the author's scripts at once, stored in the repository as ONE-Download.Enc.js. The Enc in that filename is worth noting, since the file is not the plain script source you would normally expect to read, and the repository root does contain a large set of plainly named script folders alongside it. Which of the three you use depends on how many widgets you want, and the subscription route is the one that also gives you a way to receive updates, since a subscription is re-read by the app.

What is actually on the shelf, topic by topic

The catalogue is specific enough to be worth reading before you install anything. The fuel price script supports real-time queries for all provinces in China. Two scripts cover basketball, with one for NBA live scores and another for NBA schedules and scores, and a third entry covers a Tokyo Olympics medal tally. The music entries pull NetEase Cloud Music hot comments and a music chart. Calendar and time scripts cover a lunar calendar with weather and daily quotes, a plain calendar widget, a countdown widget, a countdown shown as a percentage, a stopwatch and count-up widget, a calendar wallpaper, and a day matter entry in the repository layout. Health has its own calendar script. Two dashboard scripts show follower, download and created-shortcut statistics for a Chinese shortcuts community and its user-facing counterpart. The repository root also holds a COVID-19 vaccination data script for China and the world, a car list, a conversable entry, a quotations entry and a random network image folder. Most of these are built around Chinese-language data endpoints, which is the single most important fact about the collection.

Third-party data sources are the failure point

None of these scripts produces its own data. A fuel price widget, a music chart and a shortcut statistics dashboard all depend on a remote service, and the repository does not describe what happens when that service changes its response, rate limits a client, or disappears. There is no versioning of the upstream contract, no fallback path documented, and no error handling described in the repository. That is not a criticism so much as a description of the risk profile. A script that renders a countdown to a date you care about will keep working for years, because the answer is computed locally. A script that queries a live chart endpoint will fail the day the endpoint changes, and the symptom will be a widget that shows nothing or shows an error rather than a crash, which is the failure mode that gets ignored on a home screen. The topics in the collection also skew toward Chinese services, so a reader elsewhere will find the most interesting scripts unavailable and the least interesting ones, the local time and quote widgets, still fine.

Modified versions of other people's work, configured off GitHub

The portfolio section carries a note that the collection includes original works and modified versions based on other people's work, and it points configuration details at posts on the WeChat Official Account instead of the repository. That is an unusual arrangement and it has two implications. The first is licensing and attribution in the broad sense, since a modified script keeps the shape of someone else's code, and the repository itself is under the MIT licence with a LICENSE file at the root. The second is that a chunk of the practical knowledge about running these scripts lives outside version control, in posts on a messaging platform account. If you want to know which API endpoint a script uses, which token it needs, or which account you have to configure, you may not find it in the file, and the README does not reproduce that information. For a personal widget, that is an acceptable arrangement. For anything you intend to maintain as part of a team, the dependency on scattered posts is a maintenance cost you should price in before you adopt it.

One release tag, and a repository that is mostly content

The maintenance picture is split in two. The release list shows a single tag, V1.0.0 from 2023-04-08, and the last push to the repository was on 2026-08-12, so the content keeps being added even though nothing has been versioned since 2023. That is consistent with what the project is. A tag in this repository would mean very little anyway, since there is no installable artifact: a script is copied from a file, so the useful unit of change is a file diff, and the commit history is the version history. The repository layout reflects the same logic, with a directory per script holding its own files, alongside images/, the install.json subscription, the downloader script, and both an English README and a README_CN.md, since the audience is largely Chinese-speaking. The topic tags on the repository still lead with covid-19 and scriptable-widgets, which reflects the earliest entries rather than the current catalogue. The licence is MIT, so reuse of the scripts themselves is on permissive terms, subject to the usual review of what you are copying from elsewhere.

Editorial conclusion

Adopt this collection if you want a personal iOS or macOS home screen widget for one of the covered topics and you are comfortable pasting JavaScript into the Scriptable app and troubleshooting a script that reads a third-party service. Skip it if you need a supported, versioned widget you can update automatically, or if your data comes from services outside China, since the scripts are written against domestic endpoints. Before you install anything, read the script file itself to see which host it calls, keep the app on iOS 14 or newer, and expect to configure some scripts through the author's WeChat Official Account posts, because the repository does not carry those settings.

Frequently asked questions

Official sources

1. Issues
2. License: MIT
3. Nicolasking007/Scriptable on GitHub
4. README
5. Releases