> ## Documentation Index
> Fetch the complete documentation index at: https://e-gurl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Interactive TUI

> Experimental Bubble Tea TUI with vim navigation and mouse support

# Interactive TUI (Experimental)

DNS-MNS v8.0.4 introduces an experimental interactive Terminal User Interface (TUI) built with [Bubble Tea](https://github.com/charmbracelet/bubbletea). This provides a modern, navigable interface with vim-style keybindings.

<Warning>
  **Experimental Feature**: The TUI is marked as experimental. Some features may be incomplete or change in future releases.
</Warning>

## Launch

```bash theme={null}
dns-mns tui
```

## Features

* **Searchable Menu**: Type `/` to search and filter menu items
* **Vim Navigation**: Use `j`/`k` for up/down, `h`/`l` for back/forward
* **Mouse Support**: Click to select items and navigate screens
* **Dark/Light Themes**: Automatic theme detection with manual override support
* **Breadcrumb Navigation**: Always know where you are in the interface

## Key Bindings

### Navigation

| Key                 | Action                          |
| ------------------- | ------------------------------- |
| `↑` / `↓`           | Navigate menu items             |
| `j` / `k`           | Navigate menu items (vim-style) |
| `Enter`             | Select item                     |
| `Backspace` / `h`   | Go back                         |
| `q` / `Esc`         | Quit / Cancel                   |
| `Tab` / `Shift+Tab` | Navigate between fields         |

### Search

| Key      | Action          |
| -------- | --------------- |
| `/`      | Start searching |
| `Ctrl+U` | Clear search    |
| `Esc`    | Cancel search   |

### Global

| Key      | Action     |
| -------- | ---------- |
| `?`      | Show help  |
| `Ctrl+C` | Force quit |

## Screens

### Main Menu

The main menu provides access to all DNS-MNS features:

* **Dashboard** - Real-time DNS health monitoring
* **Test DNS** - Test DNS servers by category
* **Recommend** - Get smart DNS recommendations
* **Encrypted DNS** - DoH/DoT/DNSCrypt testing + proxy start/stop
* **Security** - Censorship detection, blocked domain checks
* **Proxy** - Start/stop DNS proxies
* **Evasion** - DPI evasion tools and setup guides
* **Tunnels** - DNSTT/Slipstream/Paqet profile workflows and runtime controls
* **Leak Test** - DNS leak detection
* **System Diagnostics** 🩺 - OS info, network, permissions, DNS capabilities
* **Settings** - Configure preferences, check for updates

### Dashboard

Live-updating view showing:

* Current system DNS configuration
* DNS server health (ping, query time, packet loss)
* Proxy status (DNSCrypt, DoH/DoT, Fallback)
* Real-time updates every 10 seconds

### Test Results

Interactive results view with:

* Color-coded latency values
* Detailed server information
* **Press Enter on any reachable result to apply it as your system DNS immediately**

### Encrypted DNS

Test and manage encrypted DNS protocols:

* Test DoH/DoT providers for latency and reliability
* **DoH health check** — verify DNS-over-HTTPS JSON API for common domains
* **Start/Stop DNSCrypt proxy** on `127.0.0.1:5356`
* Start/Stop DoH/DoT proxy

### Security & Privacy

* Censorship detection (active blocking/poisoning checks)
* **Blocked domain status** — check Twitter, YouTube, Telegram, GitHub, and other commonly censored domains for poisoning or blocking

### System Diagnostics

New in v8.0.4. Accessible from the main menu with the 🩺 icon:

* OS, architecture, hostname
* Admin/root status and DNS modification permissions
* Network interfaces and current DNS servers
* Ping and query capability checks
* Warnings and suggestions for your configuration

### Evasion

Advanced censorship circumvention tools with setup guides:

* Sing-box status and config export
* **ShadowTLS setup guide** — TLS traffic camouflage via sing-box

### Tunnels

Profile-based tunnel workflows:

* Create/list/select/import/export tunnel profiles
* Start/stop runtime (when tunnel binaries are available in PATH)
* Resolver scan and health checks (with optional auto-switching)

### Settings

* Theme switching (dark / light / nocolor)
* Clear system DNS
* **Check for updates** — see current vs latest version with download link

## Mouse Support

The TUI supports mouse interaction:

* Click menu items to select
* Click buttons to activate
* Scroll for long lists
* Click breadcrumb to navigate back

## Themes

The TUI automatically detects your terminal's color scheme. You can also set it manually in Settings:

* **Auto** - Detect from terminal
* **Dark** - Dark color scheme
* **Light** - Light color scheme

## Requirements

* Terminal with ANSI escape code support
* Terminal with alternate screen buffer support
* Mouse support requires terminal that supports mouse events

Most modern terminals (iTerm2, GNOME Terminal, Windows Terminal, Alacritty, etc.) support all features.

## Exit to Shell

Press `q` or `Esc` from the main menu to exit the TUI and return to your shell. Any running operations will complete before exit.