<

Termux Command Hub

Termux Command Hub
Web
A fullstack web application designed to manage better Termux active processes and commands.

Termux is a terminal emulator for Android that allows users to run a Linux environment on their mobile devices. This makes possibleto make an old smartphone a home server but managing processes remotely can be challenging.

The application allows users to start, stop, and monitor termux commands remotely through a user-friendly web interface.

Since Docker is not natively supported on Android, PM2 is used as a process manager to keep commands running in the background and restart them if they crash.
Nest JS

Nest JS

Vite JS

Vite JS

PM2

PM2

TypeScript

TypeScript

TailwindCSS

TailwindCSS

Termux

Termux

Fullstack Development

Fullstack Development

Process Management

Process Management

WebSockets

WebSockets

Visit Repo
README.md

šŸ¤– CMD Hub: Termux Process Manager

A high-performance, full-stack dashboard built to manage automation scripts and system processes directly from your Android device.

šŸ—ļø Architecture

  • Backend: NestJS (Node.js framework) - Running on Port 9090
  • Frontend: Vite + Tailwind CSS - Running on Port 5050
  • Orchestration: PM2 (Process Manager 2)
  • Environment: Optimized for Termux / Android

šŸš€ Quick Start

Ensure you are in the project root directory, then grant execution permissions to the launcher and run it:

chmod +x launch.sh
./launch.sh

What does the launch script do?

  • Installs Dependencies: Runs npm install for both Client and Server.
  • Builds Assets: Compiles NestJS into /dist and Vite into static assets.
  • PM2 Integration: Checks for PM2, installs it if missing, and initializes the ecosystem.config.cjs.
  • Process Management: Clears old instances to prevent port conflicts and starts the fresh production build.

šŸ› ļø Project Structure

ā”œā”€ā”€ client/                 # Vite + Tailwind v4 source
ā”œā”€ā”€ server/                 # NestJS Backend source
ā”œā”€ā”€ launch.sh               # Master build & deploy script
ā””ā”€ā”€ ecosystem.config.cjs    # PM2 process configuration

šŸ“Š Management Commands

Once the hub is running, use these standard PM2 commands to monitor your system:

TaskCommand
Check Statuspm2 status
View Live Logspm2 logs
Monitor Resourcespm2 monit
Stop Everythingpm2 stop all
Restart Hubpm2 restart ecosystem.config.cjs

šŸŒ Network Configuration

By default, the services are mapped as follows:

[!TIP] To access this dashboard from another device on the same Wi-Fi, replace localhost with your phone's internal IP (found via 'ip addr show' in Termux).

āš ļø Requirements & Troubleshooting

Node.js: Ensure nodejs-lts is installed via 'pkg install nodejs-lts'.

Storage: This project requires approximately 400MB of space for node_modules.

Port Conflicts: If a build fails, run pm2 kill and try again.

ML-Powered Suggestions

i

How it works:

I use a MiniLM-L6 transformer model to turn project descriptions into mathematical vectors.

By calculating the Cosine Similarity between these vectors, the model identifies semantically related work.

Analyzing project similarities...