Skip to main content

​
Interactive TUI (Experimental)

DNS-MNS v8.0.4 introduces an experimental interactive Terminal User Interface (TUI) built with Bubble Tea. This provides a modern, navigable interface with vim-style keybindings.
Experimental Feature: The TUI is marked as experimental. Some features may be incomplete or change in future releases.

​
Launch

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

KeyAction
↑ / ↓Navigate menu items
j / kNavigate menu items (vim-style)
EnterSelect item
Backspace / hGo back
q / EscQuit / Cancel
Tab / Shift+TabNavigate between fields
KeyAction
/Start searching
Ctrl+UClear search
EscCancel search

​
Global

KeyAction
?Show help
Ctrl+CForce quit

​
Screens

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.