-
Notifications
You must be signed in to change notification settings - Fork 60
Ironvars
Jake Stanger edited this page Mar 3, 2025
·
3 revisions
Ironvars are runtime variables that can be referenced in several places in your config,
then set using the IPC server (such as via the CLI) using the set command.
Keys can consist of alphanumeric characters, - and _ only.
Any UTF-8 string is a valid value.
Reference values using #my_variable. These update as soon as the value changes.
You can set defaults using the ironvar_defaults key in your top-level config.
Some modules (such as sys_info) expose their values over the Ironvar interface,
allowing you to build custom interfaces and integrate into scripts.
These present their values inside read-only namespaces.
Some examples below:
ironbar var list
ironbar var list sysinfo
ironbar var list sysinfo.disk_percent
ironbar var get sysinfo.disk_percent./home
ironbar var get sysinfo.disk_percent.mean
ironbar var get sysinfo.memory_percent