HomeTab

Widgets

A widget is a block you define yourself, without code: a data source (a web address that returns JSON, an RSS/Atom feed, an iCalendar file or plain text), a refresh interval, inputs that become fields in the block dialog, and a template written in Markdown with placeholders. HomeTab fetches the source, fills the template and shows the result in the notes look, so a widget follows the theme and can use the notes styles (card, sticky note, paper…).

The built-in library is nothing but such definitions: Weather, Sunrise & sunset, Air quality, Earthquakes, Calendar, Public holidays, Rocket launches, Headlines from a feed, Hacker News, Wikipedia today, xkcd, Exchange rates, Crypto prices, Stock quote, Crypto fear & greed, GitHub repository, Quote of the day, Dad joke and Photo of the day, all from sources that need no API key. Open a widget block's settings and unfold Definition to see theirs, change them, or paste one you were given. The text in that field is the widget: copy it to share it. The library lives in widget-library.js; a new entry there is a new widget in the dialog.

A definition

{
  "name": "GitHub",
  "inputs": {
    "repo": { "label": "Repository", "type": "text", "required": true, "hint": "owner/name" }
  },
  "source": { "url": "https://api.github.com/repos/{repo}", "type": "json" },
  "refresh": "1h",
  "template": "### [{{full_name}}]({{html_url}})\n⭐ {{stargazers_count | number}} · pushed {{pushed_at | relative}}"
}
FieldMeaning
nameDefault title of the block.
inputsFields shown in the block dialog, keyed by name (letters, digits, _, -). Each has a label, a type (text, number, url or select with options), an optional default, hint and required. options are strings or { "value", "label" } objects.
sourceOptional. url with {input} placeholders, type (json, rss, ics, text, or auto to sniff the response), for JSON an optional path to a part of the response (data.items), and for ICS an optional days (how far ahead to look, default 60, a number or an {input}). Without a source the template renders from the inputs, the location and the time alone.
refreshHow long a fetched response is reused: 5m, 30m (the default), 2h, up to 24h.
mapsOptional lookup tables for the map filter: { "weather": { "0": "Clear ☀️" } }.
formatmarkdown (the default) or html, see HTML templates below.
templateMarkdown or HTML with placeholders, see below.

The address may also use {today.year}, {today.month}, {today.day} (two digits) and {today.date} (YYYY-MM-DD) for APIs that take the date in the URL, as the Wikipedia widget does; the cache then rolls over at midnight.

A default may refer to the location the block sits in: {location.lat}, {location.lng} and {location.name}. That is how the Weather widget follows the location's position; when the location has none and the field is empty, the block says so instead of calling the API.

Values typed into inputs are URL-encoded when inserted into source.url, except that slashes are kept (so owner/name works in a path) and an input of type url is inserted as it is. The whole address may come from a url input: "url": "{url}".

What the source gives the template

Besides the data, every template can use inputs.<name>, location.name, location.lat, location.lng and now. Inside a loop, write page.location.name (items often have a location of their own); inputs, now and data (the whole response) work everywhere.

The template language

{{ path }}                       a value; dotted paths reach into objects and arrays: items.0.title
{{ path | filter | filter:arg }} filters, applied left to right
{{#each list}} … {{else}} … {{/each}}   repeat for every item; {{this}}, {{@index}}, {{@number}}, {{@first}}, {{@last}}
{{#if value}} … {{else}} … {{/if}}      empty strings, 0, false, empty lists and missing values count as false
{{#unless value}} … {{/unless}}

A block tag alone on its line leaves no empty line behind, so a loop can be laid out one line per item. Single newlines are line breaks, a blank line starts a new paragraph, and the rest is the Markdown the notes block understands: headings, lists, task lists, quotes, code, bold, links, images.

Values from the data are inserted with Markdown characters escaped, so a title with an asterisk or brackets shows as text. A bare URL is left alone (and autolinks), and | raw inserts a value unescaped when a source is trusted to return Markdown.

Filter arguments are numbers, "quoted strings" or bare words (map:weather, date:relday); a dotted name is a path (first:inputs.count).

Filters

FilterDoes
round, round:1Round a number (to n decimals, trailing zeros dropped).
fixed:2Fixed decimals.
number, number:1Locale formatting with grouping (2,180).
date, date:styleFormat a date. Styles: short (15 Nov, the default), long, full, weekday, weekday-long, day, month, month-short, year, numeric, iso, relday (Today, Tomorrow, a weekday within the week, else a short date), relweekday (Today, Tomorrow, else the weekday). Accepts ISO strings, YYYY-MM-DD (as a local day), epoch milliseconds or seconds.
timeHours and minutes.
datetimeShort date and time.
relative5 d ago, in 3 h, now.
duration, duration:min, duration:msSeconds (or minutes, milliseconds) as 8 h 15 min.
plus:n, minus:n, times:n, div:nSmall arithmetic.
signed:1A number with its sign: +1.6.
change:data.previousPercentage change from an earlier value, signed: +0.39 %.
upper, lower, capitalizeChange case.
truncate:80Cut long text with an ellipsis.
default:"–"A fallback for empty values.
plainStrip HTML tags from a description.
rawInsert without escaping.
first:5, last:3, skip:2, reverseSlice or reverse a list.
sort:fieldSort a list by a field (ascending).
where:field, where:field:valueKeep items whose field is truthy, or equals a value.
pluck:fieldA list of one field from each item.
join:", "Join a list into text.
countNumber of items.
group:fieldGroup a list by a field: a list of { key, items }.
groupday:fieldGroup by the local day of a date field (groupday:start); key is that day, so `{{keydate:relweekday}}` works.
sparkA list of numbers as a unicode sparkline (▁▂▃▅█▅▃).
bar:10, bar:10:maxA percentage (or a value out of max) as a text bar (███████░░░).
zipTurn an object of parallel arrays into a list of objects: Open-Meteo's daily { time: [...], temperature_2m_max: [...] } becomes items with time and temperature_2m_max.
map:nameLook the value up in maps.name; unknown values pass through.

HTML templates

With "format": "html" the template is HTML instead of Markdown, with the same placeholders, blocks and filters. Data values are inserted HTML-escaped, so a title with angle brackets is text. The output goes through an allowlist before it reaches the page: structural and text tags, lists, tables, images (https addresses, or a file inside the extension such as icons/icon16.png), links (https, http, mailto), class, title, alt, sizes, and a style attribute limited to layout and typography with no url(). Scripts, event handlers, frames, forms, SVG and anything else are dropped; an unknown tag keeps its text. The built-in widgets are HTML templates: open one and unfold Definition to see how they are put together.

A small stylesheet of w- classes is there to build with. They use the theme's colours and the notes styles' paper ink where a card has one.

ClassDoes
w-rowA flex row, items centred, wrapping. w-between spreads them out, w-center centres them.
w-colA column.
w-growLets an item take the remaining width.
w-tilesA grid of equal tiles, as many across as fit.
w-tileOne tile: a soft background, centred text.
w-huge, w-bigA large number or headline (44 px, 22 px).
w-icon, w-icon-sAn emoji or glyph at 44 px or 22 px.
w-small, w-mutedSmaller text, muted colour.
w-badgeA pill.
w-dateA date badge: <div class="w-date"><b>24</b><small>Dec</small></div>.
w-day, w-item, w-timeA day row in a list of events, one event line, and its time column.
w-listChildren separated by hairlines.
w-sparkStyling for a spark sparkline.
w-barA progress track: <div class="w-bar"><span style="width: {{pct}}%"></span></div>.
w-dividerA horizontal rule with some air.
w-coverOn an image: full width, rounded.

Examples

Weather (Open-Meteo, no key), the Markdown way. The built-in one is the HTML version of this; the coordinates default to the location's position either way.

## {{current.temperature_2m | round}}° {{current.weather_code | map:weather}} {{current.weather_code | map:icons}}
Feels like {{current.apparent_temperature | round}}° · next 24 h {{hourly.temperature_2m | spark}}

{{#each daily | zip}}
**{{time | date:relday}}** {{weather_code | map:icons}} {{temperature_2m_max | round}}° / {{temperature_2m_min | round}}°
{{/each}}

Calendar from an ICS address, the Markdown way (the built-in one groups events by day with a date badge in HTML). Google Calendar: Settings → the calendar → Secret address in iCal format. Apple Calendar: right-click the calendar (or iCloud.com → the calendar's share icon) → Public Calendar, and copy the webcal:// link; only iCloud calendars can be published, not "On My Mac" ones, and anyone with the link can read that calendar. Outlook: Publish calendar → the ICS link. webcal:// addresses are fetched over HTTPS.

{{#each events | first:inputs.count}}
**{{start | date:relday}}**{{#unless allDay}} {{start | time}}{{/unless}} {{title}}{{#if location}} · {{location}}{{/if}}
{{else}}
Nothing coming up.
{{/each}}

One number from a JSON API, with a path into the response:

{
  "name": "Bitcoin",
  "source": { "url": "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd", "type": "json", "path": "bitcoin" },
  "refresh": "10m",
  "template": "### ${{usd | number}}\nupdated {{now | time}}"
}

A feed, laid out your way:

{
  "name": "xkcd",
  "source": { "url": "https://xkcd.com/atom.xml", "type": "rss" },
  "refresh": "2h",
  "template": "{{#each items | first:1}}**[{{title}}]({{url}})** · {{date | relative}}\n{{/each}}"
}

Good to know

The built-in library

Every widget that ships with HomeTab, with the definition the block dialog shows under Definition. Copy one as a starting point for your own, or to see how a filter or a layout class is used.

Weather Sunrise & sunset Air quality Earthquakes Calendar Public holidays Rocket launches Headlines from a feed Hacker News front page Wikipedia today xkcd Exchange rates Crypto prices Stock quote Crypto fear & greed GitHub repository Quote of the day Dad joke Photo of the day

Weather & sky

Weather

json source · every 30m · HTML template

Now and the next days, from Open-Meteo. Follows the location's position.

  • lat Latitude · empty = the location's position · default {location.lat}
  • lon Longitude · default {location.lng}
  • unit Unit · default celsius
  • days Days · default 5
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 30m.

Definition
{
  "name": "Weather",
  "format": "html",
  "inputs": {
    "lat": {
      "label": "Latitude",
      "type": "number",
      "default": "{location.lat}",
      "hint": "empty = the location's position"
    },
    "lon": {
      "label": "Longitude",
      "type": "number",
      "default": "{location.lng}"
    },
    "unit": {
      "label": "Unit",
      "type": "select",
      "options": [
        {
          "value": "celsius",
          "label": "°C"
        },
        {
          "value": "fahrenheit",
          "label": "°F"
        }
      ],
      "default": "celsius"
    },
    "days": {
      "label": "Days",
      "type": "select",
      "options": [
        "3",
        "5",
        "7"
      ],
      "default": "5"
    }
  },
  "source": {
    "url": "https://api.open-meteo.com/v1/forecast?latitude={lat}&longitude={lon}&current=temperature_2m,apparent_temperature,weather_code,wind_speed_10m,relative_humidity_2m&hourly=temperature_2m,precipitation_probability&forecast_hours=24&daily=weather_code,temperature_2m_max,temperature_2m_min,precipitation_probability_max&forecast_days={days}&timezone=auto&temperature_unit={unit}",
    "type": "json"
  },
  "refresh": "30m",
  "maps": {
    "weather": {
      "0": "Clear sky",
      "1": "Mainly clear",
      "2": "Partly cloudy",
      "3": "Overcast",
      "45": "Fog",
      "48": "Rime fog",
      "51": "Light drizzle",
      "53": "Drizzle",
      "55": "Heavy drizzle",
      "56": "Freezing drizzle",
      "57": "Freezing drizzle",
      "61": "Light rain",
      "63": "Rain",
      "65": "Heavy rain",
      "66": "Freezing rain",
      "67": "Freezing rain",
      "71": "Light snow",
      "73": "Snow",
      "75": "Heavy snow",
      "77": "Snow grains",
      "80": "Light showers",
      "81": "Showers",
      "82": "Heavy showers",
      "85": "Snow showers",
      "86": "Heavy snow showers",
      "95": "Thunderstorm",
      "96": "Thunderstorm with hail",
      "99": "Thunderstorm with hail"
    },
    "icons": {
      "0": "☀️",
      "1": "🌤️",
      "2": "⛅",
      "3": "☁️",
      "45": "🌫️",
      "48": "🌫️",
      "51": "🌦️",
      "53": "🌦️",
      "55": "🌧️",
      "56": "🌧️",
      "57": "🌧️",
      "61": "🌦️",
      "63": "🌧️",
      "65": "🌧️",
      "66": "🌧️",
      "67": "🌧️",
      "71": "🌨️",
      "73": "🌨️",
      "75": "❄️",
      "77": "🌨️",
      "80": "🌦️",
      "81": "🌧️",
      "82": "⛈️",
      "85": "🌨️",
      "86": "❄️",
      "95": "⛈️",
      "96": "⛈️",
      "99": "⛈️"
    }
  },
  "template": "<div class=\"w-row\">\n  <span class=\"w-icon\">{{current.weather_code | map:icons}}</span>\n  <div>\n    <div class=\"w-huge\">{{current.temperature_2m | round}}°</div>\n    <div class=\"w-muted\">{{current.weather_code | map:weather}} · feels like {{current.apparent_temperature | round}}°</div>\n  </div>\n</div>\n<div class=\"w-small w-muted\" style=\"margin-top: 6px\">💨 {{current.wind_speed_10m | round}} {{current_units.wind_speed_10m}} · 💧 {{current.relative_humidity_2m}} % · next 24 h <span class=\"w-spark\">{{hourly.temperature_2m | spark}}</span></div>\n<div class=\"w-tiles\">\n{{#each daily | zip}}\n  <div class=\"w-tile\">\n    <div class=\"w-small w-muted\">{{time | date:weekday}}</div>\n    <div class=\"w-icon-s\">{{weather_code | map:icons}}</div>\n    <div><b>{{temperature_2m_max | round}}°</b> <span class=\"w-muted\">{{temperature_2m_min | round}}°</span></div>\n    {{#if precipitation_probability_max}}<div class=\"w-small w-muted\">☔&nbsp;{{precipitation_probability_max}}&nbsp;%</div>{{/if}}\n  </div>\n{{/each}}\n</div>"
}

Sunrise & sunset

json source · every 1h · HTML template

Today's sunrise, sunset, daylight and UV index for the location.

  • lat Latitude · empty = the location's position · default {location.lat}
  • lon Longitude · default {location.lng}
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 1h.

Definition
{
  "name": "Sun",
  "format": "html",
  "inputs": {
    "lat": {
      "label": "Latitude",
      "type": "number",
      "default": "{location.lat}",
      "hint": "empty = the location's position"
    },
    "lon": {
      "label": "Longitude",
      "type": "number",
      "default": "{location.lng}"
    }
  },
  "source": {
    "url": "https://api.open-meteo.com/v1/forecast?latitude={lat}&longitude={lon}&daily=sunrise,sunset,daylight_duration,uv_index_max&forecast_days=1&timezone=auto",
    "type": "json"
  },
  "refresh": "1h",
  "template": "<div class=\"w-tiles\">\n  <div class=\"w-tile\"><div class=\"w-icon-s\">🌅</div><div class=\"w-big\">{{daily.sunrise.0 | time}}</div><div class=\"w-small w-muted\">sunrise</div></div>\n  <div class=\"w-tile\"><div class=\"w-icon-s\">🌇</div><div class=\"w-big\">{{daily.sunset.0 | time}}</div><div class=\"w-small w-muted\">sunset</div></div>\n</div>\n<div class=\"w-row w-between w-small w-muted\" style=\"margin-top: 8px\"><span>☀️ {{daily.daylight_duration.0 | duration}} of daylight</span><span>UV max {{daily.uv_index_max.0 | round:1}}</span></div>"
}

Air quality

json source · every 1h · HTML template

European air quality index and particulates, from Open-Meteo.

  • lat Latitude · empty = the location's position · default {location.lat}
  • lon Longitude · default {location.lng}
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 1h.

Definition
{
  "name": "Air quality",
  "format": "html",
  "inputs": {
    "lat": {
      "label": "Latitude",
      "type": "number",
      "default": "{location.lat}",
      "hint": "empty = the location's position"
    },
    "lon": {
      "label": "Longitude",
      "type": "number",
      "default": "{location.lng}"
    }
  },
  "source": {
    "url": "https://air-quality-api.open-meteo.com/v1/air-quality?latitude={lat}&longitude={lon}&current=european_aqi,pm2_5,pm10,ozone,nitrogen_dioxide&timezone=auto",
    "type": "json"
  },
  "refresh": "1h",
  "template": "<div class=\"w-row\"><div class=\"w-huge\">{{current.european_aqi}}</div><div><div><b>European AQI</b></div><div class=\"w-small w-muted\">0–20 good · 20–40 fair · 40–60 moderate · 60–80 poor · 80+ very poor</div></div></div>\n<div class=\"w-bar\" style=\"margin: 8px 0 4px\"><span style=\"width: {{current.european_aqi}}%\"></span></div>\n<div class=\"w-tiles\">\n  <div class=\"w-tile\"><div class=\"w-big\">{{current.pm2_5 | round}}</div><div class=\"w-small w-muted\">PM2.5</div></div>\n  <div class=\"w-tile\"><div class=\"w-big\">{{current.pm10 | round}}</div><div class=\"w-small w-muted\">PM10</div></div>\n  <div class=\"w-tile\"><div class=\"w-big\">{{current.ozone | round}}</div><div class=\"w-small w-muted\">ozone</div></div>\n  <div class=\"w-tile\"><div class=\"w-big\">{{current.nitrogen_dioxide | round}}</div><div class=\"w-small w-muted\">NO₂</div></div>\n</div>\n<div class=\"w-small w-muted\" style=\"margin-top: 6px\">µg/m³ · {{current.time | time}}</div>"
}

Earthquakes

json source · every 30m · HTML template

Magnitude 4.5+ earthquakes of the past day, from the USGS.

  • count How many · default 6
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 30m.

Definition
{
  "name": "Earthquakes",
  "format": "html",
  "inputs": {
    "count": {
      "label": "How many",
      "type": "number",
      "default": "6"
    }
  },
  "source": {
    "url": "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/4.5_day.geojson",
    "type": "json",
    "path": "features"
  },
  "refresh": "30m",
  "template": "<div class=\"w-list\">\n{{#each data | first:inputs.count}}\n<div class=\"w-item\"><b>M {{properties.mag | fixed:1}}</b> <a href=\"{{properties.url}}\">{{properties.place}}</a> <span class=\"w-small w-muted\">{{properties.time | relative}}</span></div>\n{{else}}\n<div class=\"w-muted\">No earthquakes above magnitude 4.5 in the past day.</div>\n{{/each}}\n</div>"
}

Calendar & time

Calendar

ics source · every 30m · HTML template

Upcoming events from any published calendar: Google, Apple/iCloud, Outlook…

  • url Calendar address (ICS) · Google: Settings → Secret address in iCal format. Apple: Share Calendar → Public Calendar. Outlook: Publish calendar. webcal:// links work. · required
  • count Events to show · default 8
  • days Days ahead · how far to look · default 60
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 30m.

Definition
{
  "name": "Calendar",
  "format": "html",
  "inputs": {
    "url": {
      "label": "Calendar address (ICS)",
      "type": "url",
      "required": true,
      "hint": "Google: Settings → Secret address in iCal format. Apple: Share Calendar → Public Calendar. Outlook: Publish calendar. webcal:// links work."
    },
    "count": {
      "label": "Events to show",
      "type": "number",
      "default": "8"
    },
    "days": {
      "label": "Days ahead",
      "type": "number",
      "default": "60",
      "hint": "how far to look"
    }
  },
  "source": {
    "url": "{url}",
    "type": "ics",
    "days": "{days}"
  },
  "refresh": "30m",
  "template": "{{#each events | first:inputs.count | groupday:start}}\n<div class=\"w-row w-day\">\n  <div class=\"w-date\"><b>{{key | date:day}}</b><small>{{key | date:month-short}}</small></div>\n  <div class=\"w-grow\">\n    <div class=\"w-small w-muted\">{{key | date:relweekday}}</div>\n    {{#each items}}\n    <div class=\"w-item\">{{#unless allDay}}<span class=\"w-time\">{{start | time}}</span>{{/unless}}{{#if url}}<a href=\"{{url}}\">{{title}}</a>{{else}}{{title}}{{/if}}{{#if location}} <span class=\"w-muted\">· {{location}}</span>{{/if}}</div>\n    {{/each}}\n  </div>\n</div>\n{{else}}\n<div class=\"w-muted\">Nothing coming up.</div>\n{{/each}}"
}

Public holidays

json source · every 12h · HTML template

The next public holidays in a country, from Nager.Date.

  • country Country · two-letter code: DK, DE, GB, US… · default DK
  • count How many · default 5
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 12h.

Definition
{
  "name": "Public holidays",
  "format": "html",
  "inputs": {
    "country": {
      "label": "Country",
      "type": "text",
      "default": "DK",
      "hint": "two-letter code: DK, DE, GB, US…"
    },
    "count": {
      "label": "How many",
      "type": "number",
      "default": "5"
    }
  },
  "source": {
    "url": "https://date.nager.at/api/v3/NextPublicHolidays/{country}",
    "type": "json"
  },
  "refresh": "12h",
  "template": "{{#each data | first:inputs.count}}\n<div class=\"w-row w-day\">\n  <div class=\"w-date\"><b>{{date | date:day}}</b><small>{{date | date:month-short}}</small></div>\n  <div class=\"w-grow\"><div>{{localName}}</div><div class=\"w-small w-muted\">{{date | date:relweekday}}{{#if name}} · {{name}}{{/if}}</div></div>\n</div>\n{{/each}}"
}

Rocket launches

json source · every 2h · HTML template

The next launches worldwide, from Launch Library.

  • count How many · default 5
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 2h.

Definition
{
  "name": "Launches",
  "format": "html",
  "inputs": {
    "count": {
      "label": "How many",
      "type": "select",
      "options": [
        "3",
        "5",
        "8"
      ],
      "default": "5"
    }
  },
  "source": {
    "url": "https://ll.thespacedevs.com/2.2.0/launch/upcoming/?limit={count}&mode=list&net__gte={today.date}",
    "type": "json",
    "path": "results"
  },
  "refresh": "2h",
  "template": "<div class=\"w-list\">\n{{#each data}}\n<div class=\"w-item\">\n  <div class=\"w-row w-between\"><b>{{name}}</b><span class=\"w-badge\">{{status.abbrev}}</span></div>\n  <div class=\"w-small w-muted\">{{net | datetime}} ({{net | relative}}) · {{lsp_name}} · {{location}}</div>\n</div>\n{{/each}}\n</div>"
}

Reading

Headlines from a feed

rss source · every 15m · HTML template

A compact list from one RSS or Atom feed, laid out your way.

  • url Feed address · default https://feeds.bbci.co.uk/news/rss.xml
  • count How many · default 6
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 15m.

Definition
{
  "name": "Headlines",
  "format": "html",
  "inputs": {
    "url": {
      "label": "Feed address",
      "type": "url",
      "default": "https://feeds.bbci.co.uk/news/rss.xml"
    },
    "count": {
      "label": "How many",
      "type": "number",
      "default": "6"
    }
  },
  "source": {
    "url": "{url}",
    "type": "rss"
  },
  "refresh": "15m",
  "template": "<div class=\"w-small w-muted\">{{title}}</div>\n<div class=\"w-list\">\n{{#each items | first:inputs.count}}\n<div class=\"w-item\"><a href=\"{{url}}\">{{title}}</a> <span class=\"w-small w-muted\">{{date | relative}}</span></div>\n{{/each}}\n</div>"
}

Hacker News front page

json source · every 15m · HTML template

Top stories with points and comment counts, via the Algolia API.

  • count How many · default 8
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 15m.

Definition
{
  "name": "Hacker News",
  "format": "html",
  "inputs": {
    "count": {
      "label": "How many",
      "type": "number",
      "default": "8"
    }
  },
  "source": {
    "url": "https://hn.algolia.com/api/v1/search?tags=front_page&hitsPerPage={count}",
    "type": "json",
    "path": "hits"
  },
  "refresh": "15m",
  "template": "<div class=\"w-list\">\n{{#each data}}\n<div class=\"w-item\"><a href=\"{{url | default:\"https://news.ycombinator.com/item?id=\"}}{{#unless url}}{{objectID}}{{/unless}}\">{{title}}</a> <span class=\"w-small w-muted\">{{points}} points · <a href=\"https://news.ycombinator.com/item?id={{objectID}}\">{{num_comments}} comments</a></span></div>\n{{/each}}\n</div>"
}

Wikipedia today

json source · every 6h · HTML template

Today's featured article and picture of the day.

  • lang Language · en, de, da, fr… · default en
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 6h.

Definition
{
  "name": "Wikipedia today",
  "format": "html",
  "inputs": {
    "lang": {
      "label": "Language",
      "type": "text",
      "default": "en",
      "hint": "en, de, da, fr…"
    }
  },
  "source": {
    "url": "https://{lang}.wikipedia.org/api/rest_v1/feed/featured/{today.year}/{today.month}/{today.day}",
    "type": "json"
  },
  "refresh": "6h",
  "template": "{{#if tfa}}\n<div class=\"w-row\" style=\"align-items: flex-start; flex-wrap: nowrap\">\n  {{#if tfa.thumbnail}}<img src=\"{{tfa.thumbnail.source}}\" alt=\"\" width=\"72\" style=\"border-radius: 8px; flex: none; object-fit: cover; height: 72px\">{{/if}}\n  <div class=\"w-grow\"><a href=\"{{tfa.content_urls.desktop.page}}\"><b>{{tfa.titles.normalized}}</b></a><div class=\"w-small\">{{tfa.extract | truncate:220}}</div></div>\n</div>\n{{/if}}\n{{#if image}}\n<div class=\"w-divider\"></div>\n<img class=\"w-cover\" src=\"{{image.thumbnail.source}}\" alt=\"\">\n<div class=\"w-small w-muted\" style=\"margin-top: 4px\">{{image.description.text | truncate:120}}</div>\n{{/if}}"
}

xkcd

json source · every 6h · HTML template

The latest comic, with its hover text.

Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 6h.

Definition
{
  "name": "xkcd",
  "format": "html",
  "source": {
    "url": "https://xkcd.com/info.0.json",
    "type": "json"
  },
  "refresh": "6h",
  "template": "<a href=\"https://xkcd.com/{{num}}/\"><b>{{safe_title}}</b></a>\n<img class=\"w-cover\" src=\"{{img}}\" alt=\"{{alt}}\" title=\"{{alt}}\" style=\"margin: 6px 0; background: #fff\">\n<div class=\"w-small w-muted\">{{alt}}</div>"
}

Money

Exchange rates

json source · every 6h · HTML template

European Central Bank reference rates, from Frankfurter.

  • base Base currency · default EUR
  • symbols Show · comma-separated codes · default USD,GBP,DKK,SEK
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 6h.

Definition
{
  "name": "Exchange rates",
  "format": "html",
  "inputs": {
    "base": {
      "label": "Base currency",
      "type": "text",
      "default": "EUR"
    },
    "symbols": {
      "label": "Show",
      "type": "text",
      "default": "USD,GBP,DKK,SEK",
      "hint": "comma-separated codes"
    }
  },
  "source": {
    "url": "https://api.frankfurter.dev/v1/latest?base={base}&symbols={symbols}",
    "type": "json"
  },
  "refresh": "6h",
  "template": "<div class=\"w-small w-muted\">1 {{base}} buys · {{date | date:short}}</div>\n<div class=\"w-tiles\">\n{{#each rates}}\n  <div class=\"w-tile\"><div class=\"w-big\">{{value | fixed:2}}</div><div class=\"w-small w-muted\">{{key}}</div></div>\n{{/each}}\n</div>"
}

Crypto prices

json source · every 10m · HTML template

Prices in US dollars with the 24-hour change, from CoinGecko.

  • ids Coins · CoinGecko ids, comma-separated · default bitcoin,ethereum,solana
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 10m.

Definition
{
  "name": "Crypto",
  "format": "html",
  "inputs": {
    "ids": {
      "label": "Coins",
      "type": "text",
      "default": "bitcoin,ethereum,solana",
      "hint": "CoinGecko ids, comma-separated"
    }
  },
  "source": {
    "url": "https://api.coingecko.com/api/v3/simple/price?ids={ids}&vs_currencies=usd&include_24hr_change=true",
    "type": "json"
  },
  "refresh": "10m",
  "template": "<div class=\"w-list\">\n{{#each data}}\n<div class=\"w-item w-row w-between\"><span>{{key | capitalize}}</span><span><b>${{value.usd | number}}</b> <span class=\"w-small w-muted\">{{value.usd_24h_change | signed:1}} % 24 h</span></span></div>\n{{/each}}\n</div>"
}

Stock quote

json source · every 15m · HTML template

One ticker's latest price and change, from Yahoo Finance's public chart data.

  • symbol Ticker · as on Yahoo Finance: AAPL, NOVO-B.CO, ^GSPC · default AAPL
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 15m.

Definition
{
  "name": "Stock",
  "format": "html",
  "inputs": {
    "symbol": {
      "label": "Ticker",
      "type": "text",
      "default": "AAPL",
      "hint": "as on Yahoo Finance: AAPL, NOVO-B.CO, ^GSPC"
    }
  },
  "source": {
    "url": "https://query1.finance.yahoo.com/v8/finance/chart/{symbol}?range=1d&interval=1d",
    "type": "json",
    "path": "chart.result.0.meta"
  },
  "refresh": "15m",
  "template": "<div class=\"w-row w-between\"><div><b>{{shortName | default:data.symbol}}</b> <span class=\"w-small w-muted\">{{symbol}} · {{exchangeName}}</span></div><span class=\"w-badge\">{{regularMarketPrice | change:data.chartPreviousClose}}</span></div>\n<div class=\"w-row\" style=\"align-items: baseline\"><span class=\"w-huge\">{{regularMarketPrice | number:2}}</span><span class=\"w-muted\">{{currency}}</span></div>\n<div class=\"w-small w-muted\">previous close {{chartPreviousClose | number:2}} · {{regularMarketTime | relative}}</div>"
}

Crypto fear & greed

json source · every 1h · HTML template

The crypto market mood index, 0 to 100, from alternative.me.

Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 1h.

Definition
{
  "name": "Fear & greed",
  "format": "html",
  "source": {
    "url": "https://api.alternative.me/fng/?limit=1",
    "type": "json",
    "path": "data.0"
  },
  "refresh": "1h",
  "template": "<div class=\"w-row\"><div class=\"w-huge\">{{value}}</div><div><div><b>{{value_classification}}</b></div><div class=\"w-small w-muted\">crypto fear &amp; greed index</div></div></div>\n<div class=\"w-bar\" style=\"margin-top: 8px\"><span style=\"width: {{value}}%\"></span></div>\n<div class=\"w-row w-between w-small w-muted\"><span>extreme fear</span><span>extreme greed</span></div>"
}

Developer

GitHub repository

json source · every 1h · HTML template

Stars, forks, open issues and the last push of a repository.

  • repo Repository · owner/name · required
Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 1h.

Definition
{
  "name": "GitHub",
  "format": "html",
  "inputs": {
    "repo": {
      "label": "Repository",
      "type": "text",
      "required": true,
      "hint": "owner/name"
    }
  },
  "source": {
    "url": "https://api.github.com/repos/{repo}",
    "type": "json"
  },
  "refresh": "1h",
  "template": "<div class=\"w-row w-between\"><a href=\"{{html_url}}\"><b>{{full_name}}</b></a>{{#if language}}<span class=\"w-badge\">{{language}}</span>{{/if}}</div>\n{{#if description}}<div class=\"w-muted w-small\">{{description}}</div>{{/if}}\n<div class=\"w-tiles\">\n  <div class=\"w-tile\"><div class=\"w-big\">{{stargazers_count | number}}</div><div class=\"w-small w-muted\">stars</div></div>\n  <div class=\"w-tile\"><div class=\"w-big\">{{forks_count | number}}</div><div class=\"w-small w-muted\">forks</div></div>\n  <div class=\"w-tile\"><div class=\"w-big\">{{open_issues_count | number}}</div><div class=\"w-small w-muted\">open issues</div></div>\n</div>\n<div class=\"w-small w-muted\" style=\"margin-top: 6px\">pushed {{pushed_at | relative}}</div>"
}

Fun

Quote of the day

json source · every 6h · HTML template

One quote a day, from ZenQuotes.

Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 6h.

Definition
{
  "name": "Quote of the day",
  "format": "html",
  "source": {
    "url": "https://zenquotes.io/api/today",
    "type": "json",
    "path": "0"
  },
  "refresh": "6h",
  "template": "<div style=\"font-size: 17px; line-height: 1.45\">“{{q}}”</div>\n<div class=\"w-small w-muted\" style=\"margin-top: 6px\">— {{a}}</div>"
}

Dad joke

json source · every 1h · HTML template

A fresh one every hour, from icanhazdadjoke.

Preview

Rendered from a response saved on 17 November 2026; the real widget fetches every 1h.

Definition
{
  "name": "Dad joke",
  "format": "html",
  "source": {
    "url": "https://icanhazdadjoke.com/",
    "type": "json"
  },
  "refresh": "1h",
  "template": "<div style=\"font-size: 16px; line-height: 1.45\">{{joke}}</div>"
}

Photo of the day

no source · every 24h · HTML template

A new photo every day, from Lorem Picsum. No data fetched, just an image.

  • height Height · default 300
Preview
Definition
{
  "name": "Photo of the day",
  "format": "html",
  "inputs": {
    "height": {
      "label": "Height",
      "type": "select",
      "options": [
        "200",
        "300",
        "400"
      ],
      "default": "300"
    }
  },
  "refresh": "24h",
  "template": "<img class=\"w-cover\" src=\"https://picsum.photos/seed/{{now | date:iso}}/800/{{inputs.height}}\" alt=\"\">"
}