ironbar/docs/modules/Script.md

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.