Add to Timely (Extended)

This can effectively be made optional by supplying whitespace as the input.

Dates must be set in the future. Timely will immediately clear a Countdown with a deadline in the past.

Shortcuts also supports some natural language expressions of dates in this field, for example, ‘Tomorrow at 8am’ or ‘Tonight’, but it does not support expressions such as ‘in 10 minutes’. To set a relative date in this way, use the ‘Adjust Date’ Shortcuts action.

Options:

• Emoji
• SF Symbol

Only one emoji is supported. If multiple are supplied, Timely will use only the first.

Options:

• Use AI
• Red, Coral, Orange, Amber, Yellow, Lime, Spring, Green, Emerald, Mint, Aqua, Teal, Cyan, Sky, Blue, Indigo, Violet, Purple, Magenta, Pink, Brown, Tan, Olive, Slate, Gray
• Custom Hex Code

Enter the six-character hexadecimal colour value without the '#'.

A route can contain:

• One item, to create a standard single-destination Countdown with an optional travel time and buffer.
• Two or more items, to create a multi-stop route. The first item is your starting point; every later item is a destination in the order supplied.

Each route item must provide:

• location — a readable name or address for the stop.
• latitude — the stop’s latitude.
• longitude — the stop’s longitude.

For every item after the first, travelTimeMinutes is required. It is the travel time from the preceding stop to this one. bufferMinutes is optional for every item and defaults to 0; it is time reserved at that stop.

For the first item in a multi-stop route, bufferMinutes is treated as preparation time before leaving. travelTimeMinutes, if supplied for the first item, is also included in that preparation time.

All times are whole minutes. Individual travel times and buffers cannot be negative, and the route’s combined travel and buffer time cannot exceed seven days.

Route JSON format

Supply either a JSON array of dictionaries, a single JSON dictionary, or a Shortcuts List containing route dictionaries. The following is a two-stop route:

[
  {
    "location": "Home",
    "latitude": -43.5000,
    "longitude": 172.6000,
    "bufferMinutes": 10
  },
  {
    "location": "Christchurch Airport",
    "latitude": -43.4894,
    "longitude": 172.5322,
    "travelTimeMinutes": 25,
    "bufferMinutes": 90
  }
]

This creates a route from Home to Christchurch Airport, allowing 10 minutes to prepare before leaving, 25 minutes to travel, and 90 minutes at the airport.

Keys are case-insensitive, and spaces or punctuation in key names are ignored. For example, Travel Time, travelTimeMinutes, and TRAVEL TIME MINUTES are equivalent. Time at Stop, Buffer, and bufferMinutes are also equivalent.

Each item may contain only one value for each field. Additional or unrecognised fields cause the action to stop with an error.

Accepts a place name, street address, or a Location variable supplied by another Shortcuts action.

Used with Longitude when both coordinates are provided.

Used with Latitude when both coordinates are provided.

Options:

• None (the default)
• Car
• Biking
• Walking

Set to None when not adding a location or travel time

Options:

• Car
• Biking
• Walking