basic_badge | realtime | Safe | badge | Renders a single status pill from [widget.options]. status picks the tone (ok / warn / error), label the visible text. Right for tagging a per-directory splash with its environment (staging, prod), or pinning a stale-data warning. |
basic_bars | realtime | Safe | bars | Renders a Bars payload from inline [widget.options].bars = [{label, value}]. Row order is preserved as authored; sorting / ranking is a renderer concern (list_ranking, chart_bar's sort option). |
basic_calendar | realtime | Safe | calendar | Renders a Calendar payload from inline options. year / month / day default to today in the resolved timezone so a fresh config shows the current month with today highlighted; events lists extra days to mark. |
basic_entries | realtime | Safe | entries | Renders an Entries payload from inline [widget.options].entries = [{key, value?, status?}]. Right for project-facts panels (owner / language / license / docs-link) or any small reference table — the data is stable enough to live in TOML. |
basic_heatmap | realtime | Safe | heatmap | Renders a Heatmap payload from inline [widget.options]. cells is a row-major 2D grid of u32 intensities; thresholds / row_labels / col_labels are optional. Right for habit trackers, sample / demo grids, or any small fixed heatmap the user wants to keep in TOML. |
basic_image | realtime | Safe | image | Emits a user-configured file path as an Image payload. Right for repo logos, per-directory branding, or any static image — the renderer (media_image) is what actually loads the bytes. Path expansion is deferred to the renderer so this fetcher is pure and infallible at compute time. |
basic_links | realtime | Safe | linked_text_block, text, text_block, markdown_text_block, entries, image_linked_list | Renders a user-authored list of pinned links from [widget.options].links. LinkedTextBlock (default) and ImageLinkedList wrap rows with a URL in OSC 8 escape sequences so terminals surface them as clickable; Text headlines the first label, TextBlock is plain labels, MarkdownTextBlock emits - [label](url) bullets, Entries is label → url rows. Right for per-directory bookmarks (repo docs, CI dashboard, deploy console). |
basic_numbers | realtime | Safe | number_series | Renders a NumberSeries from inline [widget.options].values. Right for tiny static series the user wants to sparkline or histogram without a dedicated fetcher (weekly tallies, manual progress curves). |
basic_points | realtime | Safe | point_series | Renders a PointSeries from inline [widget.options].series = [{name, points: [[x, y], ...]}]. Supports multiple series so a single widget can carry several lines / clusters. |
basic_ratio | realtime | Safe | ratio | Single Ratio (0..=1) authored inline in config. Pairs with any gauge renderer. Clamps out-of-range values silently — the splash should never be unable to render because of one bad number. |
basic_read_store | cached | Safe | text, text_block, entries, ratio, number_series, point_series, bars, image, pixel_art, image_linked_list, calendar, heatmap | 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. |
basic_static | cached | Safe | text, text_block, markdown_text_block | Renders a constant string supplied by the widget's format option, split into lines on \n for TextBlock, collapsed to single-spaces for Text, and passed through verbatim for MarkdownTextBlock. Use it for greetings, project banners, or fixed welcome notes that don't need a dedicated fetcher. |
basic_timeline | realtime | Safe | timeline | Renders a Timeline from inline [widget.options].events. Each event takes an RFC 3339 at timestamp plus a title; optional detail and status decorate the row. Right for fixed milestones (releases, anniversaries, planned freezes) where the dates don't change. |
calendar_holidays | cached | Safe | calendar, text, text_block | Public holidays for a country (ISO 3166-1 alpha-2) via date.nager.at. Calendar highlights this month's holiday dates, Text shows today's holiday name when one matches, and TextBlock lists the next few upcoming holidays. |
claude_code_usage | cached | Safe | text, text_block, markdown_text_block, entries, bars, number_series, badge | Token and cost rollup from local Claude Code session JSONL files. Aggregates assistant turns under the chosen since window and groups them by project, model, or day. Pricing is bundled, so the splash works offline. |
claude_subscription | cached | Safe | ratio, text, text_block, markdown_text_block, entries, bars, badge, timeline | Claude (Max plan) subscription utilisation as seen by Claude Code's OAuth credentials. Reads ~/.claude/.credentials.json and queries the undocumented oauth/usage endpoint, exposing every window the response carries (5-hour, 7-day, per-model and pool-specific siblings). |
clock | realtime | Safe | text, entries, calendar | Current local time. Renders as a formatted clock string, a key/value breakdown of year/month/day/hour/minute/second, or a month calendar grid with optional highlighted days. |
clock_almanac | realtime | Safe | entries, text_block, calendar | A multi-row rollup of date-derived facts (moon phase, season, zodiac, chinese zodiac, ISO week, day of year). Use this when you want every almanac value at once; pick clock_derived instead to surface a single value on its own line. Calendar highlights today within the current month so the same fetcher can drive a grid_calendar widget. |
clock_countdown | realtime | Safe | text, text_block, entries, ratio, calendar | Time remaining until one configured target date or a list of labelled targets, formatted as Nd Nh / Nh Nm / Nm. Past targets keep rendering as passed so the widget survives the event boundary. Ratio exposes a 30-day approach progress (override with window_days); Calendar highlights the target day within its month. |
clock_derived | realtime | Safe | text, pixel_art | A single value derived from today's date, picked by kind (time of day, moon phase, zodiac, chinese zodiac, season, Japanese seasonal term, rokuyou, ISO week, day of year, Julian day, Unix epoch). Use clock_almanac to show several of these together as one block. |
clock_ratio | realtime | Safe | ratio | Fraction of the current period elapsed so far, as a 0..=1 value for gauge and progress-bar renderers. period selects which period (day, hour, week, month, quarter, year). |
clock_state | realtime | Safe | badge | Whether the current moment falls inside a named temporal window (business hours, weekend, night), rendered as a status badge that flips between Ok and Warn. Pick kind to choose which window. |
clock_sunrise | realtime | Safe | text, entries | Today's sunrise and sunset clock times for a configured lat / lon, computed offline from a NOAA-style approximation (no network). Renders as a one-line ↑ HH:MM ↓ HH:MM summary or split sunrise/sunset rows. |
clock_timezones | realtime | Safe | text_block, entries | A world-clock strip showing the current time in each of the configured IANA timezones, one row per zone. Use this for at-a-glance multi-region time; pick the base clock fetcher for a single local time. |
code_comments | cached | Safe | text, text_block, markdown_text_block, entries, bars, ratio, badge | Comment-density per language across tracked source files in the discovered git repo. tokei parses each file into code / comments / blanks; this fetcher surfaces the comment share. Text headlines the whole-repo ratio; TextBlock / MarkdownTextBlock / Entries / Bars rank per-language values (default percent, override with unit = loc | kloc); Ratio exposes the whole-repo share for gauges; Badge tiers documentation posture (undocumented / light / balanced / documented / verbose). |
code_files | cached | Safe | text, text_block, entries, bars, markdown_text_block | Counts tracked files in the discovered git repo's index and ranks top-level directories by file count. Text is the headline file count ("342 files"); TextBlock lists "<dir> (<count>)" rows; Entries exposes the same as key/value rows; Bars ranks them as bar values; MarkdownTextBlock formats them as a Markdown bullet list with emphasis. Files at the repo root are grouped under "(root)". Vendored / generated dirs (node_modules / vendor / target / dist / build) are filtered out even when committed. |
code_language_logo | cached | Safe | image | Detects the dominant language across the repo's tracked files and emits a bundled Devicon PNG (covers ~35 languages; falls back to a generic </> glyph). Pair with the media_image renderer for a project_codebase-style hero that scales to whatever cell the layout assigns. |
code_largest_files | cached | Safe | text, text_block, markdown_text_block, entries, bars, number_series, badge | Ranks the largest tracked source files in the discovered git repo. metric = "loc" (default) counts text lines per file; metric = "bytes" measures raw size. Text headlines the single biggest file; TextBlock / MarkdownTextBlock / Entries / Bars carry the per-file ranking; NumberSeries sketches the size distribution; Badge flags whether the repo holds a refactor-candidate-sized file (tidy / big / bloated / monster). Vendored / generated dirs, lockfiles, and binaries are skipped via the shared scan helper. |
code_loc | cached | Safe | text, text_block, markdown_text_block, entries, bars, ratio, number_series, badge | Counts lines per language across tracked source files in the discovered git repo (extension-based classification, vendored / generated dirs and lockfiles skipped). Text summarises totals; TextBlock / MarkdownTextBlock / Entries / Bars rank languages; Ratio exposes the primary language's share; NumberSeries sketches the distribution; Badge tiers the codebase by size. The unit option toggles raw / kloc / percent display. |
code_todos | cached | Safe | text, text_block, markdown_text_block, entries, bars | Greps tracked source files in the discovered git repo for TODO: / FIXME: style markers (trailing colon required, vendored / generated dirs skipped). Text summarises "N TODOs in M files", TextBlock and MarkdownTextBlock list path:line: snippet (markdown variant uses inline-code formatting), and Entries / Bars rank files by hit count. |
codex_subscription | cached | Safe | ratio, text, text_block, markdown_text_block, entries, bars, badge, timeline | Codex CLI subscription utilisation, parsed from the local session JSONL. Each token_count event Codex writes carries the 5h (primary) and 7d (secondary) rate-limit windows; we read the most recent one. No HTTP — re-fetching this would mean making a billable inference call. |
codex_usage | cached | Safe | text, text_block, markdown_text_block, entries, bars, number_series, badge | Token and cost rollup from local Codex CLI session JSONL files. Aggregates per-turn usage under the chosen since window and groups it by project, model, or day. Pricing is bundled, so the splash works offline. |
crypto_trending | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, bars | Top trending coins on CoinGecko (ranked by user search activity over the last 24h). No API key required. Companion to the shipped crypto_watchlist — same source, but CoinGecko picks the list instead of the user. |
crypto_watchlist | cached | Safe | entries, text, text_block, markdown_text_block, linked_text_block, number_series, point_series, bars, badge | CoinGecko price snapshot for a configurable list of coins. Entries (default) / Text / TextBlock / MarkdownTextBlock / LinkedTextBlock summarise spot price + 24h change; NumberSeries carries the first coin's 7-day hourly price as cents above the period low (so high-magnitude assets like BTC don't flatten the sparkline); PointSeries carries one series per coin for line / scatter charts; Bars ranks coins by 24h |% change| (basis points); Badge flags the top mover. No API key required. |
deal_free_games | cached | Safe | linked_text_block, text_block, markdown_text_block, text, entries, bars, image_linked_list, badge, timeline | Free games and loot offers aggregated across Epic Games, Steam, Amazon Prime Gaming, GOG, Humble, itch.io, Apple App Store, and Google Play via the LootScraper feed. platform = "all" (default) merges every source; pick a specific platform to filter. kind = "loot" switches to the Twitch-drops / in-game-item variant (Amazon and Steam only). |
deal_games | cached | Safe | linked_text_block, text_block, markdown_text_block, text, entries, bars, image_linked_list, badge, timeline | Cross-store gaming deals via the public CheapShark API. Spans Steam, GOG, Epic, Humble, Fanatical, GreenManGaming, and more (filter via stores). Sorted by savings; the min_discount floor keeps the list focused on actually-meaningful discounts. No API key required. |
deal_steam_daily | cached | Safe | linked_text_block, text_block, markdown_text_block, text, entries, bars, image_linked_list, badge, timeline | Steam's official daily deals RSS feed — currently-running individual game discounts curated by Valve. Each entry parses into [Steam] <Game> <N>% off. Complements deal_games (CheapShark) which spans every store; this one mirrors Steam's storefront priority order. |
deariary_on_this_day | cached | Safe | text_block, timeline, text, markdown_text_block, linked_text_block, entries, badge | Past auto-generated deariary.com entries from the same calendar day, fetched in parallel for 1m / 3m / 6m / 1y / 2y / 3y / 4y / 5y ago. Anchors with no entry are silently skipped. TextBlock is the default; Timeline plots the surviving anchors chronologically; LinkedTextBlock is a list of clickable rows; Text and Badge headline the most distant hit. |
deariary_recent | cached | Safe | timeline, text, text_block, markdown_text_block, linked_text_block, entries, badge, calendar | Recent auto-generated deariary.com entries, newest first. Timeline (default) carries the chronological ranking; TextBlock / Entries / MarkdownTextBlock / LinkedTextBlock carry the same ranking in their respective row formats; Calendar highlights this month's entry days; Text and Badge summarise the headline. |
deariary_today | cached | Safe | text_block, text, markdown_text_block, linked_text_block, entries, badge | The most recent auto-generated deariary.com entry — typically today's, falling back to yesterday's when today's hasn't generated yet. Aggregated from external tools (GitHub, Calendar, Slack, Linear, ...); requires the Advanced plan. TextBlock shows the body, MarkdownTextBlock preserves formatting for text_markdown, LinkedTextBlock is a one-line clickable headline that opens the entry on deariary.com, Entries summarises title / date / tags / sources, Text is a one-line headline, Badge is a status pill. |
git_age | cached | Safe | text, text_block, markdown_text_block, linked_text_block, entries, number_series, bars, calendar, badge, timeline | Repository age from the first commit reachable from HEAD. Text/TextBlock/Markdown/Linked variants format the duration; Entries/Bars/NumberSeries expose the years/months/days split; Calendar highlights the first-commit day; Badge tags an age tier; Timeline emits the first-commit event. |
git_blame_heatmap | cached | Safe | heatmap, text | Per-file churn over the last 52 weeks: rows are the seven most-touched files, columns are weeks, cells are commit counts. Use it to spot hotspots; pair with git_commits_activity if you want overall cadence instead of per-file breakdown. |
git_churn | cached | Safe | entries, bars, text_block, markdown_text_block, text | Top files by change count over the last N days (default 30, override with format = "N"), capped at ten. Pairs with code_largest_files for 'where's the action vs where's the mass' framing. |
git_commits_activity | cached | Safe | heatmap, number_series, text | GitHub-style commit calendar for the last 52 weeks, with today's week in the rightmost column. Pick this for overall repo cadence; git_blame_heatmap breaks the same window down by file. |
git_contributors | cached | Safe | bars, entries, text_block, markdown_text_block, text | Top commit authors over the last N days (default 30, override with format = "N"), ranked by commit count and capped at ten. Bars/Entries/TextBlock/MarkdownTextBlock all carry the ranking; Text is the headline summary. |
git_latest_tag | cached | Safe | text, entries | Most recent git tag by committer time, suitable as a "latest release" line. Text shows just the tag name; Entries adds the short commit hash and ISO date. |
git_recent_commits | cached | Safe | timeline, text_block | Newest commits on HEAD, defaulting to ten (override with format = "N"). Timeline shows relative-ago labels; TextBlock is a flat <short> <summary> list. |
git_repo_name | cached | Safe | text | Repository name as a single line, suitable for a hero header. Derived from the origin remote (parsed as owner/name); falls back to the working directory's basename when no remote is configured. |
git_stash_count | cached | Safe | text, entries, badge | Number of entries in the stash reflog, as a quiet reminder of work parked aside. Text collapses to empty when there are zero stashes; Entries always reports the count; Badge shows the count as a pill (Ok at zero, Warn otherwise). |
git_status | cached | Safe | entries, text, badge | Working-tree snapshot: current branch, clean/dirty flag, and ahead/behind counts vs upstream. Choose Entries for a key/value panel, Text for a one-liner, or Badge for a clean/dirty traffic light. |
git_worktrees | cached | Safe | entries, text_block | Linked worktrees plus the main worktree, each with its checked-out branch and path. Useful when you juggle several feature branches in parallel checkouts. |
github_action_history | cached | Safe | number_series, timeline, point_series, bars | Recent CI workflow runs as a pass/fail sparkline (NumberSeries), a timeline of the last N runs, a duration scatter plot of (run_number, seconds) for spotting CI slowdowns (PointSeries), or a passed/failed count breakdown (Bars). Use github_action_status instead for just the current main-branch state. |
github_action_status | cached | Safe | badge, text, entries | The latest CI workflow run for a repo as a pass/fail badge or short text line. Use github_action_history for a series of recent runs rather than the single most recent one. |
github_assigned_issues | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open issues assigned to the authenticated user across every repo. Pairs with github_my_prs, github_review_requests, and github_notifications to cover the personal queue. |
github_avatar | cached | Safe | image | A GitHub user's avatar PNG, downloaded once a day and rendered as an image. Useful as the visual hero next to a github_user text block. |
github_contributions | cached | Safe | heatmap, number_series | The GitHub contribution calendar (kusa) as a year-long heatmap of daily commit counts. Defaults to the authenticated viewer; pass login to show another user. NumberSeries collapses the calendar to one value per week for sparkline-style rendering. |
github_contributors_monthly | cached | Safe | bars, linked_text_block, entries, text_block, markdown_text_block, text | Top contributors to a repo over the last N days, ranked by commit count. Bars / Entries / LinkedTextBlock / TextBlock / MarkdownTextBlock all carry the ranking; Text collapses to a "@alice +42 / @bob +27 / …" headline. |
github_good_first_issues | cached | Safe | linked_text_block, text_block, entries, timeline | Open issues labelled good-first-issue, either across all of GitHub or scoped to one repo via the repo option. Aimed at onboarding contributors and idle-browsing for something to pick up. |
github_languages | cached | Safe | bars, entries, text_block, markdown_text_block, text | Language byte-count breakdown for a repo, sorted by size. Bars / Entries / TextBlock / MarkdownTextBlock carry the full ranking with percent values; Text collapses to a "Rust 87% · TOML 8% · …" headline. Languages beyond limit collapse into a single other bucket so totals stay honest. |
github_my_prs | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open pull requests authored by the authenticated user across every repo. Use github_repo_prs instead to list PRs against one specific repo regardless of who opened them. |
github_notifications | cached | Safe | linked_text_block, text_block, entries, timeline, badge | The authenticated user's GitHub notification inbox, unread by default, with each row tagged by reason (mention, review_requested, etc.). Set all = true to include already-read notifications. |
github_recent_releases | cached | Safe | linked_text_block, text_block, entries, timeline | Latest published releases for a repo with their tags and dates. Good for the cd-into-project view of what shipped recently. |
github_repo | cached | Safe | entries, text_block, text | Repo identity for the current directory: slug, description, and SPDX license. Use github_repo_stars instead for the social counters (stars, forks, watchers). |
github_repo_issues | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open issues for a target repo, sorted by most recently updated, with pull requests filtered out client-side. Use github_assigned_issues for the personal queue across all repos. |
github_repo_prs | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open pull requests for a target repo, sorted by most recently updated. Use github_my_prs instead for PRs authored by the authenticated user across all repos. |
github_repo_stars | cached | Safe | text, text_block, markdown_text_block, entries, bars, badge | Social counters for a repo: stargazers, forks, watchers, and open-issue count. Use github_repo instead for the identity fields (slug, description, license). |
github_review_requests | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open pull requests where the authenticated user is a requested reviewer, across every repo. The other side of github_my_prs for the personal queue. |
github_user | cached | Safe | text_block, text, entries | GitHub profile data for a user (display name, bio, location, join year, follower counts), aimed at the hero / subtitle band of a home preset. Pair with github_avatar for the matching image. |
gitlab_my_mrs | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open merge requests authored by the authenticated GitLab user across every project. Use gitlab_repo_mrs instead to list MRs against one specific project regardless of who opened them. |
gitlab_pipeline_status | cached | Safe | badge, text, entries | Latest CI pipeline run for a GitLab project as a pass/fail badge, short text line, or status rollup. |
gitlab_repo_issues | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open issues against one specific GitLab project. Mirrors github_repo_issues for GitLab. |
gitlab_repo_mrs | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open merge requests against one specific GitLab project. Use gitlab_my_mrs instead for MRs you authored across every project. |
gitlab_repo_stars | cached | Safe | text, text_block, markdown_text_block, entries, bars, badge | Social counters for a GitLab project: stargazers, forks, and open-issue count. GitLab has no separate watchers count, so that row is omitted relative to the GitHub sibling. |
gitlab_review_requests | cached | Safe | linked_text_block, text_block, markdown_text_block, image_linked_list, entries, text, bars, badge, timeline | Open merge requests where the authenticated GitLab user is a reviewer. Mirror of github_review_requests for GitLab. |
hackernews_top | cached | Safe | linked_text_block, text_block, entries | Hacker News front-page listings — top / new / best / ask / show / job. Each row shows score, comment count, and title, linked to the story URL (or the HN comment page when there isn't one). |
hackernews_user | cached | Safe | entries, text, linked_text_block, text_block | Profile rollup for one Hacker News account — login, karma, join date, submission count, and bio. Use hackernews_user_submissions for that user's recent stories or hackernews_user_comments for their recent comments. |
hackernews_user_comments | cached | Safe | linked_text_block, text_block | Recent comments by one Hacker News account, each truncated and linked to the comment page on HN. Pair with hackernews_user_submissions for stories by the same user, or hackernews_user for the profile rollup. |
hackernews_user_submissions | cached | Safe | linked_text_block, text_block, entries | Recent stories submitted by one Hacker News account (story / show / ask / job — comments are excluded). Use hackernews_user_comments for that user's recent comments instead. |
huggingface_trending | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, bars | Trending models, datasets, or spaces on Hugging Face Hub via the public ?sort=trendingScore API (no auth required). Companion to the planned github_trending / wikipedia_trending family — each surface picks its own list, this one is HF's. |
lastfm_charts | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, bars | Last.fm's global chart of top artists or top tracks across every scrobble — "what the world is listening to right now". No user binding, no rolling window. The Last.fm slot in the *_trending family alongside crypto_trending / huggingface_trending. |
lastfm_scrobbles_today | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, badge, timeline | Today's scrobbles for a Last.fm user, with the currently-playing track surfaced when one is in flight. Reads user.getRecentTracks since UTC midnight; intentionally bounded to today so the cached splash doesn't drift across day boundaries. |
lastfm_top_albums | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, ratio, number_series, bars, badge | Top albums for a Last.fm user over a rolling window (7day default, also 1month / 3month / 6month / 12month / overall). Mirrors the profile page's Top Albums tab. ImageLinkedList shape carries the album artwork from Last.fm's image set. |
lastfm_top_artists | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, ratio, number_series, bars, badge | Top artists for a Last.fm user over a rolling window (7day default, also 1month / 3month / 6month / 12month / overall). Mirrors the profile page's Top Artists tab. |
lastfm_top_tracks | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, ratio, number_series, bars, badge | Top tracks for a Last.fm user over a rolling window (7day default, also 1month / 3month / 6month / 12month / overall). Mirrors the profile page's Top Tracks tab. |
linear_cycle | cached | Safe | ratio, text, text_block, markdown_text_block, linked_text_block, entries, number_series, bars, calendar, badge | Linear cycle (sprint) progress — completed/total issues, days remaining, burndown sparkline. Ratio is the headline (completion fraction); NumberSeries carries the daily completed-count history; Bars breaks down issue states; Calendar highlights cycle days + issue due dates; Badge summarises on-track vs at-risk vs behind. |
linear_issues | cached | Safe | linked_text_block, text, text_block, markdown_text_block, entries, bars, calendar, badge, timeline | Linear issues snapshot with filter-first options (status, assignee, team, project, priority, due window, label). Bars groups by group_by (default priority). Calendar highlights due dates; list shapes link each row to the Linear issue. |
linear_notifications | cached | Safe | linked_text_block, text, text_block, markdown_text_block, entries, bars, badge, timeline | Linear inbox snapshot — mentions, assignments, comments, status changes — with structured filters for read state, type, and team. List shapes link each row to the originating issue. |
lobsters_top | cached | Safe | linked_text_block, text_block, text, markdown_text_block, entries, bars, timeline | Lobsters front-page listings — hottest / newest / active, optionally filtered by a single tag. Each row shows score, comment count, and title, linked to the story URL (or the Lobsters comment page when there isn't one). |
nasa_apod | cached | Safe | image, text, text_block, markdown_text_block, linked_text_block, entries | NASA's Astronomy Picture of the Day — a fresh curated space photograph each day. The default Image shape renders the picture; text shapes surface the title, explanation, and date. On the occasional video day the image shape errors while text shapes still render. |
net_gateway | cached | Safe | text, text_block, markdown_text_block, entries, badge | 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. |
net_interfaces | cached | Safe | entries, text, text_block, markdown_text_block, ratio, bars, badge | Every host network interface with its up/down state, primary IP, MTU and MAC. Entries (default) / TextBlock / MarkdownTextBlock list one row per interface; Text headlines the primary (default-route) interface; Ratio is the up-of-total fraction; Bars ranks interfaces by total bytes transferred; Badge is an online / offline pill. |
net_ip | cached | Safe | text, text_block, markdown_text_block, entries, badge | The host's own IPv4 / IPv6 addresses. Text (default) shows one address for the primary (default-route) interface — kind picks v4 / v6 / first-available; TextBlock / MarkdownTextBlock / Entries list every interface that has an address; Badge flags dual-stack / IPv4 / IPv6-only / no-address. |
net_listening_ports | cached | Safe | entries, text, text_block, markdown_text_block, badge | Sockets the host is currently accepting connections on, with the owning process. Entries (default) maps port to process; Text headlines the count and the leading port list; TextBlock / MarkdownTextBlock list one row per socket; Badge is a count tier. Useful per-directory for confirming a dev server actually came up after cd. protocol (default tcp — LISTEN is TCP-specific), family, exclude_loopback, and limit (1..=50) filter the result. |
net_mac | cached | Safe | text, text_block, markdown_text_block, entries, badge | Link-layer (MAC) addresses. Text (default) shows the MAC of the interface option's target — the primary (default-route) interface by default; TextBlock / MarkdownTextBlock / Entries list every interface that has a MAC; Badge flags whether the selected MAC is universally administered or locally administered (i.e. randomized / spoofed). |
net_proxy | realtime | Safe | entries, text, text_block, markdown_text_block, badge | The shell's $*_PROXY environment. Entries (default) / TextBlock / MarkdownTextBlock roll up http_proxy / https_proxy / no_proxy; Text shows the proxy that actually carries traffic (HTTPS first), or (direct); Badge is a proxied / direct pill. |
net_speedtest | cached | Safe | text, text_block, markdown_text_block, entries, bars, badge | Measured internet bandwidth — runs a real download / upload test against the fixed speed.cloudflare.com endpoint and reports connection capacity (not whatever happens to be flowing now). Text (default) headlines down + up; TextBlock / MarkdownTextBlock / Entries roll up download / upload / latency; Bars is download vs upload; Badge tiers the connection by download speed. No API key required. |
net_vpn | cached | Safe | badge, text, text_block, markdown_text_block, entries | Whether this host is currently routing through a VPN tunnel. Badge (default) is a connected / disconnected pill — disconnected is Warn, since the widget exists because the user wants to know when the tunnel is down. Text names the active VPN interface and its address; TextBlock / MarkdownTextBlock / Entries list every active tunnel. Detects netdev Tunnel / Ppp types plus name-prefix fallback for WireGuard, OpenVPN-tun, IPsec, NordLynx, ProtonVPN, Cisco AnyConnect, and GlobalProtect. |
news_9to5google | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | 9to5Google — Android, Pixel, and broader Google service news. |
news_9to5mac | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | 9to5Mac — Apple ecosystem news (Mac, iPhone, iPad, services). |
news_a_list_apart | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | A List Apart — long-running web standards and design writing. |
news_ai_news | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | artificialintelligence-news.com — industry AI / ML news desk, complement to long-form newsletters like Import AI. |
news_aljazeera | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Al Jazeera English aggregate news feed. |
news_android_authority | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Android Authority — Android phones, reviews, and Google ecosystem coverage. |
news_android_police | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Android Police — Android phones, apps, and Google product news. |
news_appleinsider | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | AppleInsider — Apple ecosystem news, rumors, and reviews. |
news_arstechnica | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Ars Technica section feeds. Sub-feeds cover the front page, features, tech policy, science, and gaming culture. |
news_bbc | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | BBC News headline feed. Sub-feeds cover world, top stories, business, technology, science, and politics. |
news_bleeping_computer | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Bleeping Computer's news desk, focused on malware, ransomware, and patch reporting. |
news_bloomberg | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Bloomberg section feeds. Sub-feeds cover markets (default), technology, business, politics, economics, and wealth. |
news_carbon_brief | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Carbon Brief — climate science, policy, and energy reporting. |
news_cbs | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | CBS News top stories. |
news_coindesk | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | CoinDesk — cryptocurrency and blockchain industry news. |
news_css_tricks | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | CSS-Tricks — CSS, HTML, and JavaScript tips and articles. |
news_daring_fireball | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Daring Fireball — John Gruber's long-running blog on Apple, design, and software. |
news_dark_reading | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Dark Reading — enterprise security news and analysis. |
news_deadline | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Deadline — Hollywood breaking news and box office reporting. |
news_decrypt | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Decrypt — crypto, Web3, and AI news with a consumer lens. |
news_distrowatch | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | DistroWatch — Linux distribution release announcements and database updates. |
news_dpreview | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | DPReview — digital camera reviews, gear announcements, and industry news. |
news_dw | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Deutsche Welle English — Germany's international broadcaster. |
news_economist | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | The Economist Business section. |
news_engadget | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Engadget consumer-electronics headlines. |
news_eurogamer | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Eurogamer video-game news from the UK / EU desk. |
news_forbes | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Forbes Business section — companies, markets, and entrepreneurship. |
news_fortune | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Fortune — corporate strategy, executives, and market trends. |
news_france24 | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | France 24 English-language international news. |
news_fstoppers | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Fstoppers — professional photography and videography community. |
news_ft | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Financial Times technology section, the FT subset that doesn't require a subscription to read in-app. |
news_gizmodo | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Gizmodo consumer-electronics + nerd-culture headlines. |
news_graham_cluley | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Graham Cluley's security blog — practical, accessible coverage of threats and breaches. |
news_guardian | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | The Guardian section feeds. Sub-feeds cover world, UK, US, business, technology, and science. |
news_hackaday | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Hackaday — DIY electronics + maker projects daily. |
news_hackernoon | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | HackerNoon's site-wide latest stories. |
news_hugging_face_blog | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Hugging Face — research, tooling, and model-release write-ups from the HF team and community. |
news_ifixit | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | iFixit Blog — repairability news, teardowns, and right-to-repair advocacy. |
news_ign | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | IGN — broad video-game and entertainment news with reviews. |
news_import_ai | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Jack Clark's weekly Import AI newsletter, covering policy + research developments. |
news_indiewire | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | IndieWire — independent film, festival, and award-season coverage. |
news_inside_climate | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Inside Climate News — climate investigative journalism. |
news_its_foss | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | It's FOSS — Linux, open-source applications, and tutorials. |
news_kotaku | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Kotaku — video-game news, criticism, and culture writing. |
news_krebs | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Brian Krebs's investigative reporting on cybercrime. |
news_lwn | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | LWN.net headlines — kernel + Linux ecosystem long-form. |
news_macrumors | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | MacRumors — Apple rumors, news, and product reviews. |
news_marketwatch | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | MarketWatch top stories — US-leaning market news. |
news_mit_tr_ai | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | MIT Technology Review — AI coverage subset of the broader publication. |
news_nasa_news | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | NASA breaking-news feed — mission updates, science releases, agency announcements. |
news_nature | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Nature, the weekly international science journal. |
news_new_scientist | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | New Scientist — magazine-style coverage of science and technology. |
news_npr | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | NPR top stories headline feed. |
news_omg_ubuntu | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | OMG! Ubuntu — Ubuntu / GNOME desktop app + distro news. |
news_pc_gamer | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | PC Gamer — PC-focused gaming news, hardware reviews, and previews. |
news_petapixel | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | PetaPixel — photography news, tutorials, and gear coverage. |
news_phoronix | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Phoronix Linux hardware, kernel, and benchmarking news. |
news_phys_org | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Phys.org — physics, materials science, and broader hard-science coverage. |
news_pitchfork | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Pitchfork — music criticism, news, and reviews. |
news_politico | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Politico — US politics and policy reporting. |
news_polygon | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Polygon video-game news + culture coverage. |
news_propublica | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | ProPublica — investigative journalism on US institutions and policy. |
news_quanta_magazine | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Quanta Magazine, long-form math / physics / biology / computer science journalism. |
news_rockpapershotgun | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Rock Paper Shotgun, PC-game-centric news and features. |
news_schneier | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Bruce Schneier's blog — long-form security commentary + weekly squid post. |
news_sciencedaily | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | ScienceDaily — research news across all scientific fields. |
news_scientific_american | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Scientific American global English-language feed. |
news_sky_news | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Sky News world headlines. |
news_slashdot | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Slashdot — news for nerds, stuff that matters. |
news_smashing_magazine | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Smashing Magazine — front-end + UX + accessibility articles. |
news_space_com | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Space.com — space news, astronomy, and skywatching guides. |
news_spacenews | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | SpaceNews — commercial + government space industry coverage. |
news_stereogum | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Stereogum — indie / alternative music news and commentary. |
news_techcrunch | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | TechCrunch startups + venture news. Default is the all-stories feed. |
news_techpowerup | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | TechPowerUp — PC component news, driver releases, and database updates. |
news_techradar | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | TechRadar — consumer technology product news and reviews. |
news_the_block | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | The Block — investigative crypto industry journalism. |
news_the_gradient | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | The Gradient — long-form essays on AI / ML research. |
news_the_hacker_news | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | The Hacker News — daily cybersecurity news and analysis. |
news_the_register | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | The Register — UK-based enterprise IT news with a distinctive voice. |
news_theverge | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | The Verge section feeds. Sub-feeds cover the front page, gaming, tech, entertainment, and science. |
news_threatpost | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Threatpost — vulnerability and malware reporting. |
news_tomshardware | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Tom's Hardware — PC component + benchmark news. |
news_universe_today | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Universe Today — astronomy + space exploration daily. |
news_ux_collective | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | UX Collective — Medium publication on UX design, research, and practice. |
news_variety | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Variety — entertainment industry news (film, TV, music, theater). |
news_venturebeat | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | VentureBeat — tech industry news with a startup-funding lens. |
news_vg247 | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | VG247 — video-game news, deals, and guides. |
news_vox | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Vox — explanatory journalism on politics, policy, and culture. |
news_wired | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | WIRED section feeds. Sub-feeds cover the front page, business, culture, gear, science, and security. |
news_wsj | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Wall Street Journal section feeds. Sub-feeds cover markets (default), tech (WSJ.D), world, and opinion. |
news_xda | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | XDA Developers — Android customization, ROMs, and developer-focused phone news. |
news_yahoo_finance | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Yahoo Finance — US-leaning aggregated market and business headlines. |
news_yale_climate | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Yale Climate Connections — climate science + policy reporting. |
news_zdnet | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | ZDNET — enterprise technology news, reviews, and analysis. |
project_manifest | cached | Safe | text, entries, text_block, markdown_text_block, badge | Reads project metadata from the nearest manifest file found by walking up from the process CWD — Cargo.toml, package.json, pyproject.toml, go.mod, or composer.json. Text emits the version string (useful as a hero subtitle); Entries delivers name / version / description / license as key/value rows; TextBlock lists the same fields as human-readable lines; MarkdownTextBlock formats them as a styled block; Badge shows the version with a tone derived from license permissiveness (permissive → ok, copyleft → warn, unknown → warn). |
random_cat | cached | Safe | image | A random cat picture from cataas.com, downloaded each refresh cycle and rendered as an image. Optional tag filters by mood (cute / orange / kitten / …). |
random_dog | cached | Safe | image | A random dog photo from dog.ceo, downloaded each refresh cycle and rendered as an image. Optional breed (e.g. shiba, husky) and sub_breed (with breed) narrow the pool. |
random_fortune | realtime | Safe | text_block, text | Picks one bundled Unix-style fortune cookie, advancing once per calendar day. Distinct from random_quote: cookies are anonymous and irreverent and may span multiple lines (haikus, short verses), with no attribution line. |
random_quote | realtime | Safe | text_block, text | Picks one quote-and-author pair from a bundled collection, advancing once per calendar day. Distinct from random_fortune, which serves anonymous Unix-style fortune cookies; this one always carries an attribution line. |
reddit_subreddit_posts | cached | Safe | linked_text_block, image_linked_list, text_block, entries | Posts from a single subreddit's public listing — top / hot / new / rising, with a period window for top. Pair with reddit_user_posts for one user's submissions or reddit_user_comments for their comments. |
reddit_trending | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, bars | Trending posts across all subreddits via Reddit's public /r/popular.json listing — what Reddit picks as hot site-wide right now. Distinct from reddit_subreddit_posts (a specific sub) and reddit_user_posts (one account's submissions). |
reddit_user_comments | cached | Safe | linked_text_block, text_block, entries | Recent comments by a single Reddit user, each prefixed with subreddit and score and linked to the comment's permalink. Use reddit_user_posts for that user's submissions or reddit_subreddit_posts for a subreddit's listing. |
reddit_user_posts | cached | Safe | linked_text_block, image_linked_list, text_block, entries | Recent submissions by a single Reddit user. Use reddit_user_comments for that user's comments instead, or reddit_subreddit_posts to follow a subreddit rather than a person. |
rss | cached | Network | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, image, timeline | Generic feed reader for any RSS 2.0 / RSS 1.0 / Atom / JSON Feed URL, parsed via feed-rs. Each row shows the entry's published date and title, optionally linked. Trust-gated because the URL is config-controlled. |
steam_charts | cached | Safe | bars, entries, text_block, markdown_text_block, linked_text_block, image_linked_list, text, number_series, image, badge | Global most-played games on Steam right now, ranked by concurrent in-game count. Reads the public ISteamChartsService/GetMostPlayedGames endpoint (no auth) and resolves game names via parallel appdetails calls — the Steam slot in the *_trending family. |
steam_owned_games | cached | Safe | bars, entries, text_block, markdown_text_block, linked_text_block, image_linked_list, text, ratio, number_series, image, badge | The configured Steam user's library ranked by total minutes (sort = "playtime", default) or by most-recently launched (sort = "recent"). Complement to steam_recently_played over the all-time window. |
steam_player_summary | cached | Safe | text_block, text, markdown_text_block, linked_text_block, image_linked_list, entries, badge, image | The configured Steam user's profile snapshot: persona name, level, online status, currently-playing game, and last-logoff timestamp. Reads GetPlayerSummaries and GetSteamLevel in parallel. |
steam_recently_played | cached | Safe | bars, entries, text_block, markdown_text_block, linked_text_block, image_linked_list, text, ratio, number_series, image, badge | Games the configured Steam user has launched in the last two weeks, with per-game minutes from playtime_2weeks. The Text shape sums the window for a steam_playtime_week-style headline; Bars / Entries break it out per game. |
stock_watchlist | cached | Safe | entries, text, text_block, markdown_text_block, linked_text_block, number_series, point_series, bars, badge | Yahoo Finance price snapshot for a configurable list of tickers. Entries (default) / Text / TextBlock / MarkdownTextBlock / LinkedTextBlock summarise spot price + intraday change vs previous close; NumberSeries carries the first ticker's 5-day intraday price as cents above the period low (so high-magnitude tickers don't flatten the sparkline); PointSeries carries one series per ticker for line / scatter charts; Bars ranks tickers by |% change| (basis points); Badge flags the top mover. No API key required. |
system_info_bios | realtime | Safe | text | BIOS / UEFI firmware identification (vendor / version / release date), via DMI. Linux only; other platforms render "n/a". |
system_info_board | realtime | Safe | text | Motherboard vendor or model, via DMI. Linux only; other platforms render "n/a". |
system_info_cpu | realtime | Safe | text | Static CPU identifier: model name / core count / base frequency / vendor. Use for hero or attribution lines; pair with system_monitor_cpu for live load. |
system_info_desktop | realtime | Safe | text | Desktop session identifier: desktop environment ($XDG_CURRENT_DESKTOP family), window manager protocol (wayland / x11 / Quartz / DWM), or init system (systemd / launchd / wininit). |
system_info_env | realtime | Safe | text | Command preference from environment: $EDITOR / $VISUAL / $PAGER. Emits the binary basename (e.g. nvim), or "(unset)" when empty. |
system_info_host | realtime | Safe | text | Single static host identifier picked by kind: terminal emulator, OS name, OS version label, hostname, login shell, or CPU architecture. Use for hero / attribution lines where one field carries the splash. |
system_info_kernel | realtime | Safe | text | Kernel name (Linux / Darwin / Windows NT / ...) or version string from sysinfo. |
system_info_locale | realtime | Safe | text | Resolved POSIX locale (LC_ALL > LC_CTYPE > LANG, fallback C). |
system_info_machine | realtime | Safe | text | Physical machine identity from DMI / SMBIOS: vendor / model / serial / chassis type. Linux reads /sys/class/dmi/id/*; non-Linux platforms render "n/a" until IOKit / WMI bindings land. |
system_info_memory | realtime | Safe | text | Installed memory capacity: RAM total or swap-area total, byte-formatted ("31.3 GB"). |
system_info_timezone | realtime | Safe | text | IANA timezone name, resolved from $TZ or the /etc/localtime symlink target (e.g. Asia/Tokyo). |
system_monitor_battery | realtime | Safe | ratio, text, entries, badge, pixel_art | Charge level and state of the primary (or index-selected) battery. Ratio drives gauges, Text formats a summary line whose field is picked by kind, and Entries rolls up charge / state / time-left / cycles / health. Hosts without a battery render a steady "AC" placeholder. |
system_monitor_cpu | realtime | Safe | ratio, text, pixel_art | Aggregated CPU usage across all cores, sampled every frame. Pair with a gauge renderer for a live meter or use the Text shape for a plain percentage. |
system_monitor_disk | cached | Safe | ratio, text, bars | Disk usage for the largest mounted volume. Ratio drives gauges with the used/total fraction; Text formats it as "45% of 500 GB"; Bars lists every mount with used bytes for chart_bar. |
system_monitor_host | realtime | Safe | entries, text_block | Host snapshot rollup combining OS / hostname / uptime / load / CPU% / memory% into one block. Entries is the default; TextBlock collapses each row to "key: value". For a single static identifier (terminal / shell / arch / etc) use system_info_host. |
system_monitor_load | realtime | Safe | text, entries | Unix 1 / 5 / 15-minute load averages. Text joins the three values on one line; Entries splits them into separate rows. Reads as "n/a (windows)" on Windows, which has no equivalent counter. |
system_monitor_memory | realtime | Safe | ratio, text, entries | RAM utilisation as a used/total ratio. Text formats as "6.4 GiB / 16 GiB" and Entries breaks it into used / total / free rows. |
system_monitor_processes | realtime | Safe | entries, text_block | Top five processes by current CPU usage, refreshed every frame. Entries pairs each process name with its percentage; TextBlock collapses to one process per line. |
system_monitor_uptime | realtime | Safe | text | Time since the host last booted, formatted as a compact "3d 4h" / "2h 15m" / "45m" string. |
todoist_tasks | cached | Safe | linked_text_block, text, text_block, entries, timeline, badge | Todoist task snapshot, sorted by due date and priority, with structured filters for due window, projects, labels, and priority. Badge summarises overdue/total counts; list shapes show each task with its due label and priority and link back to the Todoist app. |
weather | cached | Safe | entries, text, point_series, number_series, bars, badge, pixel_art | Forecast for a fixed (latitude, longitude) via Open-Meteo. Entries / Text summarise current conditions; PointSeries carries the next 24h of hourly temperature (signed °C / °F); NumberSeries / Bars carry hourly precipitation in tenths of mm/inch; Badge flags severe weather codes (thunderstorm = error, freezing / snow / heavy rain = warn); PixelArt paints a 16×16 truecolor sprite of the current sky. Metric or imperial units, no API key required. |
weather_forecast | cached | Safe | text_block, text, entries, ratio, number_series, point_series, bars, badge, timeline | Daily multi-day forecast for a fixed (latitude, longitude) via Open-Meteo. TextBlock / Entries / Text summarise highs / lows / precipitation per day; Ratio reports the worst precipitation probability in the window; NumberSeries carries per-day rainfall totals (tenths of mm or inch) for sparkline / histogram consumers; Bars carries per-day precipitation probability (%) so the bar chart stays informative even in dry forecasts; PointSeries carries high+low temperature curves across days; Badge flags the worst weather code; Timeline lays the days out chronologically. days defaults to 3 (range 1..=7), metric units by default, no API key required. |
wikipedia_featured | cached | Safe | linked_text_block, image_linked_list, text_block, text | Today's English Wikipedia "Today's Featured Article" — the daily curated front-page pick, with title, summary, and link. Use wikipedia_on_this_day for historical events on this date or wikipedia_random for an arbitrary article. |
wikipedia_on_this_day | cached | Safe | linked_text_block, text_block, text, timeline | Events that happened on today's calendar date in history, sourced from Wikipedia's on-this-day feed (selected highlights, events, births, deaths, holidays, or all). Use wikipedia_featured for today's featured article or wikipedia_random for an arbitrary page. |
wikipedia_random | cached | Safe | linked_text_block, image_linked_list, text_block, text | An arbitrary Wikipedia page summary (title, extract, link), drawn from the language edition's random endpoint. Refresh interval controls how often a new article is picked. Use wikipedia_featured for the curated daily article or wikipedia_on_this_day for date-anchored history. |
wikipedia_trending | cached | Safe | linked_text_block, image_linked_list, text_block, text, markdown_text_block, entries, bars | Most-viewed Wikipedia articles for the previous UTC day via the public Wikimedia pageviews API. Filters out Main_Page, search, and meta-namespace pages so the list is real articles. Companion to the shipped wikipedia_featured (today's curated pick) and wikipedia_random. |
youtube_channel | cached | Safe | linked_text_block, text_block, text, markdown_text_block, image_linked_list, entries, image, timeline | Recent uploads from one or more public YouTube channels, merged newest-first. Reads each channel's Atom feed at youtube.com/feeds/videos.xml; no API key or OAuth required. |