Skip to content

net_gateway

The host's default-route gateway. Text (default) shows the gateway address — kind = "interface" shows the interface it routes through instead; TextBlock / MarkdownTextBlock / Entries roll up gateway + interface; Badge is a has-default-route / no-route pill.

Kind	Safety	Shapes
cached	Safe	`text`, `text_block`, `markdown_text_block`, `entries`, `badge`

Options

Option	Type	Required	Default	Description
`kind`	"gateway" \| "interface"	no	"gateway"	Which field the `Text` shape shows — the gateway address or the interface it routes through. Ignored by the other shapes. (Route metric isn't exposed by the underlying platform APIs, so it isn't a `kind`.)

Compatible renderers

Shape	Renderers
`text`	`animated_boot`, `animated_figlet_morph`, `animated_postfx`, `animated_scanlines`, `animated_splitflap`, `animated_typewriter`, `animated_wave`, `text_ascii`, `text_plain`
`text_block`	`animated_boot`, `animated_postfx`, `animated_scanlines`, `animated_splitflap`, `animated_wave`, `list_plain`
`markdown_text_block`	`text_markdown`
`entries`	`animated_boot`, `animated_postfx`, `animated_scanlines`, `animated_splitflap`, `animated_wave`, `grid_table`
`badge`	`animated_boot`, `animated_postfx`, `animated_scanlines`, `animated_splitflap`, `animated_wave`, `status_badge`

Preview

`text` via `text_ascii`

▗█  ▟▀▙ ▟▀▙     ▗█  ▗▛▘ ▟▀▙     ▗█      ▗█                                      
 █  ▜▄█  ▄▛      █  █▄▖ ▜▄▛      █       █                                      
 █   ▗▛ ▟▘▄  ▄   █  █ █ █ █  ▄   █   ▄   █                                      
▀▀▀ ▝▀  ▀▀▀  ▀  ▀▀▀ ▝▀▘ ▝▀▘  ▀  ▀▀▀  ▀  ▀▀▀

[[widget]]
id = "net_gateway"
fetcher = "net_gateway"
render = "text_ascii"

`text` via `text_plain`

192.168.1.1

[[widget]]
id = "net_gateway"
fetcher = "net_gateway"
render = "text_plain"

`text_block` via `list_plain`

gateway  192.168.1.1                    
interface  eth0

[[widget]]
id = "net_gateway"
fetcher = "net_gateway"
render = "list_plain"

`markdown_text_block` via `text_markdown`

- gateway 192.168.1.1                   
- interface eth0

[[widget]]
id = "net_gateway"
fetcher = "net_gateway"
render = "text_markdown"

`entries` via `grid_table`

gateway                      192.168.1.1
interface                           eth0

[[widget]]
id = "net_gateway"
fetcher = "net_gateway"
render = "grid_table"

`badge` via `status_badge`

● 192.168.1.1

[[widget]]
id = "net_gateway"
fetcher = "net_gateway"
render = "status_badge"