OmnySSH

TUI SSH dashboard & server manager — manage all your servers from a single terminal window

Features • Installation • Quick Start • Documentation • Contributing

Why OmnySSH?

Managing multiple SSH servers shouldn't require juggling terminal tabs, remembering IP addresses, or running the same commands over and over. OmnySSH brings dashboard-style monitoring, visual file management, and command automation into a single, lightweight TUI.

Stop switching between tools. Start managing smarter.

Features

📊 Live Metrics Dashboard

Server cards with real-time CPU, RAM, and disk usage. Color-coded thresholds (green → yellow → red) make it easy to spot issues at a glance.

📁 Visual File Manager

Split-panel SFTP browser (local ↔ remote) with progress bars, multi-selection, and intuitive keyboard shortcuts. No more memorizing scp syntax.

⚡ Command Snippets

Save frequently-used commands and execute them on any server with one keypress. Broadcast a command to multiple hosts simultaneously.

🖥️ Multi-Session Terminal

PTY tabs and split-view for working on several servers at once. Switch between hosts without leaving the app.

🔍 Fuzzy Search

Find any host or snippet instantly. Type a few letters, get instant results.

🎨 4 Built-in Themes

Choose from Default, Dracula, Nord, or Gruvbox. Switch themes on the fly with --theme.

⌨️ Configurable Keybindings

Remap global shortcuts in one TOML file. Make OmnySSH work the way you work.

🌍 Cross-Platform

Linux, macOS, Windows. Single static binary, no runtime dependencies.

Comparison

Installation

⚡ Quick Install (Recommended)

One command to install on Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/timhartmann7/omnyssh/main/install.sh | sh

This script auto-detects your OS and architecture, downloads the latest release, and installs it to your PATH.

🍺 Homebrew (macOS/Linux)

brew install timhartmann7/tap/omnyssh

📦 Pre-built Binaries

Download from the Releases page:

Extract and move the binary to your PATH:

tar -xzf omny-*.tar.gz
sudo mv omny /usr/local/bin/

🦀 Cargo (from crates.io)

cargo install omnyssh

🔨 From Source

git clone https://github.com/timhartmann7/omnyssh.git
cd omnyssh
cargo build --release
# Binary at: ./target/release/omny

Quick Start

1. Install OmnySSH (see above)

2. Run the app:

   omny
   

3. Add your first server:

   • Press a in the dashboard
   • Enter hostname, user, and SSH key path
   • Press Enter to connect

4. Try different themes:

   omny --theme dracula
   omny --theme nord
   omny --theme gruvbox
   

5. View full documentation:

   man omny      # Man page with all options
   omny --help   # Quick reference
   

6. Explore features:

   • 1 — Dashboard (live metrics)
   • 2 — File Manager (SFTP browser)
   • 3 — Snippets (saved commands)
   • 4 — Terminal (multi-session)
   • / — Fuzzy search
   • ? — Help popup

Documentation

Man Page (Linux/macOS)

man omny

Usage

omny [OPTIONS]

Options:
  -c, --config <FILE>   Path to a custom config file
  -t, --theme <THEME>   Override the color theme (default | dracula | nord | gruvbox)
  -v, --verbose         Enable debug logging (written to stderr)
  -h, --help            Print help
  -V, --version         Print version

Configuration

Config files live in:

• Linux/macOS: ~/.config/omnyssh/
• Windows: %APPDATA%\omnyssh\

The original ~/.ssh/config is never modified — hosts are imported read-only at startup.

Example: config.toml

[general]
refresh_interval = 30          # seconds between metric refreshes
default_shell = "/bin/bash"
ssh_command = "ssh"            # path to system SSH binary
max_concurrent_connections = 10

[ui]
theme = "default"              # default | dracula | nord | gruvbox
show_ip = true
show_uptime = true
card_layout = "grid"           # grid | list
border_style = "rounded"       # rounded | plain | double

[keybindings]
quit         = "q"
search       = "/"
connect      = "Enter"
dashboard    = "1"
file_manager = "2"
snippets     = "3"

Example: hosts.toml

[[hosts]]
name = "web-prod-1"
hostname = "192.168.1.10"
user = "deploy"
port = 22
identity_file = "~/.ssh/id_ed25519"
tags = ["production", "web"]
notes = "Main web server. Nginx + Node.js"

[[hosts]]
name = "db-master"
hostname = "10.0.0.50"
user = "admin"
port = 2222
tags = ["production", "database"]
notes = "PostgreSQL 16. Don't restart without warning #backend"

Example: snippets.toml

[[snippets]]
name = "Docker: restart all"
command = "cd /opt/app && docker compose down && docker compose up -d"
scope = "global"
tags = ["docker"]

[[snippets]]
name = "Restart service"
command = "sudo systemctl restart {{service_name}}"
scope = "global"
params = ["service_name"]

Themes

Set the theme permanently in config.toml or temporarily via the --theme flag.

Development Roadmap

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for development setup, code conventions, and the PR checklist.

License

Apache 2.0 — see LICENSE.

⭐ Star this repo if you find it useful!

Report Bug • Request Feature • Discussions