lan-send 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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,47 @@
+## 🛰️ lan-send
+Instant, zero-disk file bridge for your local network.
+
+## 🚀 Quick Start
+No installation required. Run this in your terminal to start beaming:
+
+```bash
+npx lan-send
+```
+
+1. **Scan** the QR code displayed in your terminal with your phone.
+
+2. **Drop** files on your desktop or **Tap** "Select Files" on mobile.
+
+3. **Download** on the other device by tapping the **READY** cards.
+
+## 🛠️ Global Installation
+If you want the command available anytime:
+
+```bash
+npm install -g lan-send
+```
+Then just run:
+```bash
+lan-send
+```
+
+## ✨ Features
+**Volatile by Design:** Files are stored strictly in RAM. Once the process is stopped, the data vanishes—leaving no trace on your hard drive.
+
+**Dual-Sync History:** Tracks both sent and received history on both devices. Your history persists even if you refresh the browser page.
+
+**WSL2 Optimized:** Automatically detects your host machine's real IP, bypassing the virtual WSL bridge so mobile devices can connect seamlessly.
+
+**Mobile-First UI:** Large, tapable cards and a simplified mobile interface designed for one-handed use.
+
+**Real-time Feedback:** Powered by Server-Sent Events (SSE) for instant notifications and per-file progress bars.
+
+## 🔒 Privacy & Security
+**Local Network Only:** Your data never touches the internet or third-party servers.
+
+**Zero Footprint:** Ideal for temporary file sharing where you don't want to leave artifacts on the host machine's SSD/HDD.
+
+**Open & Minimal:** Transparent logic with minimal dependencies and zero telemetry.
+
+## 📜 License
+MIT © 2026

package/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { serve } from '@hono/node-server';
+import { Hono } from 'hono';
+import { streamSSE } from 'hono/streaming';
+import QRCode from 'qrcode';
+import color from 'picocolors';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { networkInterfaces } from 'node:os';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const app = new Hono();
+const PORT = 8000;
+
+const IP = (() => {
+    const nets = networkInterfaces();
+    let backupIP = 'localhost';
+
+    for (const name of Object.keys(nets)) {
+        // Skip virtual adapters often used by WSL, Docker, and VPNs
+        if (name.includes('vEthernet') || name.includes('docker') || name.includes('wsl')) continue;
+
+        for (const net of nets[name]) {
+            // We want IPv4 and it must not be the internal loopback (127.0.0.1)
+            if (net.family === 'IPv4' && !net.internal) {
+                // Prioritize "Wi-Fi" or "Ethernet" naming conventions
+                if (name.toLowerCase().includes('wi-fi') || name.toLowerCase().includes('eth')) {
+                    return net.address;
+                }
+                backupIP = net.address;
+            }
+        }
+    }
+    return backupIP;
+})();
+
+const memoryFiles = new Map(); 
+const history = [];            
+let clients = [];
+
+app.get('/static/:file', (c) => {
+    const file = c.req.param('file');
+    const filePath = path.join(__dirname, 'public', file);
+    if (!fs.existsSync(filePath)) return c.text("404", 404);
+    const type = file.endsWith('.css') ? 'text/css' : 'application/javascript';
+    return c.body(fs.readFileSync(filePath), 200, { 'Content-Type': type });
+});
+
+const getTemplate = (name) => fs.readFileSync(path.join(__dirname, 'views', `${name}.html`), 'utf-8');
+app.get('/', (c) => c.html(getTemplate('mobile')));
+app.get('/desktop', (c) => c.html(getTemplate('desktop')));
+
+app.get('/api/history', (c) => c.json(history));
+
+app.post('/upload', async (c) => {
+    const from = c.req.query('from');
+    const body = await c.req.parseBody();
+    const file = body['file'];
+    if (file instanceof File) {
+        const buffer = Buffer.from(await file.arrayBuffer());
+        const id = 'h-' + Math.random().toString(36).substring(2, 9);
+        memoryFiles.set(file.name, { buffer, from });
+        history.push({ id, name: file.name, from });
+        if(history.length > 20) history.shift();
+        clients.forEach(s => s.writeSSE({ data: "u" }));
+    }
+    return c.json({ ok: true });
+});
+
+app.get('/dl/:name', (c) => {
+    const name = decodeURIComponent(c.req.param('name'));
+    const file = memoryFiles.get(name);
+    if (!file) return c.text("Expired", 404);
+    return c.body(file.buffer, 200, { 'Content-Disposition': `attachment; filename="${name}"` });
+});
+
+app.get('/sse', (c) => streamSSE(c, async (s) => { 
+    clients.push(s); 
+    while (true) { await s.sleep(30000); await s.writeSSE({ data: "p" }); } 
+}));
+
+serve({ fetch: app.fetch, port: PORT, hostname: '0.0.0.0' }, async () => {
+    console.clear();
+    const mobileUrl = `http://${IP}:${PORT}`;
+    console.log(color.cyan(color.bold("⚡ TELE-PORT ACTIVE")));
+    console.log(color.dim("------------------------------------------"));
+    console.log(color.white("Scan this code to teleport files to/from mobile:"));
+    console.log(await QRCode.toString(mobileUrl, { type: 'terminal', small: true }));
+    console.log(color.yellow("📱 MOBILE:  ") + color.white(mobileUrl));
+    console.log(color.blue("💻 DESKTOP: ") + color.white(`http://localhost:${PORT}/desktop`));
+    console.log(color.dim("------------------------------------------"));
+    console.log(color.dim("Running in Volatile Mode (RAM only)."));
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "lan-send",
+  "version": "1.0.0",
+  "description": "Zero-disk, RAM-only file bridge for instant local network sharing via QR code.",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "lan-send": "./index.js"
+  },
+  "keywords": [
+    "file-share",
+    "lan",
+    "p2p",
+    "qr-code",
+    "transfer",
+    "volatile",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "index.js",
+    "public/",
+    "views/"
+  ],
+  "dependencies": {
+    "@hono/node-server": "^1.13.0",
+    "hono": "^4.6.0",
+    "picocolors": "^1.1.0",
+    "qrcode": "^1.5.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/public/client.js

@@ -0,0 +1,91 @@
+let sse = new EventSource("/sse");
+let knownIds = new Set();
+const role = window.location.pathname === '/desktop' ? 'pc' : 'mobile';
+
+async function syncAllHistory() {
+    const res = await fetch('/api/history');
+    const data = await res.json();
+    
+    data.forEach(item => {
+        if (!knownIds.has(item.id)) {
+            knownIds.add(item.id);
+            
+            // Determine if this device was the sender or receiver
+            const isSentByMe = item.from === role;
+            const targetFeedId = isSentByMe ? 'sent-feed' : 'inbox-feed';
+            const feed = document.getElementById(targetFeedId);
+            
+            const el = document.createElement('div');
+            el.id = item.id;
+            
+            if (!isSentByMe) {
+                // Incoming items get the clickable download logic
+                el.className = 'feed-item clickable';
+                el.onclick = () => window.location.href = `/dl/${encodeURIComponent(item.name)}`;
+                el.innerHTML = `
+                    <div class="item-row">
+                        <span class="file-name">📥 ${item.name}</span>
+                        <div class="status-group">
+                            <span class="status-tag status-ready">READY</span>
+                            <span class="status-tag status-dl">DL</span>
+                        </div>
+                    </div>`;
+            } else {
+                // Sent items (persisted from server)
+                el.className = 'feed-item';
+                el.innerHTML = `
+                    <div class="item-row">
+                        <span class="file-name">📤 ${item.name}</span>
+                        <span class="status-tag status-ready">SENT</span>
+                    </div>`;
+            }
+            feed.prepend(el);
+        }
+    });
+}
+
+// Handles the active, real-time upload progress
+async function doUpload(files) {
+    const queue = Array.from(files).map(f => ({ f, id: 'up-' + Math.random().toString(36).substr(2, 9) }));
+    const sentFeed = document.getElementById('sent-feed');
+
+    for (const item of queue) {
+        // Create a temporary progress card
+        let progEl = document.createElement('div');
+        progEl.id = item.id;
+        progEl.className = 'feed-item';
+        sentFeed.prepend(progEl);
+
+        await new Promise((resolve) => {
+            const xhr = new XMLHttpRequest();
+            const fd = new FormData();
+            fd.append('file', item.f);
+
+            xhr.upload.addEventListener('progress', (e) => {
+                const percent = Math.round((e.loaded / e.total) * 100);
+                progEl.innerHTML = `
+                    <div class="item-row">
+                        <span class="file-name">📤 ${item.f.name}</span>
+                        <span class="status-tag status-sending">${percent}%</span>
+                    </div>
+                    <div class="progress-container" style="display: block">
+                        <div class="progress-fill" style="width: ${percent}%"></div>
+                    </div>`;
+            });
+
+            xhr.onload = () => {
+                // Remove the temporary progress card
+                progEl.remove();
+                // The server will trigger an SSE update, and syncAllHistory() 
+                // will add the permanent "SENT" card to this device
+                resolve();
+            };
+            xhr.open('POST', '/upload?from=' + role);
+            xhr.send(fd);
+        });
+    }
+}
+
+window.onload = syncAllHistory;
+// When the server says "u" (upload happened), sync everything
+sse.onmessage = (e) => { if(e.data === "u") syncAllHistory(); };

package/public/style.css

@@ -0,0 +1,171 @@
+/* Color Palette & Variables */
+:root {
+    --bg: #0f172a;
+    --card: #1e293b;
+    --accent: #22d3ee;
+    --text: #f1f5f9;
+    --ready: #10b981;
+    --sending: #f59e0b;
+    --pending: #64748b;
+    --border: #334155;
+}
+
+/* Global Reset & Body */
+body {
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    background: var(--bg);
+    color: var(--text);
+    padding: 20px;
+    margin: 0;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    line-height: 1.5;
+}
+
+.container {
+    width: 100%;
+    max-width: 500px;
+}
+
+/* Typography */
+h2 {
+    text-align: center;
+    font-weight: 800;
+    letter-spacing: -0.5px;
+    margin-bottom: 40px;
+}
+
+.history-title {
+    font-size: 11px;
+    color: #94a3b8;
+    margin: 30px 0 10px 0;
+    text-transform: uppercase;
+    letter-spacing: 1.5px;
+    font-weight: bold;
+    width: 100%;
+}
+
+/* Main Action Button (Mobile) */
+.btn {
+    background: var(--accent);
+    color: #0f172a;
+    padding: 12px 24px;
+    border-radius: 8px;
+    text-decoration: none;
+    font-weight: bold;
+    font-size: 14px;
+    border: none;
+    cursor: pointer;
+    transition: opacity 0.2s;
+}
+
+.mobile-btn-wrapper {
+    text-align: center;
+}
+
+.btn:active {
+    opacity: 0.8;
+}
+
+/* Desktop Drop Zone */
+.drop-zone {
+    border: 2px dashed var(--border);
+    border-radius: 15px;
+    padding: 40px 20px;
+    text-align: center;
+    margin-bottom: 20px;
+    background: #1e293b55;
+    cursor: pointer;
+    transition: all 0.2s ease;
+}
+
+/* Feed Item Cards */
+.feed-item {
+    background: var(--card);
+    border-radius: 12px;
+    padding: 14px 16px;
+    margin-bottom: 12px;
+    display: flex;
+    flex-direction: column;
+    border: 1px solid var(--border);
+}
+
+.feed-item.clickable {
+    cursor: pointer;
+    transition: transform 0.1s, background 0.2s, border-color 0.2s;
+}
+
+.feed-item.clickable:hover {
+    border-color: var(--accent);
+}
+
+.feed-item.clickable:active {
+    transform: scale(0.98);
+    background: #2d3748;
+}
+
+.item-row {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    width: 100%;
+}
+
+.file-name {
+    font-size: 14px;
+    font-weight: 500;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    max-width: 220px;
+}
+
+/* Refined Status Tags */
+.status-group {
+    display: flex;
+    gap: 6px;
+    align-items: center;
+}
+
+.status-tag { 
+    font-size: 10px; 
+    padding: 6px 10px; /* Taller height, tighter width */
+    border-radius: 4px; 
+    font-weight: 800; 
+    text-transform: uppercase; 
+    text-align: center; 
+    line-height: 1;
+    display: inline-block;
+    min-width: 50px;
+}
+
+.status-ready { background: var(--ready); color: #fff; }
+.status-sending { background: var(--sending); color: #000; }
+.status-pending { background: var(--pending); color: #fff; }
+.status-dl { background: var(--accent); color: #0f172a; }
+
+/* Progress Bar */
+.progress-container {
+    width: 100%;
+    height: 6px;
+    background: var(--border);
+    border-radius: 3px;
+    margin-top: 12px;
+    display: none;
+    overflow: hidden;
+}
+
+.progress-fill {
+    height: 100%;
+    background: var(--accent);
+    width: 0%;
+    transition: width 0.1s ease-out;
+}
+
+/* Mobile responsive adjustments */
+@media (max-width: 400px) {
+    .file-name {
+        max-width: 150px;
+    }
+}

package/views/desktop.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <meta charset="UTF-8">
+    <title>lan-send | Desktop</title>
+    <link rel="stylesheet" href="/static/style.css">
+</head>
+
+<body>
+    <div class="container">
+        <h2>LAN send - Desktop</h2>
+        <div class="drop-zone" id="dz" onclick="document.getElementById('f').click()">
+            <span class="btn" style="padding: 10px 20px;">CLICK OR DROP FILES</span>
+            <input type="file" id="f" multiple hidden onchange="doUpload(this.files)">
+        </div>
+        <div class="history-title">Incoming</div>
+        <div id="inbox-feed"></div>
+        <div class="history-title">Sent</div>
+        <div id="sent-feed"></div>
+    </div>
+    <script src="/static/client.js"></script>
+    <script>
+        const dz = document.getElementById('dz');
+        window.addEventListener('dragover', (e) => { e.preventDefault(); dz.style.borderColor = 'var(--accent)'; dz.style.background = '#22d3ee11'; });
+        window.addEventListener('dragleave', () => { dz.style.borderColor = '#334155'; dz.style.background = '#1e293b55'; });
+        window.addEventListener('drop', (e) => { e.preventDefault(); dz.style.borderColor = '#334155'; dz.style.background = '#1e293b55'; if (e.dataTransfer.files.length > 0) doUpload(e.dataTransfer.files); });
+    </script>
+</body>
+
+</html>

package/views/mobile.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>lan-send</title>
+    <link rel="stylesheet" href="/static/style.css">
+</head>
+
+<body>
+    <div class="container">
+        <h2 style="text-align: center;">Lan Send</h2>
+
+        <div class="mobile-btn-wrapper">
+            <button class="btn" style=""
+                onclick="document.getElementById('f').click()">
+                SELECT FILES TO SEND
+            </button>
+            <input type="file" id="f" multiple hidden onchange="doUpload(this.files)">
+        </div>
+
+        <div class="history-title">Incoming</div>
+        <div id="inbox-feed"></div>
+
+        <div class="history-title">Sent</div>
+        <div id="sent-feed"></div>
+    </div>
+    <script src="/static/client.js"></script>
+</body>
+
+</html>