Embeds a raster image using the best protocol the terminal advertises (kitty, sixel, iTerm2) and falls back to half-block ASCII elsewhere. Honours fit (contain / cover / stretch) plus max_width / max_height / padding for placement.
| Option | Type | Required | Default | Description |
|---|
align | "left" | "center" | "right" | no | "left" | Horizontal placement within the available cell when the image is narrower (after max_width / fit = "contain"). |
fit | "contain" | "cover" | "stretch" | no | "contain" | How the image is sized into its box. contain preserves aspect; cover fills the box and crops overflow; stretch warps to fit. |
max_width | cells (u16) | no | area width | Upper bound on image width in cells. |
max_height | cells (u16) | no | area height | Upper bound on image height in cells. |
padding | cells (u16) | no | 0 | Uniform inset inside the image cell (all four sides). Applied before alignment and sizing. |
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. |
| Shape | Fetchers |
|---|
image | basic_image, basic_read_store, code_language_logo, github_avatar, nasa_apod, 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, random_cat, random_dog, rss, steam_charts, steam_owned_games, steam_player_summary, steam_recently_played, youtube_channel |