# 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`)