Skip to main content

CLI Client

Share and download files from your terminal. The SpectrShare CLI is a standalone tool that's fully compatible with the browser client - share from CLI, download in browser, or vice versa. Read the full CLI guide for detailed usage.

The CLI is currently in beta. If you encounter any issues or have feedback, please let us know via our Contact page.

Download

Current version: 0.2.1

Verify your download with SHA-256 checksums

Installation

macOS / Linux

# Download and extract

unzip spectrshare-cli_*.zip

 

# Make executable and move to PATH

chmod +x spectrshare

sudo mv spectrshare /usr/local/bin/

 

# Verify

spectrshare version

Windows

# Extract the zip, then in PowerShell:

.\spectrshare.exe version

Optionally add the directory containing spectrshare.exe to your system PATH for global access.

Quick Start

Share files

spectrshare share file1.txt photos.zip video.mp4

This creates a share room and prints a share code. Anyone with the code can connect and download your files, from either a browser or the CLI.

Password-protected share

spectrshare share secret-docs.pdf --password mysecret

Viewers must enter the correct password before they can download any files. Works with both browser and CLI viewers.

Download files

# Interactive mode - browse and pick files

spectrshare view bright-tiger-ocean-dance -o ./downloads

 

# Auto-download everything

spectrshare view bright-tiger-ocean-dance -o ./downloads -a

Commands

spectrshare share <files...>

Host one or more files for P2P sharing.

FlagDescription
--server <url>Signaling server URL
-v, --verboseVerbose output
--no-tuiPlain text mode (no interactive UI)
--no-turnDisable TURN relay (STUN-only)
--turn-api-token <token>API token for TURN credentials
-p, --password <pass>Require a password to download

spectrshare view <share-code>

Connect to a share and download files.

FlagDescription
--server <url>Signaling server URL
-o, --output <dir>Output directory (default: current directory)
-a, --allAuto-download all files
-v, --verboseVerbose output
--no-tuiPlain text mode (no interactive UI)
--no-turnDisable TURN relay (STUN-only)
--state-dir <dir>Resume state directory
-p, --password <pass>Password for protected shares

Features

Password Protection

Secure your shares with a password. Viewers must authenticate before downloading.

Resume Downloads

Interrupted transfers pick up where they left off.

Hash Verification

Every file is verified with SHA-256 on completion.

Interactive TUI

Rich terminal UI with progress bars and file browser.

Browser Compatible

Share from CLI and download in browser, or the other way around.

Prefer the browser? No download needed.