⚡ BDH Terminal Engine (bdh-terminal-engine)

A 100% Pure Linux CLI Terminal Multiplexer & Standalone Text Editor, architected & built using an AI-Orchestrated Low-Level C Workflow.

Built for Backend Developers, Systems Engineers, and CLI Enthusiasts.

📌 Overview

BDH Terminal Engine is a lightweight, high-performance terminal multiplexer inspired by tools like tmux and GNU screen, bundled with its own built-in and standalone modal text editor. Architected from the ground up to interact directly with Linux kernel pseudo-terminals (PTY), it manages virtual screen rendering, integrated text editing, and seamless text-based web browsing right inside your active terminal pane — with zero GUI dependencies.

🔥 Key Features

• 🖥️ True Multi-Tab & Multi-Shell Multiplexing Spawn and manage multiple concurrent /bin/zsh or /bin/bash PTY sessions inside a single terminal window with instant keyboard and mouse switching.

• 📝 Built-in & Standalone Modal Text Editor (bdh-edit) Includes a fully functional, lightweight VT100 text editor. Launch it standalone via bdh-edit <filename> from any shell, or toggle it instantly inside the multiplexer engine using Ctrl + E — complete with a blinking block cursor (█) and clean alternate-screen isolation.

• 📱 Responsive Multi-Platform Capacity

  • Linux Desktop / Server Mode: Supports up to 18 concurrent sessions (MAX_SESSIONS 18).
  • Termux / Mobile Mode: Optimized lightweight layout supporting up to 8 concurrent sessions (MAX_SESSIONS 8) for clutter-free mobile screens.

• 🐭 XTerm SGR Mouse Protocol Support Click directly on any tab in the top badge or footer overlay to switch active sessions instantly without touching the keyboard.

• 🔍 Built-in Token Scanner (Ctrl + K) Scan the entire screen dynamically for URLs, IP addresses, UUIDs, and file paths, and copy them directly to your clipboard with a single keystroke.

• 🌐 100% Pure CLI Web Browser Integration Browse documentation, GitHub repositories, and websites directly inside your active tab using links, rendered in sharp, glitch-free ASCII/VT100 text mode (Ctrl + B).

• ⚡ Non-Blocking Asynchronous I/O & Zero-Gap Footer Powered by a responsive select() event loop with a 10ms timeout, ensuring zero input latency while maintaining a permanent, zero-gap Active Sessions Manager Footer Box at the bottom of your screen.

• 🛡️ 16KB Anti-Glitch & Anti-Tearing Buffer Engineered with a high-capacity 16,384-byte I/O buffer to eliminate screen tearing, flickering, and ghosting during heavy stdout bursts or full-screen browser layouts.

• 📦 Lightweight & Zero Bloat Compiles to tiny binaries (bdh-engine and bdh-edit). No X11, Wayland, GTK, or WebKit dependencies required — runs flawlessly on servers, SSH sessions, TTYs, Termux, and Linux desktops.

🏗️ Modular Architecture

The engine is structured into clean, decoupled C modules for maintainability and extensibility:

🛠️ Prerequisites & Installation

1. Install System Dependencies

Arch Linux / Manjaro:

sudo pacman -S --needed gcc make links

Ubuntu / Debian:

sudo apt update && sudo apt install -y build-essential links

Termux (Android):

pkg update && pkg install -y clang make links

2. Build & Install the Project

Clone the repository and compile using the included Makefile:

# Clone repository
git clone https://github.com/BackendDeveloperHub/bdh-terminal-engine.git
cd bdh-terminal-engine

# Build clean executables and install globally
make clean && make && sudo make install

Note for Termux users: Run make clean && make && make install (without sudo).

🚀 Usage

1. Start the Multiplexer Engine

Start the terminal engine directly from any shell (optionally pass a filename to open in the built-in editor):

bdh-engine [optional_filename.txt]

2. Launch the Standalone Text Editor

Open or create a file using the standalone CLI text editor:

bdh-edit filename.tz

⌨️ Keyboard & Mouse Controls / Action Triggers

🏗️ Engineering Notes

Early iterations of bdh-terminal-engine experimented with embedded graphical WebKitGTK windows. However, GUI loops (gtk_main_quit) clashed with the low-level PTY select() loop, adding megabytes of bloat and restricting usage to desktop environments.

By refactoring to a 100% Pure Linux CLI Multiplexer & Modal Editor:

• Zero Crash Rate — Removed all display server (DISPLAY=:0) and GTK signal errors.
• Server & Mobile Ready — Perfectly functional over headless SSH connections, minimal Arch Linux installations, and Termux mobile environments.
• High Performance — Reduced binary size and memory footprint by over 99%.

👨‍💻 Author & Engineering Workflow

Prabakaran202 (Backend Developer Hub - BDH Linux) Systems Architecture & Engineering Design | AI-Assisted Low-Level C Implementation | Python / FastAPI | Arch Linux

A note on modern engineering: This engine was conceptualized, architected, and debugged using an AI-assisted systems engineering workflow — combining human architectural vision with AI-driven code generation for rapid, low-level C development.