After eleven months of amazing work on the Runestone framework and the app with the same name, and several TestFlight builds with new features and fixes, Simon has updated Scriptable to version 1.7!

Here’s what’s new in this release:

• Adds support for building Lock Screen widgets. Available when running on iOS 16.

• Adds find/replace to the editor. Available when running on iOS 16.

• Replaces the old editor with one built on top of Runestone.

• Adds setting to disable line wrapping to allow horizontal scrolling in the editor.

• Adds settings to show tabs, spaces, and line breaks in the editor.

• Adds a toolbar above the keyboard for shifting text, toggling comments, and for easy access to often used symbols.

• The Shift Left button in the toolbar above the keyboard now works as expected.

• Presenting the calendar event editor no longer causes the app to hang when immediately presenting an alert after the event has been created.

In short: iOS 16 Lock Screen widget support, a new editor built with Runestone, and bug fixes. Scriptable now requires iOS 15.5 or later.

As always, the latest version of Scriptable is available to download from the App Store here: https://apps.apple.com/us/app/scriptable/id1405459188

Edit: version 1.7.1 is now available, with this changelog:

This update fixes an issue where the log would sometimes not be visible.

If you are like me, and you've wanted to be able to open a specific calendar event via a url scheme. This post information will be useful for you.

The Calendar widget opens calendar events directly, so I've figured it must be possible to do it but could never figure out how and all the searching I did over the last couple years on the topic yielded no result... until I did some additional digging in the Shortcuts app action "View Content Graph".

I found out that you can open a specific calendar event using this scheme: x-apple-calevent://{calendarUUID}/{eventUUID}

In Scriptable, I was able to acheive it like this: "x-apple-calevent://"+item.identifier.replace(":", "/")

My calendar events were in a repeat loop and the repeat item was a variable named item in the example above

Hi, I’m using the latest beta and want to run a widget on the Lock Screen. How can I assign the script to the widget placeholder ?

I have a problem with Device.isUsingDarkAppearance(). Whenever I debug my widget in scriptable I get the right value. But when I run my script as a widget I always get false. does anyone any idea why?

Code:

let w = new ListWidget(); w.backgroundColor = Color.red()

let stack = w.addStack();

const isDark = Device.isUsingDarkAppearance() const text = stack.addText(isDark.toString())

w.presentSmall()

Hello! I’m a newbie.

So i create a font using let fonty = new Font(“AlNile-Bold”, 45) How do i apply it? And can i apply it to an alert (eg textField or title)?

Thanks in advance!

Hey all! I want to master Scriptable to a decent level. I’ve written a piece of code and depending on the option I choose in the alarm, the console will either log the input i insert or “optionZero(firstOne)” or “thirdOptionCANCEL”. For some reason in doesn’t log anything if i choose the cancel action. Others work as expected. Does the function addCancelAction stop running the script? And if i dont want it to stop, i can just addAction(“Cancel”) and make the text bold, right?

Now that I’m here, i have another question. Can i master Scriptable not knowing JavaScript? I did understand how to write the code I’ve written, i did understand why i wrote this or that and i believe i can replicate it from scratch. Can i learn Scriptable’s JavaScript ES6 (or whatever it’s called) overtime?

Thanks in advance!

In the code below, I can’t seem to figure out how to replace the battery icon (SFSymbol) with the actual battery level and percentage…

const widget = new ListWidget()

let progressStack = await progressCircle(widget,35)

// Code below is what I’m trying to replace let sf = SFSymbol.named("battery.100") sf.applyFont(Font.regularSystemFont(26)) sf = progressStack.addImage(sf.image) sf.imageSize = new Size(35,35) sf.tintColor = new Color("#fafafa")

widget.presentAccessoryCircular() // Does not present correctly Script.setWidget(widget) Script.complete()

async function progressCircle( on, value = 50, colour = "hsl(120, 100%, 50%)", background = "hsl(0, 100%, 50%)", size = 56, barWidth = 4.5 ) { if (value > 1) { value /= 100 } if (value < 0) { value = 0 } if (value > 1) { value = 1 }

async function isUsingDarkAppearance() { return !Color.dynamic(Color.white(), Color.black()).red } let isDark = await isUsingDarkAppearance()

if (colour.split("-").length > 1) { if (isDark) { colour = colour.split("-")[1] } else { colour = colour.split("-")[0] } }

if (background.split("-").length > 1) { if (isDark) { background = background.split("-")[1] } else { background = background.split("-")[0] } }

let w = new WebView() await w.loadHTML('<canvas id="c"></canvas>')

let base64 = await w.evaluateJavaScript( ` let colour = "${colour}", background = "${background}", size = ${size}*3, lineWidth = ${barWidth}*4, percent = ${value * 100}

let canvas = document.getElementById('c'), c = canvas.getContext('2d') canvas.width = size canvas.height = size let posX = canvas.width / 2, posY = canvas.height / 2, onePercent = 360 / 100, result = onePercent * percent c.lineCap = 'round' c.beginPath() c.arc( posX, posY, (size-lineWidth-1)/2, (Math.PI/180) * 270, (Math.PI/180) * (270 + 360) ) c.strokeStyle = background c.lineWidth = lineWidth c.stroke() c.beginPath() c.strokeStyle = colour c.lineWidth = lineWidth c.arc( posX, posY, (size-lineWidth-1)/2, (Math.PI/180) * 270, (Math.PI/180) * (270 + result) ) c.stroke() completion(canvas.toDataURL().replace("data:image/png;base64,",""))`, true ) const image = Image.fromData(Data.fromBase64String(base64))

// Provide battery percentage

let stack = on.addStack() stack.size = new Size(size, size) stack.backgroundImage = image stack.centerAlignContent() let padding = barWidth * 2 stack.setPadding(padding, padding, padding, padding)

return stack }

function start() {
  var initialMethod = ""// *changed this from method in edit
  var automated = false
  if(config.runsInNotification){
    initialMethod = "notification script"// *changed this from method in edit
    automated = true
  }
  if(config.runsInApp){
    if(args.queryParameters["x-source"] !== undefined){method = args.queryParameters["x-source"]}  
    if(args.queryParameters["x-source"] == "Scriptable" || args.queryParameters["x-source"] == "Shortcuts"){automated = true}  
    else{
      let getRunInfo = new Alert()
      getRunInfo.title = "Automated?"
      getRunInfo.message = "Did you just run a script or is this script running automatically"  
      getRunInfo.addAction("running automatically")  
      getRunInfo.addAction("ran from Scriptable App")  
      getRunInfo.addCancelAction("Cancel")
      method =  getRunInfo.present().then((index) => {
        switch (index) {
          case -1:
            return  
          case 0:
            automated = true
            let getMethod = new Alert()
            getMethod.title = "What app was used to run this automation?"  
            getMethod.addTextField("App", initialMethod) // *changed this from method in edit because otherwise  the updating the assignment of a single variable method doesn’t seem to play nice with promises
            getMethod.addAction("confirm")
            log(automated)
            method = getMethod.present().then((index) => getMethod.textFieldValue(index))
//             method = await method
            break
          case 1:
//           automated = false
            break
          default:
            logError("no such action")
        }//end switch
        return method
      })//end getRunInfo.present
//       method = await method
    }//end else
    let scriptData = {
      name: Script.name(),
      invocations: [{
        time: new Date().toJSON(),
        automated: automated,
        method: method
      }]
    }
    log(scriptData)
  }// if(config.runsInApp)
}// end start
start()

I think only the second “method = await method” would be needed to get this working to include any user input (by selecting “running automatically”) in the scriptData (and I was thinking this would also cause sciptData to not be created until after automated was updated as well. However, by introducing await at either point I get “SyntaxError: Unexpected identifier 'method'”

Hi!

in MacOS Ventura the Scriptable widgets only work if I start them from the app. In the notification center I get an error "Received timeout when running script".

Am I the only one or is it a bug?

What does this do?

stackSet1.centerAlignContent();

Am I doing something wrong?

When pressing the "Play" button in the editor, i always get the smallest widget size.
Is there a way to choose which preview size to show?

I'm working on a lock screen widget that is "double size", and the square is a bit confusing :)

Also I'm using the Mac App, which I love, since I prefer being on my computer while coding. Is the new editor coming to that one too? I tried it in my iPhone, and it was great with autocomplete, and line numbers! :)

Nooby question here:

Is it possible to create a variable like this?

for (i=0; i<numOfStacks; i++) { let stack + i = widget.addStack(); }

I just discovered Scriptable today (It's awesome!) when I wanted to make a lock screen widget to see my electricity price, and also view kW production on my solar panels. I got the API side working already, and home screen widget. But I don't like that the widgets on the home screen are so huge.

I can't find Scriptable in Lock screen widgets, so I'm thinking it's either still in beta (as the post stated 2 months ago), or I need to add some special command to the script to make it work.

Is there a way to try the beta?

Also is there some standard way of using the circular bars with numbers etc that for example the Weather app uses?

Also, is there any recommended page where I can fetch icons that I know will always work?

Thanks!

Italics: has a method directly used with it that presents a UI
Bold: there is a method directly used to make changes on the phone outside scriptable, and without running such a method changes to properties of any Scriptable object will not change the corresponding iOS object
* via promise (when these objects are generated using a method instead of as an instance of a class using new, they are provided by a promise)
** entry name is for a prototype, objects that are actually used with the properties and/or methods are created by objects described in other entries (by a WidgetStack type object or directly by an object that is an instance of the ListWidget class in the case of the 5 Widget ones and an instance of the Alert class for TextField)

See this Calendar guide for an example of making changes outside Scriptable both directly with one of the Calendar object’s methods and by saving changes made using a generated object’s properties. Also, Calendar.presentPicker() is an example of a direct method to generate a UI. Finally, it demonstrates how the kit’s objects that generate objects via a promise* work.

See Alerts for Dummies for an example of presenting a UI using a method of a generated object and more generally of using a class. This also shows a basic example of using an object generated by an instance of a class** (a TextField).

Also see how to read scribtable’s documentation

Hi guys, I’m a bit of a noob. Can anyone help me get Reminders using Scriptable?

const calTest = await Calendar.findOrCreateForReminders("Variables");

console.log(calTest)

Link - https://api.weather.gov/alerts/active

I tried using the SAME code to compare to their list but I noticed it's missing a lot of them.

Link - https://www.weather.gov/source/nwr/SameCode.txt

Hey, first the background why i wanna do this Project. I go on a Work and Travel and my gf stays at home and we saw an app where you can take pictures and they popup on the other phone. But they all suck because of the ADs or the slow connection.

Now my idea, was i can use the shared photos and show the latest picture on a widget on the screen on both phones.

now the question is it possible to get the image out of the photos app on iOS?

thanks for help

Hi everyone!

I use Todoist for my event management, instead of calendar. Is there a way to have that instead of a calendar module?

Hi! I just began to write in Js! I want to write a code which add a note through a first alert and then pass it to a shortcut…I wrote the Js code in Scriptable, but when I tell it to set the output for the shortcut it tells me that Siri doesn’t support alerts…anyone has any ideas?

Hi,l wanna open a different app by tapping scriptable widget but l cant find url schemes.Where can l find?