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.

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
V.Spl	Split vertical	`Ctrl-A v`
H.Spl	Split horizontal	`Ctrl-A s`
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 v / s`	Split vertical / horizontal (Dvorak home row)
`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

3.3 KiB Raw Blame History