A unified, high-performance Terminal User Interface (TUI) for headless Android management in Termux.

TermNode is a single compiled Go binary that turns your old Android phone into a fully manageable headless server. Instead of juggling raw SSH commands, messy bash scripts, and scattered termux-api calls, TermNode gives you a beautiful terminal dashboard — right in your Termux session.

It was designed for the growing community of users repurposing Android devices as home servers, media hubs, network nodes, and IoT gateways.

Go compiles to a single, statically linked binary for aarch64. Termux users can wget a release from GitHub and run it instantly — no Python environments, no dependency nightmares, no bloated runtimes. Just one file.

Real-time monitoring of your device's critical hardware metrics, powered by termux-api:

• Battery percentage, status, health, and temperature
• CPU usage, core count, architecture, and temperature
• WiFi SSID, local IP address, and BSSID
• Auto-refreshes every 5 seconds
• Visual battery gauge with color-coded status

One-toggle controls for critical background services:

• Wake Lock — Prevents Android's battery optimization from killing your processes
• SSH Server — Instantly start/stop the OpenSSH daemon for remote access
• HTTP File Server — Spin up a Go-powered file server on port 8081 to serve files from your home directory

No more memorizing port flags or digging through documentation.

Turn your Android phone into a data collection hub for microcontrollers:

• Built-in HTTP webhook receiver on port 8080
• POST sensor data from any ESP32, Arduino, or IoT device:

  curl -X POST http://<phone-ip>:8080/webhook/temperature -d '{"value":23.5}'

• All events are persisted to a local SQLite database
• Scrollable, real-time event log in the terminal
• Health check endpoint at GET /health

Full keybinding reference and feature documentation, always one keypress away.

┌─────────────────────────────────────────────────┐
│ 1:Dashboard  2:Services  3:IoT Log  4:Help      │
│─────────────────────────────────────────────────│
│ ┌──────────────────┐ ┌──────────────────┐       │
│ │ Battery          │ │ System           │       │
│ │                  │ │                  │       │
│ │ Level:    85%    │ │ WiFi SSID: MyNet │       │
│ │ Status:   CHARG… │ │ Local IP:  192.… │       │
│ │ Health:   GOOD   │ │ BSSID:     AA:B… │       │
│ │ Temp:     32.1°C │ │                  │       │
│ │ Current:  450 mA │ │ CPU              │       │
│ │                  │ │                  │       │
│ │ [████████░░░░░]  │ │ Usage:  12.3%   │       │
│ └──────────────────┘ │ Cores:  8        │       │
│                      │ Temp:   41.2°C   │       │
│                      │ Arch:   aarch64  │       │
│                      └──────────────────┘       │
└─────────────────────────────────────────────────┘

# In Termux
pkg install golang termux-api

# Grant termux-api permissions in Android settings
# Test it works:
termux-battery-status

git clone https://github.com/Mr-Dark-debug/termnode.git
cd termnode
go mod tidy
go build -o termnode .
./termnode

# Download the latest release (when available)
wget https://github.com/Mr-Dark-debug/termnode/releases/latest/download/termnode-arm64 -O termnode
chmod +x termnode
./termnode

Usage: termnode [options]

Options:
  -db string     Path to SQLite database (default "$HOME/.termnode/termnode.db")
  -port string   HTTP webhook listen address (default ":8080")
  -debug         Enable debug logging to debug.log
  -version       Print version and exit

All dependencies are pure Go — zero CGO required. This is critical for Termux where the CGO toolchain may not be available.

termnode/
├── main.go                         # Thin entry point
├── internal/
│   ├── app/                        # Root TUI model & routing
│   ├── daemon/                     # Wake-lock & process management
│   ├── hardware/                   # termux-api polling & parsing
│   ├── iot/                        # HTTP webhook server
│   ├── db/                         # SQLite repository layer
│   ├── screen/                     # Individual TUI screens
│   └── theme/                      # Lipgloss styles & colors
├── migrations/                     # SQL schema (embedded in binary)
└── plan/                           # Development plans & docs

┌─────────────┐    tea.Tick(5s)    ┌──────────────┐
│  termux-api  │ ────────────────▶ │  Dashboard   │
│  /proc/stat  │   UpdateMsg       │  Screen      │
└─────────────┘                    └──────────────┘

┌─────────────┐    Enter key       ┌──────────────┐
│  daemon.     │ ────────────────▶ │  Services    │
│  Manager     │   Toggle()        │  Screen      │
└─────────────┘                    └──────────────┘

┌─────────────┐    HTTP POST       ┌───────┐    chan    ┌──────────────┐
│  ESP32 /    │ ────────────────▶ │  IoT  │ ────────▶ │  IoT Log     │
│  curl /     │   /webhook/{topic}│ Bridge│  Event    │  Screen      │
│  Arduino    │                    └───────┘           └──────────────┘
                                         │
                                         ▼
                                  ┌──────────────┐
                                  │   SQLite     │
                                  │   Database   │
                                  └──────────────┘

Send sensor data to TermNode from any HTTP-capable device.

Request:

curl -X POST http://192.168.1.100:8080/webhook/temperature \
  -H "Content-Type: application/json" \
  -d '{"sensor":"DHT22","value":23.5,"unit":"celsius"}'

Response:

{"status":"ok"}

ESP32 Arduino Example:

HTTPClient http;
http.begin("http://192.168.1.100:8080/webhook/temperature");
http.POST("{\"sensor\":\"DHT22\",\"value\":23.5}");
http.end();

Health check endpoint for monitoring.

Response:

{"status":"ok"}

# Default build
go build -o termnode .

# With version info
go build -ldflags="-X main.version=$(git describe --tags)" -o termnode .

# With MQTT support (future)
go build -tags mqtt -o termnode .

# Cross-compile from desktop
GOOS=android GOARCH=arm64 go build -o termnode-android .

make           # Build
make run       # Build and run
make test      # Run tests
make debug     # Build and run with debug logging
make clean     # Remove binary and logs
make deps      # Download and tidy dependencies

• Termux (from F-Droid or GitHub releases)
• Go 1.22+ (pkg install golang)
• termux-api (pkg install termux-api) — for hardware dashboard
• termux-api app — install the Termux:API Android app for API access
• OpenSSH (pkg install openssh) — optional, for SSH server feature

• MQTT subscriber (behind build tag)
• Tailscale/Ngrok tunnel management
• Process supervision with auto-restart
• Configuration file support
• GitHub Actions CI/CD for automated releases
• AUR/brew package
• Real-time charts in the terminal (asciigraph)

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing)
5. Open a Pull Request

MIT License — see LICENSE for details.

• Bubble Tea — The elegant TUI framework
• Lip Gloss — Terminal styling
• modernc.org/sqlite — Pure Go SQLite
• Termux — The Android terminal emulator that makes this possible

Built with love for the r/termux community.