ConnectOnionConnectOnion
DocsTUIStatusBar

StatusBar

Powerline-style status bar with colored segments

Quick Start

main.py
1from connectonion.tui import StatusBar 2from rich.console import Console 3 4console = Console() 5 6status = StatusBar([ 7 ("๐Ÿค–", "co/gemini-2.5-pro", "magenta"), 8 ("๐Ÿ“Š", "50%", "green"), 9 ("", "main", "blue"), 10]) 11console.print(status.render())
Python REPL
Interactive
๐Ÿค– co/gemini-2.5-pro ๐Ÿ“Š 50% main

Segments

Text Segments

main.py
1# (icon, text, color) 2segments = [ 3 ("๐Ÿค–", "gpt-4", "magenta"), 4 ("๐Ÿ’ฐ", "$0.02", "yellow"), 5 ("", "main", "blue"), 6]

Progress Segments

main.py
1from connectonion.tui import StatusBar, ProgressSegment 2 3status = StatusBar([ 4 ("๐Ÿค–", "gpt-4", "magenta"), 5 ProgressSegment(percent=78, bg_color="green"), 6]) 7# Output: ๐Ÿค– gpt-4 โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘ 78%

ProgressSegment

main.py
1ProgressSegment( 2 percent: float, # 0-100, how much used 3 bg_color: str = "green", 4 width: int = 10, 5 show_percent: bool = True, 6)

Styles

  • โ€ขUses powerline arrows for segment transitions
  • โ€ขFalls back to unicode on terminals without powerline fonts
  • โ€ขWorks on both light and dark terminals

Example Output

๐Ÿค– co/gemini-2.5-pro  ๐Ÿ“Š 50%   main