Dashboard

The dashboard is a live terminal UI built with Rich's Live display. It shows a real-time message feed alongside database statistics, refreshed on the interval from your configuration.

Launch it

pywacli dashboard

Or pick 1 · Dashboard from the interactive menu (pywacli).

Connect first

The dashboard reads from the database that the Connect session fills. Start pywacli connect in another terminal (and scan the QR) so there's a live feed to display.

What it shows

• Message feed — incoming messages, edits, reactions, and statuses as they arrive.
• Database statistics — counts across the tracked tables (messages, media, conversations, …).
• Live refresh — re-rendered every refresh_interval_sec (default: 1 second).

Themes

Set dashboard.theme in your config (or via pywacli config) to one of:

Theme	Description
default	Balanced colors for most terminals
dark	Tuned for dark terminal backgrounds
light	Tuned for light terminal backgrounds

{
  "dashboard": {
    "refresh_interval_sec": 1,
    "theme": "dark"
  }
}

Press Ctrl+C to exit the dashboard. It doesn't affect the connect session running elsewhere.