Skip to content
max1abPublic

About

TUI for clash

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

clash-tui

intro

A terminal UI for controlling Mihomo via its HTTP REST API. For learning purposes only.

Features

  • Proxies — View proxy groups, switch selector nodes, test delays
  • Config — View and modify running configuration (mode, log-level, etc.)
  • Rules — Browse routing rules with type filtering
  • Connections — View active connections, kill individual or all

Installation

# Install Go 1.21+
snap install go --classic

# Build
git clone <repo> && cd clash-tui
go build -o clash-tui .

Usage

# Quick start (defaults to 127.0.0.1:9090, no secret)
./clash-tui

# Custom host and secret via CLI flags
./clash-tui --host http://127.0.0.1:19090 --secret mysecret

# Or via config file (~/.config/clash-tui/config.json)
# { "host": "http://127.0.0.1:19090", "secret": "mysecret" }

Key Bindings

Key Global
1-4 Switch tabs
Tab / h l Next/previous tab
q / Ctrl+C Quit
Key Proxies Tab
↑ ↓ / j k Navigate
Enter Expand group / Switch node
d Test delay
r Refresh
Key Config Tab
↑ ↓ / j k Navigate fields
Enter Edit / Toggle
↑ ↓ Cycle enum options
Esc Cancel edit
Key Connections Tab
d Kill selected connection
D Kill all connections (confirm)
Key Rules Tab
f Cycle type filter

TODO

  • Re-enable and redesign Logs with proper streaming handling (avoid timeout-based polling errors).
  • Re-enable and stabilize Traffic Monitor refresh behavior and UI presentation.

Mihomo Configuration

Ensure your mihomo config has the external controller enabled:

external-controller: 127.0.0.1:19090
secret: "your-secret"

About

TUI for clash

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages