sethmux

Mobile-first web terminal powered by ttyd + tmux. One persistent session, multiple tabs, accessible from any browser.

Features

• Single persistent tmux session — shared across all connected clients
• Mobile touch toolbar — on-screen buttons for tabs, signals, navigation, splits, and text selection
• Text selection mode — tap Sel to select and copy text on touch devices
• Push notifications — sethmux-notify "Build done!" sends browser notifications
• PWA installable — add to home screen for app-like experience
• Dark theme — Sethian dark + orange (#D35400) accent

Architecture

Browser -> Caddy (HTTPS + Auth) -> ttyd (port 7683) -> tmux session "sethmux"
                                -> notify-server (port 7684) -> /api/notifications

Quick Start

# Dependencies
apt install -y tmux
curl -sL https://github.com/tsl0922/ttyd/releases/latest/download/ttyd.x86_64 -o /usr/local/bin/ttyd
chmod +x /usr/local/bin/ttyd

# Deploy
sudo mkdir -p /opt/sethmux
sudo cp static/* /opt/sethmux/
sudo cp notify-server.py /opt/sethmux/
sudo cp sethmux-notify /usr/local/bin/
sudo cp config/tmux.conf ~/.tmux.conf
sudo cp systemd/*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now sethmux sethmux-notify

Open http://YOUR_IP:7683 in a browser.

Mobile Toolbar

Appears on screens < 900px. Buttons:

Button	Action	tmux Key
+Tab	New tab	Ctrl-A c
Next/Prev	Switch tabs	Ctrl-A n/p
^C / ^D / Clr	Interrupt / EOF / Clear
Esc / Tab / Up / Down	Navigation
Sel	Text selection mode
Spl	Split vertical	Ctrl-A %
Pane	Cycle panes	Ctrl-A o
Kill	Kill pane/tab	Ctrl-A x

Push Notifications

sethmux-notify "Deploy complete!"
echo "done" | sethmux-notify
make build && sethmux-notify "OK" || sethmux-notify "FAIL"

tmux Keybindings

Prefix: Ctrl-A (not the default Ctrl-B — easier on mobile).

Key	Action
Ctrl-A c	New window
Ctrl-A n / p	Next / previous
Ctrl-A % / "	Split vertical / horizontal
Ctrl-A o	Cycle panes
Ctrl-A x	Kill pane
Alt-1 to Alt-5	Jump to window
Mouse scroll	History

Reverse Proxy (Caddy)

mux.example.com {
    # your auth here
    handle /toolbar.js  { root * /opt/sethmux; file_server }
    handle /manifest.json { root * /opt/sethmux; file_server }
    handle /icon-*.png { root * /opt/sethmux; file_server }
    handle /api/* { uri strip_prefix /api; reverse_proxy localhost:7684 }
    handle { reverse_proxy localhost:7683 }
}

Files

sethmux/
  static/
    index.html          # Custom ttyd page with toolbar injection
    toolbar.js          # Mobile touch toolbar
    manifest.json       # PWA manifest
    icon-192.png        # PWA icon
    icon-512.png        # PWA icon
  config/
    tmux.conf           # Sethian-themed tmux config
  systemd/
    sethmux.service     # ttyd + tmux systemd unit
    sethmux-notify.service  # Notification API unit
  notify-server.py      # Push notification HTTP API
  sethmux-notify        # CLI notification command

License

MIT