Skip to content

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.

AcceptsAnimates
image_linked_listno
OptionTypeRequiredDefaultDescription
max_itemspositive integernoall rowsCap on rendered cards. Truncates from the end when the input has more rows than the cap.
thumbnail_widthcells (u16)no6Width in cells of the thumbnail column. Rows without a thumbnail still consume this width as blank space so the text column stays aligned.
row_heightcells (u16)no3Height 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.
gapcells (u16)no1Horizontal 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.

Overridable via the [theme] section of your dashboard config.

KeyDescription
textPrimary 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_dimBarely-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).
ShapeFetchers
image_linked_listbasic_links, basic_read_store, crypto_trending, deal_free_games, deal_games, deal_steam_daily, github_assigned_issues, github_my_prs, github_repo_issues, github_repo_prs, github_review_requests, gitlab_my_mrs, gitlab_repo_issues, gitlab_repo_mrs, gitlab_review_requests, huggingface_trending, lastfm_charts, lastfm_scrobbles_today, lastfm_top_albums, lastfm_top_artists, lastfm_top_tracks, news_9to5google, news_9to5mac, news_a_list_apart, news_ai_news, news_aljazeera, news_android_authority, news_android_police, news_appleinsider, news_arstechnica, news_bbc, news_bleeping_computer, news_bloomberg, news_carbon_brief, news_cbs, news_coindesk, news_css_tricks, news_daring_fireball, news_dark_reading, news_deadline, news_decrypt, news_distrowatch, news_dpreview, news_dw, news_economist, news_engadget, news_eurogamer, news_forbes, news_fortune, news_france24, news_fstoppers, news_ft, news_gizmodo, news_graham_cluley, news_guardian, news_hackaday, news_hackernoon, news_hugging_face_blog, news_ifixit, news_ign, news_import_ai, news_indiewire, news_inside_climate, news_its_foss, news_kotaku, news_krebs, news_lwn, news_macrumors, news_marketwatch, news_mit_tr_ai, news_nasa_news, news_nature, news_new_scientist, news_npr, news_omg_ubuntu, news_pc_gamer, news_petapixel, news_phoronix, news_phys_org, news_pitchfork, news_politico, news_polygon, news_propublica, news_quanta_magazine, news_rockpapershotgun, news_schneier, news_sciencedaily, news_scientific_american, news_sky_news, news_slashdot, news_smashing_magazine, news_space_com, news_spacenews, news_stereogum, news_techcrunch, news_techpowerup, news_techradar, news_the_block, news_the_gradient, news_the_hacker_news, news_the_register, news_theverge, news_threatpost, news_tomshardware, news_universe_today, news_ux_collective, news_variety, news_venturebeat, news_vg247, news_vox, news_wired, news_wsj, news_xda, news_yahoo_finance, news_yale_climate, news_zdnet, reddit_subreddit_posts, reddit_trending, reddit_user_posts, rss, steam_charts, steam_owned_games, steam_player_summary, steam_recently_played, wikipedia_featured, wikipedia_random, wikipedia_trending, youtube_channel
       splashboard greets on cd         
       docs · 2h                        
                                        
                                        
                                        
[[widget]]
id = "rss"
fetcher = "rss"
render = "list_cards"