Start Here

Installation

Install Scriptable, copy a widget, and get it running in minutes.

Prerequisites

  • iOS 14 or later.
  • Scriptable app from the App Store.
  • Internet access for API-driven widgets.

Install Scriptable

  1. Download Scriptable from the App Store.
  2. Open the app once to allow it to create the Scriptable folder in iCloud Drive.

Add a widget script

  1. Open a widget page and copy the JavaScript file.
  2. In Scriptable, create a new script and paste the code.
  3. Save the script with a clear name.

Add the widget to your home screen

  1. Long-press on the home screen and tap the plus icon.
  2. Search for Scriptable and pick a widget size.
  3. Add the widget, then long-press it and choose Edit Widget.
  4. Set Script to your saved file.
  5. Set When Interacting to Run Script for the best results.

Verify the setup

Open Scriptable and run the script manually. If it renders correctly in the app, it will render correctly on the home screen.

API keys

Some widgets require API keys or tokens. Add them to the script before running the widget, then test in Scriptable first.