LocalSend CLI

A lightweight, modular Python CLI implementation of the LocalSend Protocol (v2). This tool allows you to discover devices, send files, and receive data directly from your terminal, fully compatible with official LocalSend clients.

Features

• Device Discovery: Scan your local network for active LocalSend instances.
• File Transfer: Send one or multiple files to any LocalSend-enabled device.
• Receiver Mode: Start a local server to receive files, folders, or text messages.
• Self-Signed TLS: Automatic generation of required SSL certificates for secure transfers.

Installation

pip install localsend-cli

Usage

Scan for Devices

Find other LocalSend devices on your network using UDP multicast.

localsend-cli scan

Options:

• --timeout <seconds>: Duration to listen for responses (default: 5).
• --json: Output as a stream of JSON objects.
• --clean: Output only IP addresses.

Send Files

Send files to a specific target IP.

localsend-cli send <device-ip> image.png report.pdf

Options:

• --port <port>: Target port if different from default (53317). You dont need to change this most of the time.
• --json: Progress and status in JSON format.

Receive Files

Start a server to wait for incoming transfers.

localsend-cli receive --output ./incoming

Options:

• --output <dir>: Directory to save received files (default: current directory).
• --pin <code >: Require a specific PIN from the sender.
• --json: Event-based JSON output (ready, incoming, saved, etc.).

Credits

Localsend: Website GitHub

Localsend Protocol: https://github.com/localsend/protocol