basic_read_store
Reads a payload file the user maintains at $HOME/.splashboard/store/<widget_id>.<ext> (text / json / toml) and renders it as the declared shape. The escape hatch for ad-hoc widgets — populate the file from any cron, editor, or post-commit hook and splashboard surfaces whatever you wrote.
| Kind | Safety | Shapes |
|---|---|---|
| cached | Safe | text, text_block, entries, ratio, number_series, point_series, bars, image, image_linked_list, calendar, heatmap |
Options
Section titled “Options”No options.
Compatible renderers
Section titled “Compatible renderers”Preview
Section titled “Preview”text via text_ascii
Section titled “text via text_ascii”▝█ ▜▌ ▜▌ ▝█ ▟▀▀ ▜▞▜▖ █ ▝▀▙ ▟▀▀ ▐▙▜▖▐▙▄ ▟▀▙ ▝▀▙ ▜▟▜▖▗▄█ ▝▀▙ ▐▙▟▘ █ ▟▀█ ▝▀▙ ▐▌▐▌▐▌▐▌█ █ ▟▀█ ▐▌▝▘█ █ ▀▀▘ ▟▙ ▝▀▘ ▝▀▝▘▀▀▘ ▀▘▝▘▀▝▀ ▝▀▘ ▝▀▝▘▀▀ ▝▀▝▘
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "text_ascii"text via text_plain
Section titled “text via text_plain”splashboard
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "text_plain"text_block via list_plain
Section titled “text_block via list_plain”splashboard greetings on cd
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "list_plain"entries via grid_table
Section titled “entries via grid_table”key value foo bar baz qux
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "grid_table"ratio via gauge_battery
Section titled “ratio via gauge_battery”┌────────────────────────────┐ used │███████████████████░░░░░░░░░│▮ 67% └────────────────────────────┘
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "gauge_battery"ratio via gauge_circle
Section titled “ratio via gauge_circle”███████████████████████████ ██████████████████used ████ ███████████████████████████
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "gauge_circle"ratio via gauge_line
Section titled “ratio via gauge_line”used: ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░ 67%
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "gauge_line"ratio via gauge_segment
Section titled “ratio via gauge_segment”used ▰▰▰▱▱ 67%
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "gauge_segment"ratio via gauge_thermometer
Section titled “ratio via gauge_thermometer”╭─╮ │░│ │░│ │█│ used │█│ 67% │█│ │█│ ╰●╯
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "gauge_thermometer"number_series via chart_histogram
Section titled “number_series via chart_histogram”████████████████ ▆▆▆▆▆▆▆▆████████████████▆▆▆▆▆▆▆▆ ████████████████████████████████ ████████████████████████████████▃▃▃▃▃▃▃▃ ████████████████████████████████████████ ████████████████████████████████████████
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "chart_histogram"number_series via chart_sparkline
Section titled “number_series via chart_sparkline”▁ ▃ █ ▁▅ ▃ ▂ █ █▅█▇ ▅ ▂██▇ █▅ ▄█▆██████▆██▄███████
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "chart_sparkline"point_series via chart_line
Section titled “point_series via chart_line”⡠⠔⠊⠉⠉⠉⠒⠤⣀ ┌──────┐ ⡠⠔⠉ ⠉⠢⡀ │series│ ⢀⠎ ⠈⠢⡀ └──────┘ ⢀⠔⠁ ⠈⢆ ⡠⠊ ⠑⢄ ⡠ ⠈⠢⡀ ⢀⠔⠁ ⠈⢆ ⡠⠊ ⠑⢄⡀ ⢀⠔⠁ ⠈⠢⡀ ⢀⠤⠊⠁ ⠈⠑⠤⢄⣀⣀⠤⠔⠊⠁
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "chart_line"point_series via chart_scatter
Section titled “point_series via chart_scatter”• • • • • • • • • • • • • • • • • • • •
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "chart_scatter"bars via chart_bar
Section titled “bars via chart_bar”███ ███ ███ ▅▅▅ ███ ███ ███ ███ ▆▆▆ ▁▁▁ ███ ███ ███ ███ 42█ 28█ 17█ 13█ rus go ts py
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "chart_bar"bars via chart_pie
Section titled “bars via chart_pie”● ■ rust 42.0% ●●●●●●●●●●● ●●●●●●●●●●●●● ■ go 28.0% ●●●●●●●●●●●●●●● ●●●●●●●●●●●●●●●●● ■ ts 17.0% ●●●●●●●●●●●●●●● ●●●●●●●●●●●●● ■ py 13.0% ●●●●●●●●●●● ●
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "chart_pie"bars via list_ranking
Section titled “bars via list_ranking”1. rust 42 2. go 28 3. ts 17 4. py 13
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "list_ranking"image_linked_list via list_cards
Section titled “image_linked_list via list_cards”splashboard greets on cd docs · 2h
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "list_cards"calendar via grid_calendar
Section titled “calendar via grid_calendar”April 2026 Su Mo Tu We Th Fr Sa 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "grid_calendar"heatmap via grid_heatmap
Section titled “heatmap via grid_heatmap”■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
[[widget]]id = "basic_read_store"fetcher = "basic_read_store"render = "grid_heatmap"