65 lines
1.6 KiB
Markdown
65 lines
1.6 KiB
Markdown
# 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`)
|