list_cards
Card-shaped rows with a thumbnail on the left and title (+ optional subtitle) on the right. Rows that carry a URL get an OSC 8 hyperlink wrap on the title so terminals make it clickable. Use this for media-feed widgets (RSS with images, subreddit posts, Wikipedia featured) where the thumbnail is part of the headline.
| Accepts | Animates |
|---|---|
image_linked_list | no |
Options
Section titled “Options”| Option | Type | Required | Default | Description |
|---|---|---|---|---|
max_items | positive integer | no | all rows | Cap on rendered cards. Truncates from the end when the input has more rows than the cap. |
thumbnail_width | cells (u16) | no | 6 | Width in cells of the thumbnail column. Rows without a thumbnail still consume this width as blank space so the text column stays aligned. |
row_height | cells (u16) | no | 3 | Height in cells of each card row. Row 0 carries the title (linked when url is set), row 1 the optional subtitle, row 2 is breathing room. |
gap | cells (u16) | no | 1 | Horizontal gap in cells between the thumbnail column and the text column. |
fit | "contain" | "cover" | "stretch" | no | "contain" | How each thumbnail is sized into its cell. Matches media_image's fit. |
Theme tokens
Section titled “Theme tokens”Overridable via the [theme] section of your dashboard config.
| Key | Description |
|---|---|
text | Primary body text colour for plain renderers (text_plain, text_ascii, list_plain, animated_typewriter). The top step of the chrome ladder — brighter than text_secondary, reads as diffuse daylight on the ocean surface. Set text = "reset" to inherit the terminal's own foreground instead. |
text_dim | Barely-visible chrome text: timeline date prefixes, empty-state placeholder, clip hint. Replaces the old Modifier::DIM usage — set an explicit colour so rendering stays consistent across terminals (some render DIM as invisible, some as a no-op). |
Compatible fetchers
Section titled “Compatible fetchers”Preview
Section titled “Preview”image_linked_list
Section titled “image_linked_list”splashboard greets on cd docs · 2h
[[widget]]id = "rss"fetcher = "rss"render = "list_cards"