basic_links

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).

Kind	Safety	Shapes
realtime	Safe	linked_text_block, text, text_block, markdown_text_block, entries, image_linked_list

Options

Option	Type	Required	Default	Description
links	list of {label, url?, subtitle?, thumbnail?}	no	[]	Pinned links rendered as rows. label is required; url makes the row OSC8-clickable in LinkedTextBlock / ImageLinkedList; thumbnail (file path) lights up the ImageLinkedList variant.

Compatible renderers

Shape	Renderers
linked_text_block	list_links
text	animated_boot, animated_figlet_morph, animated_postfx, animated_scanlines, animated_splitflap, animated_typewriter, animated_wave, text_ascii, text_plain
text_block	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, list_plain
markdown_text_block	text_markdown
entries	animated_boot, animated_postfx, animated_scanlines, animated_splitflap, animated_wave, grid_table
image_linked_list	list_cards

Preview

linked_text_block via list_links

GitHub                                  
Docs                                    
                                        
                                        
                                        

[[widget]]
id = "basic_links"
fetcher = "basic_links"
render = "list_links"

text via text_ascii

▗▛▜▖ ▀   ▟  █ █     ▜▌                                                          
█   ▝█  ▝█▀ █▄█ █ █ ▐▙▄                                                         
▜▖▜▌ █   █▗ █ █ █ █ ▐▌▐▌                                                        
 ▀▀▘▝▀▘  ▝▘ ▀ ▀ ▝▀▝▘▀▝▀                                                         
                                                                                

[[widget]]
id = "basic_links"
fetcher = "basic_links"
render = "text_ascii"

text via text_plain

GitHub                                  
                                        

[[widget]]
id = "basic_links"
fetcher = "basic_links"
render = "text_plain"

text_block via list_plain

GitHub                                  
Docs                                    
                                        
                                        

[[widget]]
id = "basic_links"
fetcher = "basic_links"
render = "list_plain"

markdown_text_block via text_markdown

- GitHub (https://github.com/)          
- Docs (https://example.com/docs)       
                                        
                                        
                                        

[[widget]]
id = "basic_links"
fetcher = "basic_links"
render = "text_markdown"

entries via grid_table

GitHub               https://github.com/
Docs            https://example.com/docs
                                        
                                        
                                        

[[widget]]
id = "basic_links"
fetcher = "basic_links"
render = "grid_table"

image_linked_list via list_cards

       GitHub                           
       source                           
                                        
                                        
                                        

[[widget]]
id = "basic_links"
fetcher = "basic_links"
render = "list_cards"