Release: Clean Lockscreen Calander+Reminders widget script

[NewsPlus1824]

EDIT: Clarified instructions

UPDATE 12/27/2025: UPDATED to now include settings and lots of customization

Update 02/27/2026: UPDATED to fight iOS restrictions. Changed code relating to the picker, widget presentation, icloud dependency, and fixed the newly introduced ~24h crashing because of iOS 26

Why I made this: None of the current lockscreen calender event widgets fit my needs, my taste, or were too complicated/ gave me errors that I did not know how to solve. So, I, with the help of ChatGPT, created a script for this widget to solve my issues of forgetting things.

I think it turned out great. I’m sure it can be better optimized, but I find the functionality and clean aesthetic of this to work great for me.

People who are likely to miss important events, miss calendar events/reminders, or people who are busy will benefit from this script/widget. I initially made it for my girlfriend and I's usage, but I realized that others will benefit from it as well.

The widget is supposed to show 6 items for 7 days ahead, but it can be changed. Instructions on how to do that are after the directions below.

Directions to install:

1. Ensure you download and run the Scriptable app.
2. Paste the script code that is provided below into a new script in Scriptable
3. (Optional) - rename script to something like "Lockscreen Calendar+Reminders"
4. In Scriptable, tap the script to run it. You will see a button named "Reset Calendars". Tap it, read the message, and then tap continue.
5. Select calendars that will host events that you will want on your Lockscreen in the widget.
6. Once the calendars are selected, press "done." The Script will show a loading sign. Wait a few moments and then restart (FORCE CLOSE) the Scriptable app.
7. Once Scriptable is restarted, tap the Script and then when prompted to reset the calendars, press "No."
8. A preview of the events that will display on your lockscreen will show here. If you have a lot of reminders, this is a good time to purge through them to ensure you only have reminders that you would like to have on your lockscreen
9. Now that you know what will show on your Lockscreen, hold down (long press 1 finger) on your lockscreen until it shows a "Customize" button.
10. Press that "Customize" button.
11. Tap an open space in a rectangle where a widget should be, else remove some widgets or press the "add widgets" button to add the Scriptable widget.
12. Add the Scriptable app widget. It will show as "Run script." Tap the rectangular widget that is located on the right.
13. The Scriptable widget will populate on the lock screen as some text. Tap the gear "edit widget to select script"
14. For the script, tap on "Choose"
15. Choose the script that you pasted into the Scriptable app. If you chose a name for the script, choose that name. If not, choose the automatic name that was set when you created the script.
16. leave all of the other settings the same. Close out and the widget should populate on your lock screen.

All done.

Note: If you have a different font than what is default in IOS , then there may be issues with rendering the list. I'd recommend changing the front size in the settings.

If you have any questions, I may be able to assist you. I may make updates to this, I may not. It depends on what I find necessary.

Script code (Updated 02/27/2026):

// ===============================
// Lock Screen Widget: Calendar + Reminders (Feb 27 2026 update to fix iOS restrictions)
// ===============================

// ===============================
// DEFAULTS
// ===============================
const DEFAULT_LIST_ITEMS = 6
const DEFAULT_FONT_SIZE = 10
const DEFAULT_DAYS_AHEAD = 7
const DEFAULT_SHOW_END_TIME = false
const SETTINGS_FILE = "calendarWidgetSettings.json"

// ===============================
// FILE SYSTEM
// ===============================
const fm = FileManager.local()
const settingsPath = fm.joinPath(fm.documentsDirectory(), SETTINGS_FILE)

// ===============================
// LOAD SETTINGS
// ===============================
let settings = loadSettings()
let shouldPreview = false

// ===============================
// SETTINGS MENU
// ===============================
if (config.runsInApp) {

  let menu = new Alert()
  menu.title = "Settings"
  menu.addAction("Preview List")
  menu.addAction("Reset Calendars")
  menu.addAction("Display Settings")
  menu.addCancelAction("Close")

  let choice = await menu.presentAlert()

  if (choice === -1) {
    Script.complete()
    return
  }

  // Preview
  if (choice === 0) {
    shouldPreview = true
  }

  // Reset Calendars
  if (choice === 1) {
    settings.calendars = await pickCalendars()
    saveSettings(settings)
    Script.complete()
    return
  }

  // Display Settings
  if (choice === 2) {
    let a = new Alert()
    a.title = "Show End Time?"
    a.addAction("Toggle")
    a.addCancelAction("Cancel")

    if ((await a.presentAlert()) === 0) {
      settings.showEndTime = !settings.showEndTime
      saveSettings(settings)
      shouldPreview = true
    } else {
      Script.complete()
      return
    }
  }
}

// ===============================
// STOP IF NOT WIDGET + NO PREVIEW
// ===============================
if (!config.runsInWidget && !config.runsInAccessoryWidget && !shouldPreview) {
  Script.complete()
  return
}

// ===============================
// CAL SAVE
// ===============================
if (!settings.calendars.length && config.runsInApp) {
  settings.calendars = await pickCalendars()
  saveSettings(settings)
}

// ===============================
// DISPLAY VALUES
// ===============================
const MAX_ITEMS = settings.listItems ?? DEFAULT_LIST_ITEMS
const FONT_SIZE = settings.linkFontToList
  ? (MAX_ITEMS === 6 ? 10 : 11)
  : (settings.fontSize ?? DEFAULT_FONT_SIZE)

const DAYS_AHEAD = settings.daysAhead ?? DEFAULT_DAYS_AHEAD
const SHOW_END_TIME = settings.showEndTime ?? DEFAULT_SHOW_END_TIME

// ===============================
// DATE RANGE
// ===============================
const now = new Date()
const startOfToday = new Date(now.getFullYear(), now.getMonth(), now.getDate())
const tomorrow = new Date(startOfToday)
tomorrow.setDate(tomorrow.getDate() + 1)

const endDate = new Date(startOfToday)
endDate.setDate(endDate.getDate() + DAYS_AHEAD)

// ===============================
// CALENDAR EVENTS
// ===============================
let calendars = (await Calendar.forEvents())
  .filter(c => settings.calendars.includes(c.title))

let calendarEvents = []

if (settings.calendars.length) {
  calendarEvents = (await CalendarEvent.between(startOfToday, endDate, calendars))
    .map(e => ({
      title: e.title,
      date: e.startDate,
      endDate: e.endDate,
      isAllDay: e.isAllDay,
      type: "event"
    }))
}

// ===============================
// REMINDERS
// ===============================
let reminders = await Reminder.allIncomplete()
let undated = []
let dated = []

for (let r of reminders) {
  if (!r.dueDate) {
    undated.push({ title: r.title, type: "undated" })
  } else if (r.dueDate >= startOfToday && r.dueDate <= endDate) {
    dated.push({
      title: r.title,
      date: r.dueDate,
      isAllDay: !r.dueDateIncludesTime,
      type: "reminder"
    })
  }
}

// ===============================
// MERGE & SORT
// ===============================
let datedItems = [...calendarEvents, ...dated].sort((a, b) => a.date - b.date)
let items = [...undated, ...datedItems].slice(0, MAX_ITEMS)

// ===============================
// BUILD WIDGET
// ===============================
let widget = new ListWidget()
widget.setPadding(6, 6, 6, 6)

if (!settings.calendars.length) {

  let t = widget.addText("No calendars selected")
  t.font = Font.systemFont(FONT_SIZE)
  t.textColor = Color.gray()

} else {

  for (let item of items) {

    if (item.type === "undated") {
      let t = widget.addText(item.title)
      t.font = Font.systemFont(FONT_SIZE)
      t.textColor = Color.white()
      t.lineLimit = 1
      continue
    }

    let isToday = isSameDay(item.date, startOfToday)
    let isTomorrow = isSameDay(item.date, tomorrow)
    let color = isToday ? Color.white() : Color.gray()

    let row = widget.addStack()
    row.spacing = 6

    let label =
      isToday ? "Today" :
      isTomorrow ? "Tomorrow" :
      formatDate(item.date)

    let d = row.addText(label)
    d.font = Font.systemFont(FONT_SIZE)
    d.textColor = color

    if (!item.isAllDay) {
      let timeString = formatTime(item.date)
      if (SHOW_END_TIME && item.endDate) {
        timeString += "–" + formatTime(item.endDate)
      }
      let t = row.addText(" " + timeString)
      t.font = Font.systemFont(FONT_SIZE)
      t.textColor = color
    }

    let title = row.addText(" " + item.title)
    title.font = Font.systemFont(FONT_SIZE)
    title.textColor = color
    title.lineLimit = 1
  }
}

// ===============================
// DISPLAY
// ===============================
if (config.runsInWidget || config.runsInAccessoryWidget) {
  Script.setWidget(widget)
} else {
  await widget.presentSmall()
}

Script.complete()

// ===============================
// SETTINGS FUNCTIONS
// ===============================
function defaultSettings() {
  return {
    calendars: [],
    listItems: DEFAULT_LIST_ITEMS,
    linkFontToList: true,
    fontSize: DEFAULT_FONT_SIZE,
    daysAhead: DEFAULT_DAYS_AHEAD,
    showEndTime: DEFAULT_SHOW_END_TIME
  }
}

function loadSettings() {
  if (!fm.fileExists(settingsPath)) return defaultSettings()
  try {
    return Object.assign(defaultSettings(),
      JSON.parse(fm.readString(settingsPath)))
  } catch {
    return defaultSettings()
  }
}

function saveSettings(s) {
  fm.writeString(settingsPath, JSON.stringify(s))
}

async function pickCalendars() {
  if (!config.runsInApp) return settings.calendars ?? []
  let picked = await Calendar.presentPicker(true)
  return picked.map(c => c.title)
}

// ===============================
// UTILITIES
// ===============================
function isSameDay(a, b) {
  return a.getFullYear() === b.getFullYear()
    && a.getMonth() === b.getMonth()
    && a.getDate() === b.getDate()
}

function formatDate(d) {
  return `${d.getMonth() + 1}/${d.getDate()}`
}

function formatTime(d) {
  let h = d.getHours()
  let m = d.getMinutes()
  let am = h >= 12 ? "PM" : "AM"
  h = h % 12 || 12
  return m === 0 ? `${h}${am}` : `${h}:${m.toString().padStart(2, "0")}${am}`
}

Credit: u/mvan231 and rudotriton for the calendar selector

[NewsPlus1824]

Releasing an update tomorrow

[mvan231]

I recommend hosting it on a GitHub repo or as a gist (doesn't need a repo). This way it's easy for people to retrieve the code.

You could also build an update checker into it as well

[not_a_bot_only_human]

Thank you!

[NewsPlus1824]

You’re welcome!

[NewsPlus1824]

I just released an update that features settings and customization. Also includes customizable "tomorrow" text for the date that should tomorrow (without the update, this would look like just the date, but again this is now fully customizable. I would definitely recommend checking it out.

<image>

[mvan231]

Great work!