Terminal interfaces from YAML

BoxMux

BoxMux turns a YAML file into a terminal interface. You describe boxes, their positions and what goes in them, and BoxMux draws them, runs their scripts, and handles the keyboard and the mouse.

Version 0.240.3373 29 June 2026 Release notes

What it is

A box shows text, the output of shell scripts run once or on an interval, a menu whose entries run scripts, an interactive program in an embedded terminal, a chart, a table, or content drawn by a plugin. A running instance is controlled from other programs through a local socket.

  • Interfaces as configuration. Layouts, boxes, positions and what each box shows are written in YAML. Unknown keys and invalid values are load errors that name the place in the file.
  • Scripts as content. A box reruns its script on an interval, and a menu entry shows its script’s output in a new tab of its box.
  • Embedded terminals. A box runs an interactive program in a terminal of its own, with its input, signals and restarts controlled from the socket.
  • Charts, tables and plugins. Data is drawn as charts and tables, or by a plugin.
  • Controlled from outside. boxmux replace_box_content, add_box, switch_active_layout and the other socket commands change a running interface from any program.

Install

  • crates.io

    cargo install boxmux
  • Downloads

    For Linux x86_64, macOS (Apple silicon) and macOS (Intel), each with its SHA-256.

    Every download

Documentation

Source and licence

Licence
MIT License