Skip to content
Jake Stanger edited this page Jun 29, 2023 · 11 revisions

Executes a script and shows the result of stdout on a label. Pango markup is supported.

If you want to be able to embed multiple scripts and/or variables, prefer the label module. For more advanced use-cases, use custom.

Configuration

Type: script

Name Type Default Description
cmd string null Path to the script on disk
mode 'poll' or 'watch' poll See #modes
interval number 5000 Number of milliseconds to wait between executing script

Modes

  • Use poll to run the script wait for it to exit. On exit, the label is updated to show everything the script wrote to stdout.
  • Use watch to start a long-running script. Every time the script writes to stdout, the label is updated to show the latest line. Note this does not work for all programs as they may use block-buffering instead of line-buffering when they detect output being piped.
JSON
{
  "end": [
    {
      "type": "script",
      "cmd": "/home/jake/.local/bin/phone-battery",
      "mode": "poll",
      "interval": 5000
    }
  ]
}
TOML
[[end]]
type = "script"
cmd = "/home/jake/.local/bin/phone-battery"
mode = "poll"
interval = 5000
YAML
end:
  - type: "script"
    cmd: "/home/jake/.local/bin/phone-battery"
    mode: 'poll'
    interval : 5000
Corn
{
  end = [
    {
      type = "script"
      cmd = "/home/jake/.local/bin/phone-battery"
      mode = "poll"
      interval = 5000
    }
  ]
}

Styling

Selector Description
.script Script widget label

For more information on styling, please see the styling guide.

Clone this wiki locally