TUIStatusBar
DocsTUIStatusBar

StatusBar

Powerline-style status bar with colored segments

Quick Start

main.py
from connectonion.tui import StatusBar from rich.console import Console console = Console() status = StatusBar([ ("๐Ÿค–", "co/gemini-2.5-pro", "magenta"), ("๐Ÿ“Š", "50%", "green"), ("", "main", "blue"), ]) console.print(status.render())
output
๐Ÿค– co/gemini-2.5-pro ๐Ÿ“Š 50% main

Segments

Text Segments

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

Progress Segments

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

ProgressSegment

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

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

Star us on GitHub

If ConnectOnion saves you time, a โญ goes a long way โ€” and earns you a coffee chat with our founder.