lancast 1.0.0

package/README.md

@@ -0,0 +1,125 @@
+# 🚀 LanCast
+
+<p align="center">
+  ⚡ Instant LAN File Sharing from your Terminal  
+  <br/>
+  <b>No setup. No cloud. No accounts.</b>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/lancast?color=green" />
+  <img src="https://img.shields.io/npm/dt/lancast?color=blue" />
+  <img src="https://img.shields.io/npm/l/lancast" />
+</p>
+
+---
+
+## ✨ What is LanCast?
+
+**LanCast** is a LAN-based peer-to-peer file sharing tool that runs directly from your terminal.
+
+It starts a local server and allows devices on the same network to discover each other and transfer files instantly.
+
+🌐 Official Website:
+👉 [https://lancast.zoherdev.xyz](https://lancast.zoherdev.xyz)
+
+---
+
+# ⚡ Installation
+
+Install globally:
+
+```bash
+npm install -g lancast
+```
+
+---
+
+# 🚀 Start LanCast
+
+```bash
+npx lancast start
+```
+
+or
+
+```bash
+lancast start
+```
+
+LanCast will automatically:
+
+* Start server on port **3150**
+* Detect your LAN IP
+* Display access URLs
+* Enable device discovery
+
+Example output:
+
+```
+🌐 Local:   http://localhost:3150
+📡 Network: http://192.168.1.25:3150
+```
+
+Open the network URL on any device connected to the same WiFi.
+
+---
+
+# 🧠 How It Works
+
+```
+Device A joins LAN
+        ↓
+Device B joins LAN
+        ↓
+LanCast shares connected devices
+        ↓
+Select device
+        ↓
+Peer connection established
+        ↓
+File transfers directly device → device
+```
+
+No cloud. No external storage.
+Everything happens inside your local network.
+
+---
+
+# 🔥 Features
+
+* ⚡ Instant device discovery
+* 🔗 Direct peer-to-peer transfer
+* 📁 Send large files
+* 📡 Works on mobile & desktop
+* 🚀 Zero configuration
+* 🔐 Fully private (LAN only)
+
+---
+
+# 🏗 Tech Stack
+
+* Node.js
+* Express
+* Socket.io
+* WebRTC
+* EJS
+
+---
+
+# 🛣 Roadmap
+
+* [ ] Transfer progress indicator
+* [ ] Drag & Drop support
+* [ ] QR code quick connect
+* [ ] PWA support
+* [ ] Desktop version
+
+---
+
+# 👨‍💻 Author
+
+Created by **Zoher Rangwala**
+
+🌐 [https://zoherdev.xyz](https://zoherdev.xyz)
+🌐 [https://lancast.zoherdev.xyz](https://lancast.zoherdev.xyz)

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "lancast",
+  "version": "1.0.0",
+  "description": "LanCast is a LAN-based peer-to-peer file sharing CLI tool. Instantly share files between devices on the same WiFi network with zero configuration.",
+  "type": "module",
+  "main": "server.js",
+  "bin": {
+    "lancast": "./server.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "nodemon server.js"
+  },
+  "keywords": [
+    "lan",
+    "file-sharing",
+    "peer-to-peer",
+    "p2p",
+    "webrtc",
+    "socket.io",
+    "local-network",
+    "wifi-file-transfer",
+    "cli-tool",
+    "xender-alternative",
+    "shareit-alternative",
+    "nodejs"
+  ],
+  "author": "Zoher Rangwala",
+  "license": "MIT",
+  "homepage": "https://lancast.zoherdev.xyz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zoherr/lancast.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zoherr/lancast/issues"
+  },
+  "dependencies": {
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "ejs": "^3.1.9",
+    "express": "^4.18.2",
+    "figlet": "^1.10.0",
+    "socket.io": "^4.7.4"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/public/main.js

@@ -0,0 +1,271 @@
+const socket = io();
+let peerConnection;
+let dataChannel;
+let currentActivePeer = null;
+
+const config = {
+    iceServers: [
+        
+    ]
+};
+
+const statusEl = document.getElementById('status');
+const usersListEl = document.getElementById('users-list');
+const networkZone = document.getElementById('network-zone');
+const transferZone = document.getElementById('transfer-zone');
+const fileInput = document.getElementById('file-input');
+const progressContainer = document.getElementById('progress-container');
+const fileProgress = document.getElementById('file-progress');
+const progressText = document.getElementById('progress-text');
+const receivedFilesList = document.getElementById('received-files');
+
+const requestModal = document.getElementById('request-modal');
+const requesterIdEl = document.getElementById('requester-id');
+const acceptBtn = document.getElementById('accept-btn');
+const rejectBtn = document.getElementById('reject-btn');
+const disconnectBtn = document.getElementById('disconnect-btn');
+
+let receiveBuffer = [];
+let receivedSize = 0;
+let expectedFileSize = 0;
+let expectedFileName = '';
+let pendingRequester = null;
+
+function updateStatus(message, isError = false) {
+    statusEl.textContent = message;
+    statusEl.style.color = isError ? 'var(--danger)' : 'var(--primary)';
+    statusEl.style.background = isError ? '#ffebee' : '#eef2ff';
+}
+
+socket.on('connect', () => {
+    updateStatus(`My ID: ${socket.id.substring(0, 5)}`);
+});
+
+socket.on('update-user-list', (users) => {
+    usersListEl.innerHTML = '';
+    const otherUsers = users.filter(u => u.id !== socket.id);
+
+    if (otherUsers.length === 0) {
+        usersListEl.innerHTML = '<p style="color: #666; font-size: 0.9rem;">No other devices on network.</p>';
+        return;
+    }
+
+    otherUsers.forEach(user => {
+        const btn = document.createElement('button');
+        btn.className = 'user-btn';
+        btn.innerHTML = `<span>📱 Device_${user.id.substring(0, 5)}</span> <span>Connect →</span>`;
+        btn.onclick = () => sendConnectionRequest(user.id);
+        usersListEl.appendChild(btn);
+    });
+});
+
+function sendConnectionRequest(targetId) {
+    updateStatus(`Sending request to Device_${targetId.substring(0, 5)}...`);
+    socket.emit('connection-request', { to: targetId });
+}
+
+socket.on('connection-request', (data) => {
+    if (currentActivePeer) {
+        socket.emit('connection-response', { to: data.from, accepted: false });
+        return;
+    }
+    pendingRequester = data.from;
+    requesterIdEl.textContent = `Device_${data.from.substring(0, 5)}`;
+    requestModal.style.display = 'flex';
+});
+
+acceptBtn.onclick = () => {
+    requestModal.style.display = 'none';
+    socket.emit('connection-response', { to: pendingRequester, accepted: true });
+    updateStatus(`Accepted request. Establishing connection...`);
+};
+
+rejectBtn.onclick = () => {
+    requestModal.style.display = 'none';
+    socket.emit('connection-response', { to: pendingRequester, accepted: false });
+    pendingRequester = null;
+    updateStatus(`My ID: ${socket.id.substring(0, 5)}`);
+};
+
+socket.on('connection-response', async (data) => {
+    if (data.accepted) {
+        updateStatus(`Request accepted! Connecting to Device_${data.from.substring(0, 5)}...`);
+        await initiateWebRTCConnection(data.from);
+    } else {
+        updateStatus(`Device_${data.from.substring(0, 5)} rejected your request.`, true);
+        setTimeout(() => updateStatus(`My ID: ${socket.id.substring(0, 5)}`), 3000);
+    }
+});
+
+function setupPeerConnection(targetId) {
+    peerConnection = new RTCPeerConnection(config);
+    currentActivePeer = targetId;
+
+    peerConnection.onicecandidate = (event) => {
+        if (event.candidate) {
+            socket.emit('ice-candidate', { to: targetId, candidate: event.candidate });
+        }
+    };
+
+    peerConnection.onconnectionstatechange = () => {
+        if (peerConnection.connectionState === 'connected') {
+            updateStatus(`🟢 Connected to Device_${targetId.substring(0, 5)}`);
+            networkZone.style.display = 'none';
+            transferZone.style.display = 'block';
+        } else if (peerConnection.connectionState === 'disconnected' || peerConnection.connectionState === 'failed') {
+            handleDisconnection(false); 
+        }
+    };
+
+    peerConnection.ondatachannel = (event) => {
+        dataChannel = event.channel;
+        setupDataChannel();
+    };
+}
+
+function handleDisconnection(notifyPeer = true) {
+    if (notifyPeer && currentActivePeer) {
+        socket.emit('peer-disconnected', { to: currentActivePeer });
+    }
+
+    if (peerConnection) {
+        peerConnection.close();
+        peerConnection = null;
+    }
+
+    currentActivePeer = null;
+    dataChannel = null;
+    networkZone.style.display = 'block';
+    transferZone.style.display = 'none';
+    updateStatus(`My ID: ${socket.id.substring(0, 5)}`);
+}
+
+disconnectBtn.onclick = () => handleDisconnection(true);
+
+function setupDataChannel() {
+    dataChannel.binaryType = 'arraybuffer';
+
+    dataChannel.onmessage = (event) => {
+        if (typeof event.data === 'string') {
+            const metadata = JSON.parse(event.data);
+            expectedFileName = metadata.name;
+            expectedFileSize = metadata.size;
+            receiveBuffer = [];
+            receivedSize = 0;
+            progressContainer.style.display = 'block';
+        } else {
+            receiveBuffer.push(event.data);
+            receivedSize += event.data.byteLength;
+
+            const percentage = Math.round((receivedSize / expectedFileSize) * 100);
+            fileProgress.value = percentage;
+            progressText.textContent = `Receiving: ${percentage}%`;
+
+            if (receivedSize === expectedFileSize) {
+                const blob = new Blob(receiveBuffer);
+                const downloadUrl = URL.createObjectURL(blob);
+                const li = document.createElement('li');
+                const a = document.createElement('a');
+                a.href = downloadUrl;
+                a.download = expectedFileName;
+                a.textContent = `💾 ${expectedFileName}`;
+                li.appendChild(a);
+                receivedFilesList.appendChild(li);
+
+                progressText.textContent = 'Complete!';
+                setTimeout(() => progressContainer.style.display = 'none', 2000);
+            }
+        }
+    };
+}
+
+async function initiateWebRTCConnection(targetId) {
+    setupPeerConnection(targetId);
+    dataChannel = peerConnection.createDataChannel('fileTransfer');
+    setupDataChannel();
+
+    const offer = await peerConnection.createOffer();
+    await peerConnection.setLocalDescription(offer);
+
+    socket.emit('offer', { to: targetId, offer: offer });
+}
+
+socket.on('offer', async (data) => {
+    setupPeerConnection(data.sender);
+    await peerConnection.setRemoteDescription(new RTCSessionDescription(data.offer));
+    const answer = await peerConnection.createAnswer();
+    await peerConnection.setLocalDescription(answer);
+    socket.emit('answer', { to: data.sender, answer: answer });
+});
+
+socket.on('answer', async (data) => {
+    await peerConnection.setRemoteDescription(new RTCSessionDescription(data.answer));
+});
+
+socket.on('ice-candidate', async (data) => {
+    try {
+        await peerConnection.addIceCandidate(new RTCIceCandidate(data.candidate));
+    } catch (e) {
+        console.error(e);
+    }
+});
+
+fileInput.addEventListener('change', () => {
+    const file = fileInput.files[0];
+    if (!file || !dataChannel || dataChannel.readyState !== 'open') return;
+
+    dataChannel.send(JSON.stringify({ name: file.name, size: file.size }));
+
+    const chunkSize = 16384;
+    let offset = 0;
+
+    progressContainer.style.display = 'block';
+
+    const readSlice = (o) => {
+        const slice = file.slice(offset, o + chunkSize);
+        const reader = new FileReader();
+
+        reader.onload = (e) => {
+            dataChannel.send(e.target.result);
+            offset += chunkSize;
+
+            const percentage = Math.round((offset / file.size) * 100);
+            fileProgress.value = Math.min(percentage, 100);
+            progressText.textContent = `Sending: ${Math.min(percentage, 100)}%`;
+
+            if (offset < file.size) {
+                if (dataChannel.bufferedAmount > 65535) {
+                    dataChannel.onbufferedamountlow = () => {
+                        dataChannel.onbufferedamountlow = null;
+                        readSlice(offset);
+                    };
+                } else {
+                    readSlice(offset);
+                }
+            } else {
+                progressText.textContent = 'Sent!';
+                setTimeout(() => {
+                    progressContainer.style.display = 'none';
+                    fileInput.value = '';
+                }, 2000);
+            }
+        };
+        reader.readAsArrayBuffer(slice);
+    };
+
+    readSlice(0);
+});
+
+function handleDisconnection() {
+    if (peerConnection) {
+        peerConnection.close();
+        peerConnection = null;
+    }
+    currentActivePeer = null;
+    dataChannel = null;
+    networkZone.style.display = 'block';
+    transferZone.style.display = 'none';
+    updateStatus(`My ID: ${socket.id.substring(0, 5)}`);
+}
+
+disconnectBtn.onclick = handleDisconnection;

package/public/style.css

@@ -0,0 +1,193 @@
+:root {
+    --bg: #f4f7f6;
+    --primary: #4361ee;
+    --primary-hover: #3a53d0;
+    --text: #333;
+    --card-bg: #fff;
+    --success: #2ecc71;
+    --danger: #e74c3c;
+    --border: #e0e0e0;
+}
+
+* {
+    box-sizing: border-box;
+    margin: 0;
+    padding: 0;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+}
+
+body {
+    background-color: var(--bg);
+    color: var(--text);
+    display: flex;
+    justify-content: center;
+    padding: 20px;
+}
+
+.container {
+    background: var(--card-bg);
+    width: 100%;
+    max-width: 500px;
+    border-radius: 12px;
+    box-shadow: 0 8px 20px rgba(0, 0, 0, 0.05);
+    padding: 24px;
+}
+
+h1 {
+    text-align: center;
+    font-size: 1.5rem;
+    margin-bottom: 8px;
+    color: var(--primary);
+}
+
+.status-badge {
+    display: block;
+    text-align: center;
+    font-size: 0.85rem;
+    padding: 6px 12px;
+    border-radius: 20px;
+    background: #eef2ff;
+    color: var(--primary);
+    margin-bottom: 24px;
+    font-weight: 500;
+}
+
+h3 {
+    font-size: 1.1rem;
+    margin: 20px 0 12px;
+    border-bottom: 1px solid var(--border);
+    padding-bottom: 8px;
+}
+
+.user-btn {
+    width: 100%;
+    background: var(--card-bg);
+    border: 1px solid var(--border);
+    padding: 12px;
+    border-radius: 8px;
+    font-size: 1rem;
+    cursor: pointer;
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 8px;
+    transition: all 0.2s;
+}
+
+.user-btn:hover {
+    border-color: var(--primary);
+    background: #f8faff;
+}
+
+.modal-overlay {
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background: rgba(0, 0, 0, 0.5);
+    display: none;
+    justify-content: center;
+    align-items: center;
+    z-index: 1000;
+}
+
+.modal {
+    background: var(--card-bg);
+    padding: 24px;
+    border-radius: 12px;
+    width: 90%;
+    max-width: 350px;
+    text-align: center;
+}
+
+.modal p {
+    margin-bottom: 20px;
+    font-size: 1.1rem;
+}
+
+.modal-actions {
+    display: flex;
+    gap: 12px;
+}
+
+.btn {
+    flex: 1;
+    padding: 10px;
+    border: none;
+    border-radius: 6px;
+    font-size: 1rem;
+    cursor: pointer;
+    color: white;
+    font-weight: 500;
+}
+
+.btn-accept {
+    background: var(--success);
+}
+
+.btn-reject {
+    background: var(--danger);
+}
+
+.btn-primary {
+    background: var(--primary);
+    width: 100%;
+    margin-top: 10px;
+}
+
+input[type="file"] {
+    width: 100%;
+    padding: 10px;
+    border: 1px dashed var(--primary);
+    border-radius: 8px;
+    background: #f8faff;
+    cursor: pointer;
+}
+
+.progress-wrapper {
+    margin-top: 15px;
+    display: none;
+}
+
+progress {
+    width: 100%;
+    height: 8px;
+    border-radius: 4px;
+}
+
+progress::-webkit-progress-bar {
+    background-color: var(--border);
+    border-radius: 4px;
+}
+
+progress::-webkit-progress-value {
+    background-color: var(--primary);
+    border-radius: 4px;
+}
+
+.progress-text {
+    display: block;
+    text-align: right;
+    font-size: 0.85rem;
+    margin-top: 4px;
+    font-weight: 500;
+}
+
+#received-files {
+    list-style: none;
+}
+
+#received-files li {
+    background: #f8faff;
+    border: 1px solid var(--border);
+    padding: 12px;
+    border-radius: 8px;
+    margin-bottom: 8px;
+}
+
+#received-files a {
+    text-decoration: none;
+    color: var(--primary);
+    font-weight: 500;
+}

package/server.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+import express from 'express';
+import { createServer } from 'http';
+import { Server } from 'socket.io';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+import boxen from 'boxen';
+import figlet from 'figlet';
+import os from 'os';
+
+const args = process.argv.slice(2);
+if (args[0] !== 'start') {
+    console.log(chalk.red('\n❌ Invalid command. Please run:\n👉 npx laracast start\n'));
+    process.exit(1);
+}
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const app = express();
+const server = createServer(app);
+const io = new Server(server, {
+    cors: {
+        origin: "*",
+        methods: ["GET", "POST"]
+    }
+});
+
+app.set('view engine', 'ejs');
+app.set('views', path.join(__dirname, 'views'));
+app.use(express.static(path.join(__dirname, 'public')));
+
+app.get('/', (req, res) => {
+    res.render('index');
+});
+
+const connectedUsers = new Map();
+
+io.on('connection', (socket) => {
+    connectedUsers.set(socket.id, { id: socket.id });
+
+    io.emit('update-user-list', Array.from(connectedUsers.values()));
+
+    socket.on('connection-request', (data) => {
+        socket.to(data.to).emit('connection-request', {
+            from: socket.id
+        });
+    });
+
+    socket.on('connection-response', (data) => {
+        socket.to(data.to).emit('connection-response', {
+            from: socket.id,
+            accepted: data.accepted
+        });
+    });
+
+    socket.on('offer', (data) => {
+        socket.to(data.to).emit('offer', {
+            offer: data.offer,
+            sender: socket.id
+        });
+    });
+
+    socket.on('peer-disconnected', (data) => {
+        socket.to(data.to).emit('peer-disconnected');
+    });
+
+    socket.on('answer', (data) => {
+        socket.to(data.to).emit('answer', {
+            answer: data.answer,
+            sender: socket.id
+        });
+    });
+
+    socket.on('ice-candidate', (data) => {
+        socket.to(data.to).emit('ice-candidate', {
+            candidate: data.candidate,
+            sender: socket.id
+        });
+    });
+
+    socket.on('disconnect', () => {
+        connectedUsers.delete(socket.id);
+        io.emit('update-user-list', Array.from(connectedUsers.values()));
+    });
+});
+
+const PORT = process.env.PORT || 3150;
+
+function getLocalIP() {
+    const interfaces = os.networkInterfaces();
+    for (const name of Object.keys(interfaces)) {
+        for (const iface of interfaces[name]) {
+            if (iface.family === 'IPv4' && !iface.internal) {
+                return iface.address;
+            }
+        }
+    }
+    return '127.0.0.1';
+}
+
+server.listen(PORT, '0.0.0.0', () => {
+    console.clear();
+
+    const title = figlet.textSync('LARACAST', {
+        font: 'Slant',
+        horizontalLayout: 'fitted',
+        verticalLayout: 'default'
+    });
+
+    console.log(chalk.cyan(title));
+
+    const lanIP = getLocalIP();
+
+    const message = `
+🚀 Server Running Successfully
+
+🌐 Local:   http://localhost:${PORT}
+📡 Network: http://${lanIP}:${PORT}
+
+Use port ${PORT}
+`;
+
+    console.log(
+        boxen(chalk.green(message), {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'cyan'
+        })
+    );
+});

package/views/index.ejs

@@ -0,0 +1,50 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>LANCast</title>
+    <link rel="stylesheet" href="/style.css">
+</head>
+
+<body>
+    <div class="container">
+        <h1>LANCast P2P</h1>
+        <span id="status" class="status-badge">Connecting to signaling server...</span>
+
+        <div id="network-zone">
+            <h3>Available Devices</h3>
+            <div id="users-list"></div>
+        </div>
+
+        <div id="transfer-zone" style="display: none;">
+            <h3>Transfer Files</h3>
+            <input type="file" id="file-input" />
+            <div id="progress-container" class="progress-wrapper">
+                <progress id="file-progress" value="0" max="100"></progress>
+                <span id="progress-text" class="progress-text">0%</span>
+            </div>
+            <button id="disconnect-btn" class="btn btn-primary"
+                style="background: var(--danger); margin-top: 15px;">Disconnect</button>
+        </div>
+
+        <h3>Received Files</h3>
+        <ul id="received-files"></ul>
+    </div>
+
+    <div id="request-modal" class="modal-overlay">
+        <div class="modal">
+            <p><strong id="requester-id"></strong> wants to connect and share files.</p>
+            <div class="modal-actions">
+                <button id="accept-btn" class="btn btn-accept">Accept</button>
+                <button id="reject-btn" class="btn btn-reject">Reject</button>
+            </div>
+        </div>
+    </div>
+
+    <script src="/socket.io/socket.io.js"></script>
+    <script src="/main.js"></script>
+</body>
+
+</html>