Local Sharing
Reimagined.

Secure, fast, and stylish file sharing directly from your terminal.
No cloud needed. Just you and your local network.

curl -sL https://raw.githubusercontent.com/emRival/cli-local-share/main/install.sh | bash
App Demo
🛡️

Defense-in-Depth

Enterprise-grade protection featuring self-signed HTTPS encryption, intelligent rate limiting, and strict IP whitelisting.

⏱️

Ephemeral Sessions

Configurable session lifecycles automatically terminate server access after a set duration. No open ports left behind.

🔄

Seamless OTA Updates

Integrated update engine allows for one-click version upgrades directly from the CLI to get the latest patches.

🎬

Rich Media Previews

Stream videos, listen to audio, and view code/text files directly in the browser without downloading.

🚀

RAM-Safe Uploads

Streaming Upload engine handles files of any size (even 10GB+) with minimal memory footprint. Zero crashes.

💻

Immersive Experience

A sophisticated TUI for operators and a fluid, dark-mode responsive web client for end-users.

Documentation

⚡ Installation

Requirements: Python 3.8+ (Mac, Linux, Windows/WSL, Android via Termux).

Use our automated installer script:

curl -sL https://raw.githubusercontent.com/emRival/cli-local-share/main/install.sh | bash

Or manual installation:

git clone https://github.com/emRival/cli-local-share.git
cd cli-local-share
pip3 install .

🚀 Quick Start

Run the global command to launch the wizard:

sharecli

⚙️ Setup Wizard

The application guides you through a secure setup process:

  • Directory: Interactive browser or manual path.
  • Port: Auto-detects conflicts (Default: 8080).
  • HTTPS: Auto-generates self-signed certs.
  • Permissions: Toggle Upload/Delete capabilities.

🔐 Authentication Modes

Token (Recommended)

Generates a random URL token. Users with the link are logged in automatically.

Password

Traditional username/password flow defined during setup.