System Monitoring Dashboard – Terminal User Interface (SMD-TUI)

Refer to MANUAL for operational details (10 minutes read time).

Table of Contents

• Introduction
• Features
• Installation
• Configuration
• Usage
• Troubleshooting
• Help
• Appendix

Introduction

A high-density, real-time telemetry instrument for Linux terminals, engineered in pure Bash. SMD-TUI provides aviation-grade stability with fixed-width metrics, responsive layouts, and zero-overhead stateful tracking.

Features

• Responsive Layout
  Auto-switches between 2-column (≥80 cols) and 1-column modes.

• Stateful Telemetry
  Tracks I/O deltas using native Bash associative arrays (no subshells).

• Dynamic Scaling
  Auto-detects external drives and adjusts the UI matrix.

• Safety Valves
  Prevents terminal scrolling cascades with height warnings.

• Visual Rigidity
  Strict printf formatting prevents UI jitter during load spikes.

Installation

Prerequisites

• Bash 4.0+
• awk, sed, grep, coreutils
• lm-sensors (temperature)
• sysstat (CPU load)
• acpi (battery)
• iproute2 (network)

Quick Install

1. Clone the repository

   git clone https://github.com/your-username/smd-tui.git
   cd smd-tui

2. Run the installer

   ./install.sh

The installer will place smd-tui in ~/.local/bin or /usr/local/bin.

Manual Install

1. Make executable

   chmod +x smd-tui

2. Move to path

   sudo mv smd-tui /usr/local/bin/

Configuration

Edit the following variables at the top of the script for your hardware:

• FAN_MAX_RPM
  Maximum fan speed (e.g., "7927").

• BATTERY_ID
  Battery identifier (e.g., "BAT0", "BAT1").

• TEMP_ZERO_TIMEOUT
  Grace period for 0°C readings.

Usage

Launch the dashboard:

   smd-tui

Options

• --no-drives
  Suppress external drive detection.

• --accent-color [C]
  Set accent color (cyan, purple, orange, green, red, white, black).

• --help
  Display man-page style help.

• --version
  Show version metadata.

Exit

Press q or Ctrl+C.

Troubleshooting

• Missing Dependencies
  Run ./install.sh again or manually install packages (sysstat, lm-sensors, etc.).

• Layout Glitches
  Ensure your terminal uses a monospaced font and is at least 80x25.

• Permissions
  If I/O speeds show 0.00, ensure you have read access to /sys/class/.

Help

The script includes a built-in "Man Page" style help viewer:
Invoking ./smd-tui --help pipes a documentation into the less pager, allowing for scrolling and searching within the help text.

Appendix

Disclaimer

Use at your own risk. This script is provided “as is”; there is NO WARRANTY at all. This is free software: you are free to modify it to your needs and redistribute it under the MIT License.

Contributing

See CONTRIBUTING.md for guidelines on code style, testing, and pull requests.

Author

Copyright (c) 2026 RML Tec Dev
Contributions and feedback are welcome via rmltecdev@pm.me

License

Licensed under the MIT License — see LICENSE for details.

Version

Version: 1.0.2
Build Date: 2026-08-06