chart_bar

Labelled bar chart from a Bars shape. Defaults to vertical bars with labels underneath; flip to horizontal rows via horizontal = true for narrow slots.

Accepts	Animates
bars	no

Options

Option	Type	Required	Default	Description
horizontal	bool	no	false	Orient bars horizontally instead of vertical. Useful for wide/narrow widget slots.
stacked	bool	no	false	Placeholder — the current Bars shape is single-series, so this is a no-op until the shape gains series support. Accepted so configs stay forward-compatible.
max_bars	positive integer	no	all bars	Cap on rendered bars, keeping the top N by value. Omit to render every bar.
bar_width	cells (u16)	no	3 for vertical, 1 for horizontal	Thickness of each bar along the axis perpendicular to its growth. Horizontal bars default to 1 cell so several fit into a compact slot without stacking tall; vertical bars default to 3 so labels under them have room.
bar_gap	cells (u16)	no	1 for vertical, 0 for horizontal	Gap between adjacent bars. Vertical bars default to 1 cell so labels under each bar stay legible; horizontal bars default to 0 so rows pack tight without blank gutters between them.

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.

Compatible fetchers

Shape

Fetchers

bars

basic_bars, basic_read_store, claude_code_usage, claude_subscription, code_comments, code_files, code_largest_files, code_loc, code_todos, codex_subscription, codex_usage, crypto_trending, crypto_watchlist, deal_free_games, deal_games, deal_steam_daily, git_age, git_churn, git_contributors, github_action_history, github_assigned_issues, github_contributors_monthly, github_languages, github_my_prs, github_repo_issues, github_repo_prs, github_repo_stars, github_review_requests, gitlab_my_mrs, gitlab_repo_issues, gitlab_repo_mrs, gitlab_repo_stars, gitlab_review_requests, huggingface_trending, lastfm_charts, lastfm_top_albums, lastfm_top_artists, lastfm_top_tracks, linear_cycle, linear_issues, linear_notifications, lobsters_top, net_interfaces, net_speedtest, reddit_trending, steam_charts, steam_owned_games, steam_recently_played, stock_watchlist, system_monitor_disk, weather, weather_forecast, wikipedia_trending

Preview

bars

███                                     
███                                     
███ ▅▅▅                                 
███ ███                                 
███ ███ ▆▆▆ ▁▁▁                         
███ ███ ███ ███                         
42█ 28█ 17█ 13█                         
rus go  ts  py                          

[[widget]]
id = "github_languages"
fetcher = "github_languages"
render = "chart_bar"