# sethmux

Mobile-first web terminal powered by [ttyd](https://github.com/tsl0922/ttyd) + [tmux](https://github.com/tmux/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

```bash
# 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

```bash
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