Skip to content

wezterm.time.call_after(interval_seconds, function)

Since: Version 20220807-113146-c2fee766

The feature described in this section requires version 20220807-113146-c2fee766 of wezterm, or a more recent version.

Arranges to call your callback function after the specified number of seconds have elapsed.

Here's a contrived example that demonstrates a configuration that varies based on the time. In this case, the idea is that the background color is derived from the current number of minutes past the hour.

In order for the value to be picked up for the next minute, call_after is used to schedule a callback 60 seconds later and it then generates a background color by extracting the current minute value and scaing it to the range 0-255 and using that to assign a background color:

local wezterm = require 'wezterm'

-- Reload the configuration every minute
wezterm.time.call_after(60, function()

local amount =
  math.ceil((tonumber( '%M') / 60) * 255)

return {
  colors = {
    background = 'rgb(' .. amount .. ',' .. amount .. ',' .. amount .. ')',

With great power comes great responsibility: if you schedule a lot of frequent callbacks, or frequently reload your configuration in this way, you may increase the CPU load on your system because you are asking it to work harder.

Since: Version 20230320-124340-559cb7b0

The feature described in this section requires version 20230320-124340-559cb7b0 of wezterm, or a more recent version.

You can use fractional seconds to delay by more precise intervals.