Terminal UI

lox tui is a full-screen, keyboard-first live view of your installation — btop for your house.

lox tui --demo

Table of contents

  1. Start
  2. Screens
  3. Keys worth knowing
  4. Config history
  5. Safety
  6. Preferences

Start

lox tui                        # the current context, on the screen you left last
lox tui --demo                 # a simulated house, no Miniserver needed: try this first
lox tui --screen energy        # start on: home | rooms | events | energy | system | sites
lox tui -r Küche               # Rooms, with a room selected
lox tui --read-only            # wall display or screen sharing: nothing is ever sent
lox --ctx office tui           # another Miniserver (switch live with C or on Sites)
Flag Effect
--theme night (default), day, mono, neon; --no-color / NO_COLOR picks mono
--icons nerd Nerd Font icons (plain Unicode by default)
--no-mouse Keep the terminal’s own text selection
--no-motion No animations (also LOX_NO_MOTION=1)

Screens

Key Screen What’s there
1 Home Room cards, what needs attention (open windows, low batteries, offline devices), pinned controls, a live feed
2 Rooms Every control with its live value, grouped by room, category or type
3 Events Every state change as it happens, filterable, with “what happened just before”
4 Energy Animated PV / home / grid / battery flow, meters, today’s curve
5 System CPU, heap, devices, CAN bus and LAN, the Miniserver log, config history with logic diffs, firmware
6 Sites All your Miniservers (contexts) at a glance

On any control: w opens its wiring (the config logic around it, with live values on the wires: why is this light on?), c its history chart (6 h to a year, with period compare).

Keys worth knowing

Key Action
? The keys for where you are (every pane’s border also shows the ones in reach)
: or Ctrl-K Palette: fuzzy go-to for rooms, controls, scenes, and any lox command
␣ Primary action (toggle, open/close)
+ - = Step up, step down, set an exact value
m / a Pick a mood or mode / all actions
y Copy the equivalent lox command, for scripts
* Pin to Home
Esc Back one step: never quits
q Close the popup; on a screen, quit

All keys: COMMANDS.md › Terminal UI.

Config history

System › Config lists your config repo’s snapshots with their logic diffs. ⏎ browses a snapshot (pages, blocks, Lox Logic source, / search), m marks a commit to compare any two, w opens a changed block’s wiring at that snapshot, P pulls a new backup.

Safety

Lights, blinds and moods act instantly. Doors, gates, the alarm, the wallbox, door openers wired as push-buttons and anything on your confirm: list ask y/N first; reboot and firmware update ask you to type the context name.

# ~/.lox/config.yaml (or the context entry)
confirm:
  - Pool Abdeckung [Pool]

Preferences

~/.lox/tui.yaml:

theme: night          # night | day | mono | neon
icons: plain          # plain | nerd
motion: true
mouse: true
transparent: false    # keep the terminal background
roles:                # energy role overrides: meter name or UUID → grid | pv | battery | load
  Balcony PV: pv

Pins, mutes, palette history and the last screen are kept per context in tui-state.yaml.