Files

75 lines
6.6 KiB
Markdown

# ⚡ ZeroSend v2.4.1 (Shared Folders, HTTP 206 Streaming, Vim Viewer & Portable Mode)
> **Ultra-fast, lightweight, peer-to-peer file & text sharing designed specifically for ZeroTier, Tailscale, Radmin VPN, and LAN networks.**
ZeroSend 2.4.1 is a modern, standalone, privacy-first alternative to LocalSend that is explicitly optimized for virtual mesh networks (ZeroTier, Tailscale, Radmin VPN). It features Network-wide Shared Folders with Read-Only / Read-Write permissions, instant HTTP 206 partial content streaming for video and music without waiting for downloads, an authentic embedded lightweight Vim code and text viewer, a self-contained single-folder portable storage mode (`config.json`), mobile-first Web dropzone with camera/voice-notes shortcuts, dual QR access links, 4-stream parallel chunk streaming, on-the-fly folder ZIP compression, and dynamic light/dark themes.
---
## ✨ Features Overview
### 📁 1. Network Shared Folders & Media Streaming (v2.4.1)
* **My Shares:** Select any folder on your hard drive to share with friends over ZeroTier/LAN. Configure **Read-Only** (streaming & download) or **Read & Write** (friends can upload files directly to your folder), protected with an optional 4-digit PIN code.
* **Network Shares Explorer:** Browse your friends' shared directories with interactive breadcrumb path navigation and instant search filtering.
* **🎬 Instant HTTP 206 Media Streaming:** Watch shared movies, TV series, or listen to music on-the-fly with instant seeking without having to download the entire file first.
* **⚡ Embedded Vim Code & Text Viewer:** Inspect `.rs`, `.py`, `.js`, `.ts`, `.html`, `.json`, `.toml`, `.cpp`, `.md`, and `.txt` files directly inside ZeroSend with genuine Vim keybindings (`j`/`k`, `Ctrl+d`/`Ctrl+u`, `gg`/`G`, `/` pattern search with live highlights, `:q` exit, `:<line>` line jump).
* **📦 Single-Folder Portable Mode:** All configuration (`config.json`), downloads, and settings are created and saved directly inside the folder where `zerosend.exe` is located.
* **🔄 Zero-Config Auto-Sync:** Shared folders are broadcast dynamically via discovery beacons (`DiscoveryBeacon`), automatically appearing when a peer joins the mesh network.
### 📱 2. Mobile-First Web Dropzone & PWA (v2.4.0)
* **Mobile-First Touch Dashboard:** Optimized for iOS and Android with direct `📸 Photos/Videos`, `📄 Documents`, and `🎙️ Voice Note` recording action chips.
* **Thumbnail Gallery Previews:** Real-time preview of selected photos and images before sending, with 1-tap delete chips.
* **🎙️ Mobile Voice Notes:** Built-in Web Audio recorder with live sound wave animation and instant delivery to PC.
* **📲 PWA Standalone App:** Add to Home Screen support on iOS and Android with custom app icons and manifest.
* **Dual QR & Access Links:** Separate ZeroTier/VPN mesh link (`http://<zerotier_ip>:53318`) and Home Wi-Fi/LAN link (`http://<local_ip>:53318`) with 1-click copy, QR code, and browser launch.
* **🛡️ SHA-256 Checksum on the Fly:** Cryptographic hash integrity verification computed in parallel during transmission with green badge status.
### ⚡ 3. High-Performance Multi-Stream Engine
* **4-Stream Parallel Chunk Transfers:** Automatically splits single large files or batches into concurrent 4x HTTP/TCP streams, eliminating TCP window bottlenecks over VPN links.
* **Chunk Auto-Retry & Fault Tolerance:** Automatic retry (up to 3 attempts) for failed chunks on Wi-Fi or VPN micro-disconnects without dropping the whole transfer.
* **Dynamic Adaptive Chunk Sizing:** Scales chunk granularity from 512 KB (small files) up to 8 MB (huge 10GB+ archives) to maximize throughput and minimize overhead.
* **Live Ping & Latency Indicator:** Real-time round-trip latency (`🟢 12 ms` / `🟡 65 ms` / `🔴 140 ms`) displayed right next to each peer in the Nearby list.
* **Custom Bandwidth Speed Limiter:** Token-bucket upload rate limiter with interactive custom numeric input and 1-click presets (`Unlimited`, `5`, `10`, `25`, `50`, `100 MB/s`).
* **Resumable Transfers (.zerosend_part Checkpointing):** Interrupted transfers seamlessly resume from the exact last chunk offset.
* **Pinned Favorite Friends:** Star (`⭐`) frequently used friends in the **Nearby** tab to pin them to the top.
### 📦 4. On-The-Fly Folder ZIP Compression & Auto-Extract
* **10x Faster Folder Sharing:** Packages directory trees into streaming Deflate ZIP archives on the fly.
* **Automatic Extraction:** The recipient's ZeroSend automatically extracts the received ZIP folder right into their Downloads directory.
* **Web & Mobile Friendly:** Mobile devices downloading via QR code get a clean single `.zip` file with 1 tap.
### 🎨 5. Dynamic Theme & Desktop Polish
* **🌓 Auto Dark/Light Theme:** Automatically synchronizes with Windows 10/11 system theme or allows forcing Always Dark / Always Light with high-contrast text readability.
* **System Tray Resident:** Minimizes cleanly to the Windows system tray with auto-popup on incoming file requests.
* **Drag & Drop Anywhere:** Drag files or folders into the window or directly onto a peer's card in the Nearby list.
* **Clipboard Screenshots (`Ctrl+V`):** Paste screenshots directly from clipboard to queue them for immediate transfer.
---
## 📜 Version History (Changelog)
### **v2.4.1 (Current Release)**
* 📁 **Shared Folders Tab:** Dedicated Shared Folders management with Read-Only / Read-Write permissions and PIN security.
* 🎬 **HTTP 206 Streaming:** Instant real-time video/audio streaming with seeking without downloading entire files.
* ⚡ **Built-in Vim Code Viewer:** Terminal-style code viewer with full Vim keybindings, search (`/`), and line jump.
* 📦 **Single-Folder Portable Mode:** All settings (`config.json`) and downloads are created & saved right in the exe folder.
* 🔄 **Auto-Sync:** Real-time discovery beacon broadcasting of shared folders when connecting to ZeroTier/VPN.
### **v2.4.0**
* 🛡️ **SHA-256 Checksum on the Fly:** File integrity calculation & verification during streaming with green verification badges.
* 📸 **Mobile Media Previews:** Thumbnail gallery previews for photos with instant remove buttons before uploading.
* 🎙️ **Mobile Voice Notes:** Built-in voice recorder with live audio wave pulse animation and one-tap delivery.
* 📲 **PWA Support:** Web App Manifest & Add to Home Screen standalone install capabilities for mobile browsers.
* 🎨 **Auto Theme:** Dark/Light theme mode with Windows Registry theme sync & contrast fixes.
---
## 🚀 Building from Source
```bash
cargo build --release
```
The compiled standalone binary will be located at:
`target/release/zerosend.exe`