adb-webui 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sonys
+
+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,131 @@
+<div align="center">
+
+# 📱 adb-web
+
+**A beautiful, browser-based ADB APK installer and Android device manager.**  
+No Electron. No heavy desktop app. Just Node.js + a browser.
+
+[![npm version](https://img.shields.io/npm/v/adb-web.svg)](https://www.npmjs.com/package/adb-web)
+[![npm downloads](https://img.shields.io/npm/dm/adb-web.svg)](https://www.npmjs.com/package/adb-web)
+[![License: MIT](https://img.shields.io/badge/License-MIT-violet.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D16-green)](https://nodejs.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+</div>
+
+---
+
+## ✨ Features
+
+- 📦 **Drag & drop APK installer** — drop your `.apk` and install in one click
+- 📱 **Auto device detection** — lists all connected ADB devices, auto-refreshes
+- 🔴 **Live log console** — real-time WebSocket output from ADB
+- 🗂️ **Package manager** — list, search, and uninstall installed apps
+- ⚡ **Quick actions** — reboot, recovery, bootloader, logcat, kill/start server
+- ✅ **Confirm prompts** — animated modal before every destructive action
+- ⚙️ **Configurable ADB path** — works even if ADB is not in your system PATH
+- 🌙 **Dark UI** — premium glassmorphism design, fully responsive
+
+---
+
+## 🚀 Quick Start
+
+### ⚡ Run instantly with npx (no install needed)
+
+```bash
+npx adb-web
+```
+
+### 📦 Install globally
+
+```bash
+npm install -g adb-web
+adb-web
+```
+
+### 🛠️ Clone & run manually
+
+```bash
+git clone https://github.com/shubhamsoni24/adb-web.git
+cd adb-web
+npm install
+npm start
+```
+
+Then open **http://localhost:3737** in your browser.
+
+
+---
+
+## 📱 Enable USB Debugging on Your Phone
+
+1. **Settings** → **About Phone** → tap **Build Number** 7 times
+2. **Settings** → **Developer Options** → enable **USB Debugging**
+3. Connect phone via USB cable
+4. Accept the **"Allow USB Debugging?"** prompt on your phone
+
+---
+
+## ⚙️ Configure ADB Path
+
+If `adb` is not in your system PATH, go to the **⚙️ Settings** tab in the app and set the full path:
+
+```
+C:\platform-tools\adb.exe          # Windows
+/usr/local/bin/adb                 # macOS/Linux
+```
+
+---
+
+## 🖼️ Screenshot
+
+![ADB Web Dashboard](./screenshot.png)
+
+---
+
+## 📁 Project Structure
+
+```
+adb-web/
+├── server.js       # Express + WebSocket backend, ADB integration
+├── index.html      # Full frontend (vanilla HTML/CSS/JS)
+├── package.json
+├── .gitignore
+└── LICENSE
+```
+
+---
+
+## 🔒 Security Notes
+
+- ADB shell commands are **whitelisted** — only safe read-only commands are allowed via the UI
+- Uploaded APKs are stored **locally only** on your machine
+- The server binds to `localhost` only by default — not exposed to the network
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues and feature requests are welcome!
+
+1. Fork the repo
+2. Create your feature branch: `git checkout -b feature/my-feature`
+3. Commit your changes: `git commit -m 'Add my feature'`
+4. Push to the branch: `git push origin feature/my-feature`
+5. Open a Pull Request
+
+---
+
+## 💡 Roadmap
+
+- [ ] Batch APK installation (multiple files)
+- [ ] Screenshot & screen recording support
+- [ ] File push/pull from device storage
+- [ ] Wireless ADB (connect over Wi-Fi)
+- [ ] Dark/light theme toggle
+
+---
+
+## 📄 License
+
+[MIT](LICENSE) © 2026 sonys

package/bin/adb-web.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const { spawn, exec } = require('child_process');
+const path = require('path');
+const net = require('net');
+
+// ── Colours ──────────────────────────────────────────────
+const c = {
+  reset:  '\x1b[0m',
+  bold:   '\x1b[1m',
+  dim:    '\x1b[2m',
+  green:  '\x1b[32m',
+  cyan:   '\x1b[36m',
+  yellow: '\x1b[33m',
+  magenta:'\x1b[35m',
+  red:    '\x1b[31m',
+};
+
+function banner(port) {
+  console.log('');
+  console.log(`${c.magenta}${c.bold}  ╔═══════════════════════════════════════╗${c.reset}`);
+  console.log(`${c.magenta}${c.bold}  ║   📱  ADB Web — APK Installer          ║${c.reset}`);
+  console.log(`${c.magenta}${c.bold}  ╚═══════════════════════════════════════╝${c.reset}`);
+  console.log('');
+  console.log(`  ${c.green}✔${c.reset}  Server running on ${c.cyan}${c.bold}http://localhost:${port}${c.reset}`);
+  console.log(`  ${c.green}✔${c.reset}  Opening browser…`);
+  console.log('');
+  console.log(`  ${c.dim}Press Ctrl+C to stop${c.reset}`);
+  console.log('');
+}
+
+// ── Find a free port ─────────────────────────────────────
+function getFreePort(preferred) {
+  return new Promise((resolve) => {
+    const srv = net.createServer();
+    srv.listen(preferred, () => {
+      const { port } = srv.address();
+      srv.close(() => resolve(port));
+    });
+    srv.on('error', () => {
+      // preferred taken → let OS pick
+      const srv2 = net.createServer();
+      srv2.listen(0, () => {
+        const { port } = srv2.address();
+        srv2.close(() => resolve(port));
+      });
+    });
+  });
+}
+
+// ── Open browser cross-platform ──────────────────────────
+function openBrowser(url) {
+  const platform = process.platform;
+  let cmd;
+  if (platform === 'win32') cmd = `start "" "${url}"`;
+  else if (platform === 'darwin') cmd = `open "${url}"`;
+  else cmd = `xdg-open "${url}"`;
+  exec(cmd, (err) => {
+    if (err) console.log(`  ${c.yellow}⚠${c.reset}  Could not auto-open browser. Visit: ${c.cyan}${url}${c.reset}`);
+  });
+}
+
+// ── Main ─────────────────────────────────────────────────
+async function main() {
+  const preferredPort = parseInt(process.env.PORT || '3737', 10);
+  const port = await getFreePort(preferredPort);
+
+  // Pass the port to the server via env
+  const serverPath = path.join(__dirname, '..', 'server.js');
+  const child = spawn(process.execPath, [serverPath], {
+    env: { ...process.env, PORT: String(port) },
+    stdio: 'inherit',
+  });
+
+  child.on('error', (err) => {
+    console.error(`${c.red}Failed to start server:${c.reset}`, err.message);
+    process.exit(1);
+  });
+
+  child.on('exit', (code) => {
+    process.exit(code ?? 0);
+  });
+
+  // Give the server a moment to boot, then open browser
+  setTimeout(() => {
+    const url = `http://localhost:${port}`;
+    banner(port);
+    openBrowser(url);
+  }, 800);
+
+  // Forward signals
+  ['SIGINT', 'SIGTERM'].forEach((sig) => {
+    process.on(sig, () => {
+      child.kill(sig);
+    });
+  });
+}
+
+main();