Files

T

Brian Krabach 23d1d9c113 chore: retire requirements.txt in favor of pyproject.toml

Addresses code quality suggestion from review: requirements.txt was a
redundant secondary source of truth. Dependencies are now exclusively
managed in pyproject.toml with proper runtime/dev separation.

- requirements.txt: replaced with a comment redirecting to pip install -e '[dev]'
- README.md: updated install command from pip install -r requirements.txt
  to pip install -e '[dev]'

2026-03-28 02:31:15 -07:00

1.1 KiB

Raw Blame History

muxplex

A web-based dashboard for tmux sessions. Access and manage all your tmux sessions from any device — browser, phone, tablet.

Features

Live tile grid showing all running tmux sessions
Click any session to open a full interactive terminal
Bell/activity notifications across sessions
Multi-device support with state sync
Mobile-friendly, responsive, PWA-capable
Works over Tailscale private network

Stack

Backend: Python FastAPI coordinator (coordinator/)
Frontend: Vanilla JS + xterm.js (frontend/)
Terminal: ttyd (WebSocket bridge to tmux)
Proxy: Caddy

Running

# Install dependencies (runtime + dev)
pip install -e ".[dev]"

# Start coordinator (from this directory)
python -m uvicorn coordinator.main:app --host 0.0.0.0 --port 8099

# Start Caddy proxy
caddy run --config Caddyfile

Development

# Run tests
python -m pytest

Brand assets

Design language, tokens, and brand assets in assets/branding/. To regenerate PNG/favicon assets from SVG sources:

python3 scripts/render-brand-assets.py

1.1 KiB Raw Blame History