trustmux 7.0__tar.gz

trustmux-7.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: trustmux
+Version: 7.0
+Summary: Monitor and interact with tmux/Byobu sessions from your phone
+Author-email: Dustin Kirkland <dustin.kirkland@gmail.com>
+License: GPL-3.0-or-later
+Project-URL: Homepage, https://trustmux.app
+Project-URL: Repository, https://github.com/dustinkirkland/byobu
+Project-URL: Issues, https://github.com/dustinkirkland/byobu/issues
+Keywords: tmux,byobu,terminal,mobile,pwa
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Terminals :: Terminal Emulators/X Terminals
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: tornado>=6.0
+
+# Trustmux
+
+A mobile companion for [tmux](https://github.com/tmux/tmux) / [Byobu](https://byobu.org) sessions. Run a lightweight daemon on your workstation; monitor and interact with your terminal sessions from your phone over your Tailscale network. No relay server — terminal data stays between your devices.
+
+Works with **plain tmux** and with **byobu**. Byobu users get the live status bar chips; plain tmux users get everything else.
+
+Two tiers:
+- **Free** — PWA. Install one icon per machine directly from the browser.
+- **Paid** — Native Flutter app with full ANSI colors, multi-machine management, and biometric auth.
+
+---
+
+## Requirements
+
+- tmux (byobu optional but recommended)
+- Python 3.10+
+- [Tailscale](https://tailscale.com) installed, running, and connected
+
+---
+
+## Install
+
+### Homebrew (macOS / Linux)
+
+```bash
+brew tap dustinkirkland/trustmux
+brew install trustmux
+trustmux-enable    # configure tailscale serve + start daemon
+trustmux-pair      # generate pairing code; enter on phone
+```
+
+### pip (PyPI)
+
+```bash
+pip install trustmux
+trustmux-enable
+trustmux-pair
+```
+
+### Debian / Ubuntu (.deb)
+
+```bash
+sudo dpkg -i trustmux_7.0_all.deb
+trustmux-enable
+trustmux-pair
+```
+
+Add the PPA for automatic updates:
+
+```bash
+sudo add-apt-repository ppa:dustinkirkland/trustmux
+sudo apt install trustmux
+```
+
+---
+
+## Daily use
+
+```bash
+trustmux-ctl start      # start daemon
+trustmux-ctl stop       # stop daemon
+trustmux-ctl restart    # restart daemon
+trustmux-ctl status     # show URL and running status
+trustmux-ctl log        # tail the daemon log
+
+trustmux-pair           # generate a pairing code for a new device
+trustmux-unpair         # list paired devices and remove them
+```
+
+---
+
+## Setup from source
+
+```bash
+cd mobile/
+python3 -m venv .venv
+.venv/bin/pip install -r requirements.txt
+./trustmux-enable
+./trustmux-pair
+```
+
+---
+
+## Configuration
+
+| Path | Purpose |
+|---|---|
+| `~/.config/trustmux/tokens.json` | Paired device session tokens (mode 0600) |
+| `~/.config/trustmux/trustmux.sock` | Admin Unix socket (mode 0600) |
+| `~/.config/trustmux/trustmux.log` | Daemon log (mode 0600) |
+| `~/.config/trustmux/machines.json` | Optional: sibling machines for the machine selector |
+
+### Multiple machines
+
+```json
+[
+  { "name": "work",     "url": "https://work-machine.tail1234.ts.net" },
+  { "name": "personal", "url": "https://personal.tail1234.ts.net" }
+]
+```
+
+---
+
+## Security
+
+- Daemon binds to `127.0.0.1:7432` only — not reachable from the network
+- All traffic encrypted by Tailscale WireGuard; HTTPS via `tailscale serve`
+- No relay server — terminal data never leaves your Tailscale mesh
+- Pairing codes: 6-digit, 5-minute TTL, single-use, max 10 attempts
+- Session tokens: 256-bit random, stored at mode 0600
+
+---
+
+## Tests
+
+```bash
+cd mobile/
+python3 -m unittest tests.test_daemon -v
+```
+
+---
+
+## Troubleshooting
+
+**502 Bad Gateway** — tailscale serve is running but daemon isn't: `trustmux-ctl start`
+
+**"Serve not enabled"** — visit the URL printed by `tailscale serve --bg 7432`
+
+**Phone can't reach URL** — ensure Tailscale is active on the phone
+
+**Need to re-pair** — run `trustmux-pair` and enter the new code on the device

trustmux-7.0/README.md

@@ -0,0 +1,131 @@
+# Trustmux
+
+A mobile companion for [tmux](https://github.com/tmux/tmux) / [Byobu](https://byobu.org) sessions. Run a lightweight daemon on your workstation; monitor and interact with your terminal sessions from your phone over your Tailscale network. No relay server — terminal data stays between your devices.
+
+Works with **plain tmux** and with **byobu**. Byobu users get the live status bar chips; plain tmux users get everything else.
+
+Two tiers:
+- **Free** — PWA. Install one icon per machine directly from the browser.
+- **Paid** — Native Flutter app with full ANSI colors, multi-machine management, and biometric auth.
+
+---
+
+## Requirements
+
+- tmux (byobu optional but recommended)
+- Python 3.10+
+- [Tailscale](https://tailscale.com) installed, running, and connected
+
+---
+
+## Install
+
+### Homebrew (macOS / Linux)
+
+```bash
+brew tap dustinkirkland/trustmux
+brew install trustmux
+trustmux-enable    # configure tailscale serve + start daemon
+trustmux-pair      # generate pairing code; enter on phone
+```
+
+### pip (PyPI)
+
+```bash
+pip install trustmux
+trustmux-enable
+trustmux-pair
+```
+
+### Debian / Ubuntu (.deb)
+
+```bash
+sudo dpkg -i trustmux_7.0_all.deb
+trustmux-enable
+trustmux-pair
+```
+
+Add the PPA for automatic updates:
+
+```bash
+sudo add-apt-repository ppa:dustinkirkland/trustmux
+sudo apt install trustmux
+```
+
+---
+
+## Daily use
+
+```bash
+trustmux-ctl start      # start daemon
+trustmux-ctl stop       # stop daemon
+trustmux-ctl restart    # restart daemon
+trustmux-ctl status     # show URL and running status
+trustmux-ctl log        # tail the daemon log
+
+trustmux-pair           # generate a pairing code for a new device
+trustmux-unpair         # list paired devices and remove them
+```
+
+---
+
+## Setup from source
+
+```bash
+cd mobile/
+python3 -m venv .venv
+.venv/bin/pip install -r requirements.txt
+./trustmux-enable
+./trustmux-pair
+```
+
+---
+
+## Configuration
+
+| Path | Purpose |
+|---|---|
+| `~/.config/trustmux/tokens.json` | Paired device session tokens (mode 0600) |
+| `~/.config/trustmux/trustmux.sock` | Admin Unix socket (mode 0600) |
+| `~/.config/trustmux/trustmux.log` | Daemon log (mode 0600) |
+| `~/.config/trustmux/machines.json` | Optional: sibling machines for the machine selector |
+
+### Multiple machines
+
+```json
+[
+  { "name": "work",     "url": "https://work-machine.tail1234.ts.net" },
+  { "name": "personal", "url": "https://personal.tail1234.ts.net" }
+]
+```
+
+---
+
+## Security
+
+- Daemon binds to `127.0.0.1:7432` only — not reachable from the network
+- All traffic encrypted by Tailscale WireGuard; HTTPS via `tailscale serve`
+- No relay server — terminal data never leaves your Tailscale mesh
+- Pairing codes: 6-digit, 5-minute TTL, single-use, max 10 attempts
+- Session tokens: 256-bit random, stored at mode 0600
+
+---
+
+## Tests
+
+```bash
+cd mobile/
+python3 -m unittest tests.test_daemon -v
+```
+
+---
+
+## Troubleshooting
+
+**502 Bad Gateway** — tailscale serve is running but daemon isn't: `trustmux-ctl start`
+
+**"Serve not enabled"** — visit the URL printed by `tailscale serve --bg 7432`
+
+**Phone can't reach URL** — ensure Tailscale is active on the phone
+
+**Need to re-pair** — run `trustmux-pair` and enter the new code on the device

trustmux-7.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "trustmux"
+version = "7.0"
+description = "Monitor and interact with tmux/Byobu sessions from your phone"
+readme = "README.md"
+license = {text = "GPL-3.0-or-later"}
+authors = [{name = "Dustin Kirkland", email = "dustin.kirkland@gmail.com"}]
+requires-python = ">=3.9"
+dependencies = ["tornado>=6.0"]
+keywords = ["tmux", "byobu", "terminal", "mobile", "pwa"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+    "Programming Language :: Python :: 3",
+    "Topic :: Terminals :: Terminal Emulators/X Terminals",
+]
+
+[project.urls]
+Homepage = "https://trustmux.app"
+Repository = "https://github.com/dustinkirkland/byobu"
+Issues = "https://github.com/dustinkirkland/byobu/issues"
+
+[project.scripts]
+trustmux         = "trustmux._daemon:main"
+trustmux-ctl     = "trustmux._ctl:main"
+trustmux-pair    = "trustmux._pair:main"
+trustmux-unpair  = "trustmux._unpair:main"
+trustmux-enable  = "trustmux._enable:main"
+trustmux-disable = "trustmux._disable:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["trustmux*"]
+
+[tool.setuptools.package-data]
+trustmux = [
+    "static/index.html",
+    "static/app.js",
+    "static/sw.js",
+    "static/trustmux.svg",
+    "static/trustmux-logo.svg",
+    "static/icons/icon-192.png",
+    "static/icons/icon-512.png",
+]

trustmux-7.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+