Asteria · widgets

The sky, on your home screen.

Asteria's engines, compressed to a glance: the Moon, today's transit, the live sky, the planetary hour, the retrograde board, your signature, void timing, the next lunation, your profection year, the progressed Moon, and the next eclipse that hits your chart. Live previews below; each installs in about a minute and refreshes itself from the sky.

The Moon

Phase, sign, and the void-of-course window: the one dial worth checking before you plan anything.

Get the Moon widget on your phone

Supports lock-screen circular and inline sizes on iOS 16 and later.

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · moon
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/moon.json"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-moon.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: the Moon ---------------------------------------------------
function phaseImage(sizePx, mono) {
  const ctx = new DrawContext()
  ctx.size = new Size(sizePx, sizePx)
  ctx.opaque = false
  ctx.respectScreenScale = true
  const r = sizePx / 2 - 2
  const c = sizePx / 2
  const f = Math.max(0, Math.min(1, (D.phase.illumination || 0) / 100))
  const fill = mono ? Color.white() : new Color(T.surface)
  const lit = mono ? Color.white() : new Color(T.gold)
  const shadow = mono ? new Color("#000000", 0.55) : new Color(T.bg)
  ctx.setFillColor(fill)
  ctx.fillEllipse(new Rect(c - r, c - r, r * 2, r * 2))
  if (f > 0.02) {
    ctx.setFillColor(lit)
    ctx.fillEllipse(new Rect(c - r, c - r, r * 2, r * 2))
    if (f < 0.98) {
      // shadow disc slides off toward the dark limb (approximation)
      const dx = 2 * r * f
      const sx = D.phase.waxing ? c - dx : c + dx
      ctx.setFillColor(shadow)
      ctx.fillEllipse(new Rect(sx - r, c - r, r * 2, r * 2))
    }
  }
  ctx.setStrokeColor(mono ? Color.white() : new Color(T.ink_soft))
  ctx.setLineWidth(1)
  ctx.strokeEllipse(new Rect(c - r, c - r, r * 2, r * 2))
  return ctx.getImage()
}

if (fam === "accessoryCircular") {
  w.backgroundColor = new Color("#000000", 0)
  w.setPadding(4, 4, 4, 4)
  const mid = w.addStack()
  mid.addSpacer()
  const img = mid.addImage(phaseImage(56, true))
  img.imageSize = new Size(56, 56)
  mid.addSpacer()
} else if (fam === "accessoryInline") {
  w.backgroundColor = new Color("#000000", 0)
  w.setPadding(0, 0, 0, 0)
  const line = w.addText(D.line || ("Moon in " + D.sign))
  line.font = Font.mediumSystemFont(12)
  line.textColor = Color.white()
} else if (fam === "medium") {
  eyebrow("The Moon")
  w.addSpacer(6)
  const row = w.addStack()
  row.centerAlignContent()
  const img = row.addImage(phaseImage(64, false))
  img.imageSize = new Size(64, 64)
  row.addSpacer(14)
  const col = row.addStack()
  col.layoutVertically()
  const title = col.addText("Moon in " + D.sign)
  title.font = new Font("Georgia", 20)
  title.textColor = new Color(T.ink)
  col.addSpacer(4)
  const meta = col.addText(D.phase.name + " · " + D.phase.illumination
    + "% · " + (D.phase.waxing ? "waxing" : "waning"))
  meta.font = new Font("Menlo", 10)
  meta.textColor = new Color(T.ink_soft)
  col.addSpacer(4)
  const voidLine = col.addText(D.void.line.charAt(0).toUpperCase()
    + D.void.line.slice(1))
  voidLine.font = new Font("Menlo", 10)
  voidLine.textColor = new Color(T.gold)
  if (D.next_phase && D.next_phase.name) {
    col.addSpacer(4)
    const nxt = col.addText("Next: " + D.next_phase.name + " in "
      + D.next_phase.sign + " · " + D.next_phase.when_local)
    nxt.font = new Font("Menlo", 9)
    nxt.textColor = new Color(T.ink_faint)
  }
} else {
  eyebrow("The Moon")
  w.addSpacer(4)
  const mid = w.addStack()
  mid.addSpacer()
  const img = mid.addImage(phaseImage(56, false))
  img.imageSize = new Size(56, 56)
  mid.addSpacer()
  w.addSpacer(6)
  const title = w.addText(D.sign + " " + D.degree + "\u00b0")
  title.font = new Font("Georgia", 16)
  title.textColor = new Color(T.ink)
  title.centerAlignText()
  w.addSpacer(2)
  const meta = w.addText(D.phase.illumination + "% · " + D.void.line)
  meta.font = new Font("Menlo", 8)
  meta.textColor = new Color(T.ink_faint)
  meta.centerAlignText()
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Transit of the day

The aspect carrying the most weight on Frida's chart right now, with the feeling it brings.

Get the Transit widget on your phone

No chart is loaded, so this script previews with the reference chart. Cast or open your chart first and reload this page to key the widget to you.

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · transit
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/transit.json?chart=ref:frida-kahlo"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-transit.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: transit of the day -----------------------------------------
if (D.quiet) {
  eyebrow("Today · " + D.subject)
  w.addSpacer()
  const q = w.addText("The sky is quiet on your chart today.")
  q.font = new Font("Georgia-Italic", 13)
  q.textColor = new Color(T.ink_soft)
  q.centerAlignText()
  w.addSpacer()
} else {
  const t = D.top[0]
  if (fam === "medium") {
    eyebrow("Today on " + D.subject + "'s chart")
    w.addSpacer(8)
    const title = w.addText(t.transiting_name + " " + t.aspect
      + " natal " + t.natal_name)
    title.font = new Font("Georgia", 18)
    title.textColor = new Color(T.ink)
    w.addSpacer(4)
    const meta = w.addText("orb " + t.orb + "\u00b0 · " + t.direction
      + (t.severity === "notable" ? " · notable" : ""))
    meta.font = new Font("Menlo", 9)
    meta.textColor = new Color(T.ink_faint)
    w.addSpacer(8)
    const feel = w.addText(t.feeling)
    feel.font = new Font("Georgia-Italic", 12)
    feel.textColor = new Color(T.ink_soft)
    feel.lineLimit = 2
  } else {
    eyebrow("Today · " + D.subject)
    w.addSpacer()
    const name = w.addText(t.transiting_name)
    name.font = new Font("Georgia", 15)
    name.textColor = new Color(T.ink)
    name.centerAlignText()
    const rest = w.addText(t.aspect + " " + t.natal_name)
    rest.font = new Font("Georgia", 13)
    rest.textColor = new Color(T.ink_soft)
    rest.centerAlignText()
    w.addSpacer(6)
    const meta = w.addText("orb " + t.orb + "\u00b0 · " + t.direction)
    meta.font = new Font("Menlo", 8)
    meta.textColor = new Color(T.ink_faint)
    meta.centerAlignText()
    w.addSpacer()
  }
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Sky now

Every planet's sign and degree in the shared sky, with the three tightest aspects of the moment.

Get the Sky now widget on your phone

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · sky
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/sky.json"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-sky.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: sky now ----------------------------------------------------
eyebrow("Sky now")
w.addSpacer(6)
const bodies = D.bodies || []
if (fam === "large") {
  // two columns of five
  const row = w.addStack()
  row.layoutHorizontally()
  const left = row.addStack()
  left.layoutVertically()
  const right = row.addStack()
  right.layoutVertically()
  bodies.forEach(function(b, i) {
    const col = i < 5 ? left : right
    const rx = b.retrograde ? " ℞" : ""
    const line = col.addText(b.name + " · " + b.sign + " "
      + b.degree + "\u00b0" + rx)
    line.font = new Font("Menlo", 11)
    line.textColor = new Color(T.ink)
    col.addSpacer(3)
  })
  w.addSpacer(10)
  const aspects = D.aspects || []
  aspects.slice(0, 3).forEach(function(a) {
    const line = w.addText(a.a_name + " " + a.aspect + " " + a.b_name
      + " · orb " + a.orb + "\u00b0")
    line.font = new Font("Menlo", 10)
    line.textColor = new Color(T.ink_soft)
    w.addSpacer(2)
  })
} else {
  // medium: compact two-column grid
  const row = w.addStack()
  const left = row.addStack()
  left.layoutVertically()
  const right = row.addStack()
  right.layoutVertically()
  bodies.forEach(function(b, i) {
    const col = i < 5 ? left : right
    const rx = b.retrograde ? " ℞" : ""
    const line = col.addText(b.name + " · " + b.sign + " "
      + b.degree + "\u00b0" + rx)
    line.font = new Font("Menlo", 10)
    line.textColor = new Color(T.ink)
    col.addSpacer(2)
  })
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Planetary hour

The classical hour ruling this moment at your place: who holds the clock, and who holds the next.

Get the Planetary hour widget on your phone

Without a chart this uses a city near your timezone. Load a chart to key the hours to your place.

Supports the lock-screen circular size on iOS 16 and later.

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · hour
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/hour.json"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-hour.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: planetary hour ---------------------------------------------
if (fam === "accessoryCircular") {
  w.backgroundColor = new Color("#000000", 0)
  w.setPadding(2, 2, 2, 2)
  const init = (D.planet || "?").charAt(0)
  const t = w.addText(init)
  t.font = Font.boldSystemFont(22)
  t.textColor = Color.white()
  t.centerAlignText()
  const sub = w.addText("hour")
  sub.font = Font.mediumSystemFont(9)
  sub.textColor = Color.white()
  sub.centerAlignText()
} else {
  eyebrow("Planetary hour")
  w.addSpacer(8)
  const title = w.addText("Hour of " + D.planet)
  title.font = new Font("Georgia", 18)
  title.textColor = new Color(T.ink)
  title.centerAlignText()
  w.addSpacer(6)
  const win = w.addText(D.start_local + " to " + D.end_local)
  win.font = new Font("Menlo", 11)
  win.textColor = new Color(T.ink_soft)
  win.centerAlignText()
  if (D.next_planet) {
    w.addSpacer(8)
    const nxt = w.addText("Next: " + D.next_planet + " at "
      + D.next_start_local)
    nxt.font = new Font("Menlo", 9)
    nxt.textColor = new Color(T.ink_faint)
    nxt.centerAlignText()
  }
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Retrograde board

Mercury, Venus, and Mars: who is turning back, and when they station direct again.

Get the Retrograde board widget on your phone

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · retro
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/retro.json"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-retro.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: retrograde board -------------------------------------------
eyebrow("Retrogrades")
w.addSpacer(6)
const count = D.count || 0
const retro = D.retro || []
if (fam === "medium") {
  if (retro.length) {
    retro.forEach(function(r) {
      const line = w.addText(r.name + " ℞ · direct " + r.direct_local)
      line.font = new Font("Georgia", 15)
      line.textColor = new Color(T.ink)
      w.addSpacer(4)
    })
  } else {
    const all = w.addText("All direct")
    all.font = new Font("Georgia-Italic", 16)
    all.textColor = new Color(T.ink)
    if (D.next_station) {
      w.addSpacer(6)
      const ns = w.addText(D.next_station.name + " stations "
        + D.next_station.when_local)
      ns.font = new Font("Menlo", 11)
      ns.textColor = new Color(T.ink_soft)
    }
  }
} else {
  const head = w.addText(count ? (count + " retrograde") : "All direct")
  head.font = new Font("Georgia", 18)
  head.textColor = new Color(T.ink)
  head.centerAlignText()
  w.addSpacer(6)
  if (retro.length) {
    const names = retro.map(function(r) { return r.name }).join(" · ")
    const n = w.addText(names)
    n.font = new Font("Menlo", 11)
    n.textColor = new Color(T.gold)
    n.centerAlignText()
  } else if (D.line) {
    const line = w.addText(D.line)
    line.font = new Font("Menlo", 9)
    line.textColor = new Color(T.ink_faint)
    line.centerAlignText()
    line.lineLimit = 2
  }
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Your signature

The dominant planet times the signature element on Frida's chart: the short name for the whole shape.

Get the Signature widget on your phone

No chart is loaded, so this script previews with the reference chart. Cast or open your chart first and reload this page to key the widget to you.

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · signature
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/signature.json?chart=ref:frida-kahlo"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-signature.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: your signature ---------------------------------------------
eyebrow("Your signature")
w.addSpacer(8)
const title = w.addText(D.title || (D.planet + " × " + D.element_name))
title.font = new Font("Georgia", 20)
title.textColor = new Color(T.ink)
title.centerAlignText()
w.addSpacer(4)
if (D.tag) {
  const tag = w.addText(D.tag)
  tag.font = new Font("Menlo", 10)
  tag.textColor = new Color(T.gold)
  tag.centerAlignText()
}
if (fam === "large" && D.feeling) {
  w.addSpacer(12)
  const feel = w.addText(D.feeling)
  feel.font = new Font("Georgia-Italic", 13)
  feel.textColor = new Color(T.ink_soft)
  feel.lineLimit = 6
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Void of course

Whether the Moon is void right now, and when that window opens or closes. The timing dial for starts.

Get the Void of course widget on your phone

Supports lock-screen inline on iOS 16 and later.

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · void
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/void.json"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-void.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: void of course ---------------------------------------------
if (fam === "accessoryInline") {
  w.backgroundColor = new Color("#000000", 0)
  w.setPadding(0, 0, 0, 0)
  const line = w.addText(D.line || D.headline)
  line.font = Font.mediumSystemFont(12)
  line.textColor = Color.white()
} else if (fam === "medium") {
  eyebrow("Void of course")
  w.addSpacer(8)
  const head = w.addText(D.headline || (D.is_void ? "Void of course" : "In course"))
  head.font = new Font("Georgia", 22)
  head.textColor = new Color(D.is_void ? T.gold : T.ink)
  w.addSpacer(6)
  const when = w.addText((D.until_rel || "") + " · " + (D.until_local || ""))
  when.font = new Font("Menlo", 12)
  when.textColor = new Color(T.ink_soft)
  w.addSpacer(6)
  const detail = w.addText(D.is_void
    ? ("Into " + (D.next_sign || ""))
    : ("Next void into " + (D.next_sign || "")))
  detail.font = new Font("Menlo", 10)
  detail.textColor = new Color(T.ink_faint)
} else {
  eyebrow("Void")
  w.addSpacer()
  const head = w.addText(D.headline || "In course")
  head.font = new Font("Georgia", 18)
  head.textColor = new Color(D.is_void ? T.gold : T.ink)
  head.centerAlignText()
  w.addSpacer(6)
  const rel = w.addText(D.until_rel || "")
  rel.font = new Font("Menlo", 12)
  rel.textColor = new Color(T.ink_soft)
  rel.centerAlignText()
  w.addSpacer(4)
  const loc = w.addText(D.until_local || "")
  loc.font = new Font("Menlo", 9)
  loc.textColor = new Color(T.ink_faint)
  loc.centerAlignText()
  w.addSpacer()
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Next lunation

The next New or Full Moon: sign, countdown, and the one after that.

Get the Next lunation widget on your phone

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · lunation
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/lunation.json"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-lunation.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: next lunation ----------------------------------------------
eyebrow(fam === "medium" ? "Next lunation" : "Lunation")
w.addSpacer(8)
const name = w.addText(D.name || "Lunation")
name.font = new Font("Georgia", fam === "medium" ? 22 : 16)
name.textColor = new Color(T.ink)
if (fam !== "medium") name.centerAlignText()
w.addSpacer(4)
const sign = w.addText("in " + (D.sign || ""))
sign.font = new Font("Georgia", 14)
sign.textColor = new Color(T.ink_soft)
if (fam !== "medium") sign.centerAlignText()
w.addSpacer(6)
const when = w.addText((D.when_rel || "") + " · " + (D.when_local || ""))
when.font = new Font("Menlo", 11)
when.textColor = new Color(T.gold)
if (fam !== "medium") when.centerAlignText()
if (fam === "medium" && D.next && D.next.name) {
  w.addSpacer(8)
  const nxt = w.addText("Then: " + D.next.name + " in " + D.next.sign
    + " · " + D.next.when_local)
  nxt.font = new Font("Menlo", 9)
  nxt.textColor = new Color(T.ink_faint)
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Year profection

The house of Frida's year, the planet that rules it, and this month's profection turn.

Get the Year profection widget on your phone

No chart is loaded, so this script previews with the reference chart. Cast or open your chart first and reload this page to key the widget to you.

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · profection
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/profection.json?chart=ref:frida-kahlo"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-profection.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: year profection --------------------------------------------
eyebrow("Profection · " + (D.subject || ""))
w.addSpacer(8)
const head = w.addText(D.house + "th-house year")
head.font = new Font("Georgia", fam === "medium" ? 22 : 17)
head.textColor = new Color(T.ink)
if (fam !== "medium") head.centerAlignText()
w.addSpacer(4)
const lord = w.addText((D.lord || "") + " rules · " + (D.topic || ""))
lord.font = new Font("Menlo", 11)
lord.textColor = new Color(T.ink_soft)
if (fam !== "medium") lord.centerAlignText()
if (fam === "medium" && D.month && D.month.house) {
  w.addSpacer(8)
  const m = w.addText("Month: " + D.month.house + "th · "
    + D.month.lord + " · " + (D.month.topic || ""))
  m.font = new Font("Menlo", 10)
  m.textColor = new Color(T.ink_faint)
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Progressed Moon

Where the secondary progressed Moon sits on Frida's chart: the slow personal weather.

Get the Progressed Moon widget on your phone

No chart is loaded, so this script previews with the reference chart. Cast or open your chart first and reload this page to key the widget to you.

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · progressed-moon
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/progressed-moon.json?chart=ref:frida-kahlo"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-progressed-moon.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: progressed moon --------------------------------------------
eyebrow("Prog. Moon · " + (D.subject || ""))
w.addSpacer(8)
const head = w.addText((D.sign || "") + " " + (D.degree || "") + "\u00b0")
head.font = new Font("Georgia", fam === "medium" ? 22 : 17)
head.textColor = new Color(T.ink)
if (fam !== "medium") head.centerAlignText()
w.addSpacer(4)
const meta = w.addText("House " + D.house + " · " + (D.phase || ""))
meta.font = new Font("Menlo", 11)
meta.textColor = new Color(T.ink_soft)
if (fam !== "medium") meta.centerAlignText()
if (fam === "medium" && D.phase_theme) {
  w.addSpacer(8)
  const theme = w.addText(D.phase_theme)
  theme.font = new Font("Georgia-Italic", 12)
  theme.textColor = new Color(T.ink_soft)
  theme.lineLimit = 2
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

Next eclipse

The next eclipse that aspects Frida's chart, with the hit and the countdown.

Get the Next eclipse widget on your phone

No chart is loaded, so this script previews with the reference chart. Cast or open your chart first and reload this page to key the widget to you.

The script URL accepts &theme=<name> for any of the 17 site themes (midnight, parchment, and the rest).

Install the free Scriptable app from the App Store.
Open Scriptable, tap +, and paste the script below. Name it anything.
Long-press your home screen, tap +, and add a Scriptable widget in the size you want.
Tap the new widget, choose your script, and you are done. It refreshes itself from the sky.

// Asteria widget · eclipse
// From heyasteria.com/widgets. Paste into a new Scriptable script,
// add a Scriptable widget to your home screen, choose this script.

const API = "https://heyasteria.com/api/widget/eclipse.json?chart=ref:frida-kahlo"
const tz = encodeURIComponent(Intl.DateTimeFormat().resolvedOptions().timeZone)
const url = API + (API.includes("?") ? "&" : "?") + "tz=" + tz
const fm = FileManager.local()
const cachePath = fm.joinPath(fm.cacheDirectory(), "asteria-eclipse.json")

async function load() {
  try {
    const r = new Request(url)
    const j = await r.loadJSON()
    if (j && j.error) throw new Error(j.error)
    fm.writeString(cachePath, JSON.stringify(j))
    return j
  } catch (e) {
    if (fm.fileExists(cachePath)) return JSON.parse(fm.readString(cachePath))
    throw e
  }
}

const env = await load()
const T = env.theme
const D = env.data
const w = new ListWidget()
w.backgroundColor = new Color(T.bg)
w.setPadding(14, 14, 12, 14)
w.refreshAfterDate = new Date(Date.now() + (env.ttl || 900) * 1000)
const fam = config.widgetFamily || "small"

function eyebrow(text) {
  const e = w.addText(text.toUpperCase())
  e.font = new Font("Menlo-Bold", 8)
  e.textColor = new Color(T.gold)
  return e
}

// --- draw: next eclipse -----------------------------------------------
eyebrow("Eclipse · " + (D.subject || ""))
w.addSpacer(8)
if (D.quiet) {
  const q = w.addText("No personal eclipse nearby.")
  q.font = new Font("Georgia-Italic", 13)
  q.textColor = new Color(T.ink_soft)
  q.centerAlignText()
} else {
  const name = w.addText(D.name || "Eclipse")
  name.font = new Font("Georgia", fam === "medium" ? 20 : 15)
  name.textColor = new Color(T.ink)
  if (fam !== "medium") name.centerAlignText()
  w.addSpacer(4)
  const meta = w.addText("in " + (D.sign || "") + " · " + (D.when_rel || ""))
  meta.font = new Font("Menlo", 11)
  meta.textColor = new Color(T.gold)
  if (fam !== "medium") meta.centerAlignText()
  w.addSpacer(6)
  const hit = w.addText((D.aspect || "") + " natal " + (D.natal_name || ""))
  hit.font = new Font("Georgia-Italic", 12)
  hit.textColor = new Color(T.ink_soft)
  if (fam !== "medium") hit.centerAlignText()
}

if (config.runsInWidget) {
  Script.setWidget(w)
} else if (fam === "large") {
  await w.presentLarge()
} else if (fam === "medium") {
  await w.presentMedium()
} else {
  await w.presentSmall()
}
Script.complete()

How this works: iPhone home-screen widgets need a native app, and Asteria's is on the roadmap. Until then these run through Scriptable, a free and widely used widget runner: the script fetches a small JSON summary from Asteria and draws it on your home screen. Chart widgets carry a private token that serves computed lines only, never your birth data; you can revoke it any time by deleting the chart. When the native app ships, the same widgets come with it.

does this land for you? tell me · your read shapes the next build.