achester88
open main menu

Tuimenu

Screenshot of tuimenu in terminal

tuimenu is a simple Rust-based program intended for easily opening tui and cli applications from a simple terminal. It allows for simple “aliasing” of commands and quick launching of tui programs from one menu.

Installation

tuimenu can be installed via cargo:

cargo install tuimenu

or built from this repo:

  • Prerequisites: rustc, cargo

Step 1: Clone repo

git clone https://github.com/achester88/tuimenu
cd tuimenu

Step 2: Build via Cargo

cargo build --release

Step 3: Running

cd target/release
#Then make the tuimenu binary executable
chmod +x ./tuimenu
#Then to run it
./tuimenu

Adding Programs

To add a program to tuimenu, navigate to ~/tuimenu/list.json, and add each program as its own object.

[
  {
    "cmd": "{NAME OF COMMAND}",
    "desc": "{TEXT TO BE SHOWN WITH COMMAND}",
    "args": ["ARG", "BY", "SPACE"] //Optional
  },
]

Example Setup

2025-09-24-170954_hyprshot

tuimenu/list.json

[
  {
    "cmd": "btop",
    "desc": "A terminal monitor of resources"
  },
  {
    "cmd": "dooit",
    "desc": "A TUI todo manager for the terminal"
  },
  {
    "cmd": "wofi",
    "desc": "A graphical program launcher",
    "args": ["--show", "drun"]
  }
]