Skip to main content

Vicuña

Vicuña is an extensible, browser-based serial monitor and terminal for embedded Linux consoles, microcontroller development and general serial diagnostics. Its Go server and web interface are embedded in one executable, so it can run on a workstation, Raspberry Pi or other Linux host without a separate frontend deployment.

Interfaces

  • Terminal — interactive VT100/ECMA-48-style operation with ANSI colour, cursor control, alternate-screen support, paste, navigation keys and scrollback.
  • Monitor — timestamped RX/TX logging with visible control characters, optional ANSI colour and export.
  • Hex — binary-safe rows with offsets, timestamps, ASCII equivalents and export.

Serial controls

Vicuña provides port discovery, common and custom baud rates, framing options, break, buffer reset, local echo, selectable line endings and text or hexadecimal transmission.

Hardware modules can reinterpret DTR, RTS, CTS, DSR, RI and DCD as device-specific controls. For example, the included pt1 module presents its power switch and fault signal using the language of the hardware rather than generic modem-line names.

Deployment

The application uses a JSON configuration file and listens on 127.0.0.1:8080 by default. Optional password protection, light and dark themes, and a systemd service make it suitable for persistent use on a lab host.

go build -trimpath -o vicuna .
./vicuna

Project files