airshare
Share files wirelessly to nearby devices
TLDR
Share files or directories
Receive a file
Host a receiving server (use this to be able to upload files using the web interface)
Send files or directories to a receiving server
Send files whose paths have been copied to the clipboard
Receive a file and copy it to the clipboard
SYNOPSIS
airshare [OPTIONS] [FILES]...
airshare {gui|daemon} [ARGS]...
PARAMETERS
-h, --host TEXT
Host address to bind
default: 0.0.0.0
-p, --port INTEGER
Port to listen on
default: 8000
--qr / --no-qr
Display QR code for sharing
default: --qr
--gui / --no-gui
Launch desktop GUI
default: --no-gui
-v, --version
Print version information
--help
Show usage help
DESCRIPTION
airshare is a lightweight Python-based CLI tool for sharing files between devices on the same local network. It starts a simple HTTP server, serves specified files (or a directory scan), and displays a shareable URL along with a QR code for easy access from smartphones or other devices.
Ideal for quick transfers without Bluetooth, USB, or cloud services, it works seamlessly on Linux, macOS, and Windows. Run airshare photo.jpg to share a file instantly. The recipient scans the QR or enters the local IP:port to download.
Features include customizable host/port, optional desktop GUI, and daemon mode for persistent sharing. Security relies on network isolation—no authentication by default, so use on trusted LANs. No installation of server software needed on receivers; any browser suffices.
Install via pip install airshare. Handles multiple files/directories, auto-detects network interface, and supports IPv4/IPv6. Perfect for Linux users needing AirDrop-like functionality.
CAVEATS
Local network only; firewall may block ports. No built-in auth—use on trusted Wi-Fi. Requires Python 3 & dependencies like qrcode.
IPv6 support varies.
INSTALLATION
pip install airshare or pipx install airshare for isolated env.
SUBCOMMANDS
airshare gui: Standalone GUI file selector.
airshare daemon: Background service mode.
HISTORY
Created by Federico Ceratto in 2020. Open-source on PyPI/GitHub. Evolved from simple Flask server to feature-rich tool with GUI/daemon support by v2.0 (2022).
