webtun 1.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gaurang Patel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,205 @@
+# WebTun — Self-Hosted Web Terminal
+
+![Terminal](https://img.shields.io/badge/Terminal-Web--Native-2D5B8E?style=for-the-badge)
+![PWA](https://img.shields.io/badge/PWA-Installable-6BA428?style=for-the-badge)
+![Cloudflare](https://img.shields.io/badge/Tunnel-Cloudflare-F38020?style=for-the-badge)
+![Desktop](https://img.shields.io/badge/Desktop-Electron-47848F?style=for-the-badge)
+![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
+
+**Access your Linux server from any browser — no VPN, no SSH client, no installing anything.**
+
+[![Quick Start](https://img.shields.io/badge/Quick_Start-One_Command-2D5B8E?style=for-the-badge&logo=gnu-bash)](install.sh)
+[![Download](https://img.shields.io/github/v/release/unn-known1/webtun?style=for-the-badge&logo=github)](https://github.com/unn-known1/webtun/releases/latest)
+
+---
+
+## Why WebTun?
+
+| Traditional SSH | WebTun |
+|----------------|--------|
+| Need SSH client installed | Open any browser |
+| Configure VPN or port forwarding | Cloudflare Tunnel auto-configured |
+| Can't access from phone easily | PWA works on iOS/Android |
+| Share access requires key exchange | Web-based sharing in 1 click |
+| Corporate firewall blocks port 22 | Runs over HTTPS (port 443) |
+
+---
+
+## Features
+
+### Core
+- **Real shell sessions** — node-pty backed, full bash/zsh support
+- **Multi-tab terminal** — drag tabs to reorder, side-by-side sessions like your desktop
+- **File explorer** — browse, upload, download, rename, delete, cut/copy/paste with conflict resolution (replace, merge, keep both, skip)
+- **WebSocket + xterm.js** — responsive, low-latency typing
+
+### Mobile-First UX
+- **Touch gestures** — swipe to close tabs, swipe from edge to open sidebar, pull-to-refresh file list
+- **Mobile keyboard bar** — ESC, Tab, arrow keys, Ctrl combos (Ctrl+C, Ctrl+D, etc.)
+- **Virtual keyboard aware** — terminal resizes when keyboard opens, no overlap
+- **Pinch-to-zoom** — adjust terminal font size (10–28px) with two fingers
+- **Selection mode** — toggle between terminal interaction and text selection
+- **Responsive** — optimized for phones (480px), tablets (1024px), and landscape orientation
+
+### File Explorer
+- **Multi-select** — select all / deselect all, batch delete and download files
+- **Zip / Extract** — right-click any file or folder to zip; right-click `.zip` files to extract
+- **Image viewer** — click images (.png, .jpg, .gif, .svg, .webp, .bmp, .ico) to preview inline
+- **Cut, Copy, Paste** — with conflict resolution dialog (replace, merge folders, keep both, skip, cancel)
+- **Upload with progress** — per-file progress bar via XHR
+- **Breadcrumb navigation** — tappable directory segments for quick navigation
+- **Long-press context menu** — rename, delete, download, copy on touch devices
+- **Text selection** — long-press file names to select and copy text on touch devices
+
+### Desktop App (Electron)
+- Cross-platform app for Linux & Windows
+- Runs the server as a child process — no terminal needed
+- Native window with system tray, copy/paste, and file dialogs
+- Download the latest release from [GitHub Releases](https://github.com/unn-known1/webtun/releases/latest)
+- Or build from source: `npm run dist:linux` / `npm run dist:win`
+
+### PWA (Install as App)
+- Add to iOS/Android home screen — looks and feels like native app
+- Install banner prompts on first visit (Chrome) with iOS instructions fallback
+- Works offline (shows last session state)
+- Push notifications for tunnel status
+
+### Cloudflare Tunnel (Zero-Config)
+- Create tunnel from UI — no CLI commands
+- Built-in health check warns if local server is unreachable before creating tunnel
+- Live/orphan status + target responsiveness indicator in tunnel list
+- Get public HTTPS URL instantly
+- Tunnels survive server restarts
+- Stop/kill tunnels from settings panel
+
+---
+
+## Quick Start
+
+### One-Command Install
+```bash
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/unn-Known1/webtun/main/install.sh)"
+```
+
+### Manual Setup
+```bash
+git clone https://github.com/unn-Known1/webtun.git
+cd webtun
+chmod +x setup.sh && ./setup.sh
+npm start
+```
+
+### Google Colab (Instant Terminal)
+```python
+!rm -rf webtun && git clone https://github.com/unn-Known1/webtun.git && cd webtun && npm install --loglevel=error && node server.js > /tmp/webtun.log 2>&1 & sleep 4 && for i in 1 2 3; do curl -sf http://localhost:3000/api/auth/required >/dev/null && break; sleep 2; done && curl -s -X POST http://localhost:3000/api/tunnel -H 'Content-Type: application/json' -d '{"url":"http://localhost:3000"}' --max-time 20 | python3 -c "import sys,json; d=json.load(sys.stdin); print('🌐 WebTun ready at:', d.get('url','Error: '+d.get('error','')))"
+```
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      Your Browser                           │
+│  ┌─────────┐  ┌──────────┐  ┌────────────┐  ┌────────────┐  │
+│  │Terminal │  │  File    │  │   Tunnel   │  │  Settings  │  │
+│  │ (xterm) │  │ Explorer │  │   Manager  │  │   Panel    │  │
+│  └────┬────┘  └────┬─────┘  └──────┬─────┘  └─────┬──────┘  │
+│       │            │               │              │         │
+└───────┼────────────┼───────────────┼──────────────┼─────────┘
+        │ WebSocket  │               │              │
+        ▼            ▼               ▼              │
+┌─────────────────────────────────────────────────────────────┐
+│                      Node.js Server                         │
+│  ┌────────────┐  ┌─────────────┐  ┌────────────────────┐    │
+│  │  WebSocket │  │   File API  │  │ Cloudflare Tunnel   │    │
+│  │  Handler   │  │ (read/write)│  │     Manager        │    │
+│  └─────┬──────┘  └──────┬──────┘  └─────────┬──────────┘    │
+│        │                │                   │               │
+│        ▼                ▼                   ▼               │
+│  ┌─────────┐  ┌────────────────┐  ┌──────────────────────┐  │
+│  │ node-pty│  │Local Filesystem│  │ cloudflared daemon    │  │
+│  │ (shell) │  │(your server)   │  │ (exposes to internet)│  │
+│  └─────────┘  └────────────────┘  └──────────────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                            │
+                            ▼
+                    ┌─────────────────┐
+                    │  Internet Users │
+                    │  (HTTPS URL)    │
+                    └─────────────────┘
+```
+
+---
+
+## Use Cases
+
+| Scenario | Why WebTun |
+|----------|------------|
+| **Home server access** | Access from anywhere without opening ports |
+| **Emergency debugging** | Phone/laptop without SSH client |
+| **Share terminal with friend** | No key exchange, just send URL |
+| **Colab power-up** | Persistent terminal alongside Python notebooks |
+| **Demo environment** | Spin up temp shell for presentations |
+| **Corporate restrictions** | HTTPS works where SSH is blocked |
+
+---
+
+## Tunnel Manager
+
+1. Open **Settings** (gear icon)
+2. Go to **Tunnel** section
+3. Enter URL (default: `http://localhost:3000`)
+4. Click **Create** — a health check pings the target first, warns if unreachable
+5. Copy the public URL — share it with anyone
+6. View all tunnels with live status indicators (green/orange)
+
+**Note:** Tunnels created before a server restart need manual cleanup:
+```bash
+kill $(pgrep -f 'cloudflared tunnel')
+```
+
+---
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Frontend | HTML + Vanilla JS (PWA, prefers-color-scheme, visualViewport, Drag & Drop) |
+| Backend | Node.js + node-pty + Express |
+| Terminal | xterm.js + fit addon |
+| Protocol | WebSocket (ws) |
+| Tunnel | Cloudflare Tunnel (cloudflared) |
+| Desktop | Electron + electron-builder |
+
+---
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| Tunnel URL not loading | Check Cloudflare account quota at [dash.cloudflare.com](https://dash.cloudflare.com) |
+| Permission denied on shell | Ensure user has shell access: `chsh -s /bin/bash` |
+| File upload fails | Check `public/uploads/` permissions: `chmod 755 public/uploads/` |
+| Port 3000 in use | Change port: `PORT=3001 npm start` |
+
+---
+
+## Contributing
+
+1. Fork → Branch → Commit → PR
+2. Follow existing code style (ES6+, no frameworks)
+3. Test locally with `npm start`
+4. Update this README if adding features
+
+---
+
+## License
+
+MIT — do whatever you want with it.
+
+---
+
+<p align="center">
+  <sub>Made with ❤️ by <a href="https://github.com/unn-known1">Gaurang Patel</a></sub>
+</p>

package/bin/webtun.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const args = process.argv.slice(2);
+
+function printHelp() {
+  console.log(`
+  WebTun — Web Terminal with Cloudflare Tunnel
+
+  Usage:
+    webtun [options]
+
+  Options:
+    --port, -p <port>     Port to listen on (default: 3000 or $PORT)
+    --host, -h <host>     Host to bind to (default: 0.0.0.0 or $HOST)
+    --pin <pin>           PIN for authentication (default: $PIN)
+    --help                Show this help message
+    --version             Show version number
+
+  Environment Variables:
+    PORT                  Server port (default: 3000)
+    HOST                  Bind address (default: 0.0.0.0)
+    PIN                   Authentication PIN (empty = no auth)
+    SHELL                 Shell to use (default: /bin/bash or system shell)
+    WORKSPACE_ROOT        Root directory for file operations (default: ~)
+
+  Examples:
+    webtun                          Start on default port
+    webtun --port 8080              Start on port 8080
+    webtun --pin secret123          Start with PIN protection
+    PORT=4000 webtun               Start on port 4000 via env var
+`);
+}
+
+function parseArgs(argv) {
+  const opts = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--help' || arg === '-H') {
+      printHelp();
+      process.exit(0);
+    }
+    if (arg === '--version' || arg === '-v') {
+      console.log(require('../package.json').version);
+      process.exit(0);
+    }
+    if (arg === '--port' || arg === '-p') {
+      opts.port = parseInt(argv[++i], 10);
+      if (isNaN(opts.port)) {
+        console.error('Error: --port requires a numeric value');
+        process.exit(1);
+      }
+    } else if (arg === '--host' || arg === '-h') {
+      opts.host = argv[++i];
+    } else if (arg === '--pin') {
+      process.env.PIN = argv[++i] || '';
+    } else {
+      console.error(`Unknown option: ${arg}`);
+      printHelp();
+      process.exit(1);
+    }
+  }
+  return opts;
+}
+
+const opts = parseArgs(args);
+const { startServer } = require('../server');
+
+startServer(opts).catch(err => {
+  console.error('Failed to start server:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "webtun",
+  "version": "1.4.0",
+  "description": "Self-hosted web terminal with Cloudflare Tunnel, file explorer, and PWA support",
+  "author": {
+    "name": "Gaurang Patel",
+    "email": "ptelgm.yt@gmail.com"
+  },
+  "license": "MIT",
+  "main": "server.js",
+  "bin": {
+    "webtun": "bin/webtun.js"
+  },
+  "files": [
+    "bin/",
+    "server.js",
+    "public/",
+    "postinstall.js"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "nodemon server.js",
+    "electron": "electron .",
+    "pack": "electron-builder --dir",
+    "dist": "electron-builder",
+    "dist:win": "electron-builder --win",
+    "dist:linux": "electron-builder --linux",
+    "dist:mac": "electron-builder --mac",
+    "postinstall": "node postinstall.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unn-Known1/webtun.git"
+  },
+  "keywords": [
+    "terminal",
+    "web-terminal",
+    "ssh",
+    "remote-access",
+    "cloudflare",
+    "tunnel",
+    "file-manager",
+    "pwa",
+    "self-hosted"
+  ],
+  "build": {
+    "appId": "com.webtun.app",
+    "productName": "WebTun",
+    "files": [
+      "electron/**/*",
+      "server.js",
+      "public/**/*",
+      "package.json"
+    ],
+    "extraResources": [
+      {
+        "from": "node_modules",
+        "to": "node_modules",
+        "filter": [
+          "**/*"
+        ]
+      }
+    ],
+    "win": {
+      "target": [
+        "nsis",
+        "portable"
+      ],
+      "icon": "public/icon-512.png"
+    },
+    "mac": {
+      "target": [
+        "dmg",
+        "zip"
+      ],
+      "icon": "public/icon-512.png",
+      "category": "Utility"
+    },
+    "linux": {
+      "target": [
+        "AppImage",
+        "deb"
+      ],
+      "icon": "public/icon-512.png",
+      "category": "Utility"
+    },
+    "nsis": {
+      "oneClick": false,
+      "allowToChangeInstallationDirectory": true
+    }
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "multer": "^2.0.0",
+    "node-pty": "^1.0.0",
+    "ws": "^8.21.0"
+  },
+  "optionalDependencies": {
+    "electron": "^42.2.0",
+    "electron-builder": "^26.8.1"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.14"
+  },
+  "overrides": {
+    "form-data": "4.0.6"
+  },
+  "allowScripts": {
+    "electron-winstaller@5.4.0": true,
+    "node-pty@1.1.0": true
+  }
+}

package/postinstall.js

@@ -0,0 +1,120 @@
+const { execSync, spawnSync } = require('child_process');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const CF_RELEASES = 'https://github.com/cloudflare/cloudflared/releases/latest/download';
+
+try {
+  if (os.platform() === 'win32') {
+    execSync('where cloudflared', { stdio: 'ignore' });
+  } else {
+    execSync('command -v cloudflared', { stdio: 'ignore' });
+  }
+  process.exit(0);
+} catch {}
+
+const platform = os.platform();
+const arch = os.arch();
+
+const files = {
+  linux:   { x64: 'cloudflared-linux-amd64', arm64: 'cloudflared-linux-arm64', arm: 'cloudflared-linux-arm' },
+  darwin:  { x64: 'cloudflared-darwin-amd64.tgz', arm64: 'cloudflared-darwin-arm64.tgz' },
+  win32:   { x64: 'cloudflared-windows-amd64.exe' }
+};
+
+const file = (files[platform] || {})[arch];
+if (!file) process.exit(0);
+
+console.log('  installing cloudflared...');
+
+const url = CF_RELEASES + '/' + file;
+const tmpDir = os.tmpdir();
+const tmp = path.join(tmpDir, 'cloudflared-' + process.pid + (platform === 'win32' ? '.exe' : ''));
+const tmpExtracted = path.join(tmpDir, 'cloudflared-' + process.pid + '-bin' + (platform === 'win32' ? '.exe' : ''));
+
+function cleanup() {
+  try { fs.unlinkSync(tmp); } catch {}
+  try { fs.unlinkSync(tmpExtracted); } catch {}
+}
+
+function download() {
+  const r = spawnSync('curl', ['-#fL', url, '-o', tmp], { stdio: 'inherit', timeout: 60000 });
+  if (r.status === 0) return true;
+  const r2 = spawnSync('wget', ['-q', url, '-O', tmp], { stdio: 'inherit', timeout: 60000 });
+  return r2.status === 0;
+}
+
+if (!download()) {
+  console.log('  cloudflared install failed (download error) — skipping');
+  cleanup();
+  process.exit(0);
+}
+
+// Validate downloaded file is not HTML (e.g. 404 page)
+try {
+  const buf = Buffer.alloc(1024);
+  const fd = fs.openSync(tmp, 'r');
+  const bytesRead = fs.readSync(fd, buf, 0, 1024, 0);
+  fs.closeSync(fd);
+  const head = buf.slice(0, bytesRead).toString('utf8').trim();
+  if (/^<!doctype\s+html/i.test(head) || /^<html/i.test(head)) {
+    console.log('  cloudflared install failed (downloaded file is not a binary) — skipping');
+    cleanup();
+    process.exit(0);
+  }
+} catch (e) {
+  console.log('  cloudflared install failed (cannot validate download): ' + e.message);
+  cleanup();
+  process.exit(0);
+}
+
+function installBin(src, dest) {
+  try {
+    fs.renameSync(src, dest);
+  } catch (e) {
+    if (e.code === 'EXDEV') {
+      fs.copyFileSync(src, dest);
+      try { fs.unlinkSync(src); } catch {}
+    } else {
+      throw e;
+    }
+  }
+  // Always set executable bit regardless of rename or copy path
+  try { fs.chmodSync(dest, 0o755); } catch {}
+}
+
+try {
+  if (platform === 'darwin') {
+    const result = spawnSync('tar', ['xzf', tmp, '-C', tmpDir], { stdio: 'inherit' });
+    if (result.status !== 0) throw new Error('tar extraction failed');
+    installBin(path.join(tmpDir, 'cloudflared'), '/usr/local/bin/cloudflared');
+    try { fs.unlinkSync(tmp); } catch {}
+  } else if (platform === 'win32') {
+    const progFiles = process.env.ProgramW6432 || process.env.ProgramFiles || (process.env.SystemRoot + '\\Program Files');
+    const dest = path.join(progFiles, 'cloudflared', 'cloudflared.exe');
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    installBin(tmp, dest);
+  } else {
+    installBin(tmp, '/usr/local/bin/cloudflared');
+  }
+  console.log('  cloudflared installed');
+  cleanup();
+} catch (e) {
+  // When installed globally via npm, /usr/local/bin may not be writable.
+  // In that case, download to a local path and suggest manual install.
+  if (e.code === 'EACCES' || e.code === 'EPERM') {
+    const localDest = path.join(process.cwd(), 'cloudflared' + (platform === 'win32' ? '.exe' : ''));
+    try {
+      installBin(tmp, localDest);
+      console.log('  cloudflared installed to ' + localDest);
+      console.log('  Move it to your PATH: sudo mv ' + localDest + ' /usr/local/bin/');
+    } catch (e2) {
+      console.log('  cloudflared install failed: ' + e2.message + ' — skipping');
+    }
+  } else {
+    console.log('  cloudflared install failed: ' + e.message + ' — skipping');
+  }
+  cleanup();
+  process.exit(0);
+}

package/public/commands.js

@@ -0,0 +1,7 @@
+window.DEFAULT_CMDS = [
+  { name: 'Install OpenCode AI', cmd: 'npm install -g opencode-ai', cat: 'AI Tools' },
+  { name: 'Install MiMo CLI', cmd: 'npm install -g @mimo-ai/cli', cat: 'AI Tools' },
+  { name: 'Install 9Router', cmd: 'npm install -g 9router', cat: 'AI Tools' },
+  { name: 'GitHub TUI', cmd: 'npx github-tui', cat: 'Tools' },
+  { name: 'Colab Setup', cmd: 'curl -fsSL https://raw.githubusercontent.com/unn-Known1/unn-Known1/main/colab_setup.sh | bash', cat: 'Setup' },
+];