Visual editor for the Custom Next Holiday TRMNL recipe.
Create a new holiday list from scratch or load an existing YAML configuration.
Each holiday is a YAML object with the following fields:
name (string, required)The display name of the holiday, shown on the TRMNL screen. Can be any text.
name: Christmas Day
date (string, required)A date expression specifying when the holiday occurs. Four formats are supported:
| Format | Pattern | Example | Meaning |
|---|---|---|---|
| Absolute date | YYYY-MM-DD |
2038-01-19 |
A single, one-time date. 19th January, 2038. |
| Annual date | MM-DD |
12-25 |
Recurring yearly on the same month and day. 25th December every year. |
| n-th weekday of month | MMWn-D |
08W2-5 |
The n-th occurrence of a weekday in a month. 2nd Friday of August.MM = month (01–12), n = occurrence (1–5), D = weekday (1=Mon … 7=Sun). |
| Last n-th weekday of month | MMWnN-D |
05Wn1-1 |
The n-th-to-last weekday in a month. Last Monday of May.MM = month, N = position from end (1–5), D = weekday. |
Append [u-ca=calendar] to any date format to use a non-Gregorian calendar system. The date numbers then refer to months/days in that calendar.
date: 01-01[u-ca=chinese] # Chinese New Year (1st of 1st month in Chinese calendar)
Supported calendars include: chinese, islamic, hebrew, japanese, persian, indian, buddhist, and others.
See MDN: supported calendar types for the full list.
icon (string, required)An Iconify icon identifier displayed alongside the holiday. Format: prefix:icon-name.
icon: fluent-emoji-flat:fireworks
Browse available icons at Iconify Icon Sets.
round (array of integers, optional)If the resolved date falls on a day not in this list, it is shifted to the nearest day that is. Each integer represents an ISO weekday: 1 = Monday, 2 = Tuesday, … 7 = Sunday.
round: [1, 2, 3, 4, 5] # Round to nearest weekday (Mon–Fri)
Omit this field (or use an empty array) to disable rounding.
- name: Christmas Day date: 12-25 icon: fluent-emoji-flat:fireworks round: [1, 2, 3, 4, 5] - name: Year 2038 problem date: 2038-01-19 icon: mdi:cpu-32-bit - name: US Memorial Day date: 05Wn1-1 icon: fluent-emoji-flat:reindeer-ribbon - name: Chinese New Year date: 01-01[u-ca=chinese] icon: fluent-emoji-flat:red-envelope