Intro
Scriptable is an iOS-only app that, among other things, allows for the creation of custom widgets written with JS.
A few years back, I was inspired by a tweet by Evanbear1 which showed a screenshot containing his own Scriptable widget which displayed the basic analytics of a universe.
After seeing this, I drafted my own Scriptable widget aiming to achieve a similar effect. Since then, I’ve created a few more widgets available at wlft/scriptable on GitHub under the MIT license. See previews and installation details below.
Available Widgets
Universe Stats (Single/V1)
This is the first widget I made in 2023 and it’s straightforward. Requires one universe ID and displays the universe’s name, icon, CCU, current favourites, like rating, as well as its current visits. It does not have full custom error handling.
Universe Stats (Multi/V2)
This widget takes (up to 100) universe IDs and displays the one with the highest CCU count and all of the details as V1.
Total CCU Inline
This Inline Accessory Widget takes 1-100 universe IDs and collects the current CCU from each, adding them up and displaying the sum. This can only be used on the lock screen next to the date, from my recollection.
DevForum Latest Announcements
Comes in two variants. One (announcements_only.js) displays the latest announcement, while the other (all.js) displays the latest update.
This works by collecting the last non-pinned topic from each category.
The all updates widget is the latest.
Installing
instructions from Roblox iOS Widget Installation Guide | Wolfite Gitbook
- Download Scriptable from the App Store on your iOS device.
- Visit the wlft/scriptable on GitHub.
- Find the script you wish to install. For demonstration purposes, this tutorial will use the universe_stats.js script.
- Click ‘raw’ and copy (or click the copy to clipboard button if available) and paste the entire script to your clipboard.
- Open the Scriptable app and tap the plus icon (+) at the top right of the app.
- Paste the code into editor.
- Depending on your selected script, there may be options that require you to edit the script. For example, universe_stats.js has a variable called
universewhich will dictate which universe the widget will target. You can edit this ID in the script to change the behaviour of the widget. - To add the widget to your home screen, close the app and navigate to the page on your home screen that you want your widget on.
- Hold down your screen until you see the ‘Edit’ option.
- Tap ‘Add Widget’.
- Find or search for ‘Scriptable’.
- Add the ideal size of your widget. This depends on which script you’re installing.
- Once you’ve picked the correct size, tap ‘Add Widget’.
- While still editing your home screen, tap the empty widget.
- Under ‘Script’, tap ‘Choose’ and select the script that you just added.
Relevant
- Collection of Roblox iOS Widgets | Wolfite Gitbook
- Roblox iOS Widget Installation Guide | Wolfite Gitbook
- https://scriptable.app/
- Obtain a universe ID from a starter place ID:
https://apis.roblox.com/universes/v1/places/{placeId}/universe
wlft/scriptable is licensed under the MIT license. wlft/scriptable is intended to be a general purpose scriptable repo and may contain non-Roblox specific Scriptable scripts/widgets in the future.
Thanks for reading! Feel free to modify (as permitted under the MIT license).