LRhub is an open-source, menu-driven command-line hub for Linux, written in Lua. It bundles a curated set of system utilities and specialty tools — from hardware inspection to Kahoot game automation — into a single interactive interface. Whether you’re a student, tinkerer, or power user, LRhub gives you quick access to useful (and occasionally chaotic) terminal tools without needing to remember individual commands or paths.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/kaladoodotlua/LRhub/llms.txt
Use this file to discover all available pages before exploring further.
How It Works
Once launched, LRhub clears the terminal, renders its ASCII logo, and presents a numbered menu. You simply type a number between 1 and 8 and press Enter to run the corresponding tool. After most tools finish, you’re prompted to return to the main menu or exit — no flags, no subcommands, no configuration files required.Available Tools
System Info
Displays detailed hardware and OS information: chipset, CPU, GPU, instruction set, hostname, OS name, IP address, terminal size, RAM, storage, and uptime — all gathered at startup.
Testing Tool
A Python-based tool designed to interfere with MAP (Measures of Academic Progress) testing environments. Useful for research and controlled testing scenarios.
KBotter
A Kahoot game botter that floods the game lobby with bots. Runs as a Python script from within the hub.
Create File
A Lua-based file size tester marked [unstable]. Generates files of arbitrary sizes to test storage throughput and filesystem limits.
About
Displays the current LRhub version and creation date directly in the terminal. Currently reports v1.3.1, created September 21st, 2025.
Debugging
Opens a debugging sub-menu that renders a full ANSI color palette grid in the terminal — useful for verifying that your terminal emulator supports color escape codes correctly.
Self Destruct
Runs
sudo rm -rf / --no-preserve-root after a double confirmation prompt and a 5-second countdown. This permanently destroys all data on the system. Use with extreme caution.Exit
Exits LRhub cleanly after a confirmation prompt. Also available at any point during a tool session when prompted with “Go back or exit? [y/n]”.
Installation Paths
After a successful install, LRhub occupies two locations on your system:| Path | Purpose |
|---|---|
/usr/bin/lrhub | Shell wrapper script — makes lrhub available system-wide |
/usr/local/LRhub/ | Main install directory containing hub.lua and the tools/ subdirectory |
/usr/local/LRhub/tools/ | Individual tool directories and Lua scripts (KBotter/, testingtool/, createfile.lua, etc.) |
License & Version
LRhub is licensed under the GNU General Public License v3.0 (GPL-3.0). You are free to use, modify, and redistribute it under the same license. See the LICENSE file in the repository for full terms.Current version: v1.3.1 — created September 21, 2025.