Share

Local network file sharing via web page. Drag & drop, Ctrl+V paste, download.

No dependencies — Python 3 stdlib only.

Quick start

python3 share.py

Open http://localhost:8888 in a browser. The network address is printed at startup.

Options

python3 share.py -p 3001 -d ~/Downloads/shared --ttl 7

Flag	Default	Description
-p, --port	8888	Port
-d, --dir	~/Downloads/shared	Upload directory
--ttl	7	File lifetime in days (0 = keep forever)
--token		Auth token (empty = open access)
--cert		Path to SSL certificate
--key		Path to SSL key

Authentication

Set token in share.config or pass --token. All endpoints require a valid token.

The token can be stored as plain text or as a SHA-256 hash:

# generate hash
python3 share.py hash mytoken

# store in share.config
token = 9c56cc51b374c3ba189210d5b6d0d04...

If the value is a 64-character hex string, it is treated as a hash. Otherwise it is hashed automatically at startup.

systemd (Arch)

Service file: ~/.config/systemd/user/share.service

systemctl --user enable --now share    # start + autostart
systemctl --user restart share         # restart
systemctl --user stop share            # stop
journalctl --user -u share -f          # logs

Features

• Drag & drop files onto the page
• Ctrl+V to paste images / files from clipboard
• Click the drop zone to open file picker
• Upload progress bar
• File list with download and delete
• Auto-cleanup of old files (configurable via --ttl)