# Find my Photos — Photographer Upload

Upload large folders of event photos quickly. **The app is pre-configured** — no API URL or settings file.

Download from the portal (**Windows** or **Mac** button in the top navigation).

---

## What you need

| Item | Details |
|------|---------|
| **Computer** | Windows 10/11 **or** macOS 12+ |
| **Internet** | Stable connection for large uploads |
| **Event code** | 8-digit code from your event admin |
| **Your email** | The email registered with your event admin |
| **Photo folder** | Folder of JPEG/PNG images |

---

## Windows — unzip and double-click

1. Download **`FindMyPhotos-PhotographerUpload-Windows.zip`**
2. Unzip anywhere (e.g. `Desktop\FindMyPhotos`)
3. Double-click **`FindMyPhotos Photographer Upload.exe`**

**No Python. No configuration.**

### Upload steps

1. Enter **event code** and **email** → **Validate assignment**
2. **Choose folder…** → **Start upload**

Event code and email are remembered on this computer.

---

## macOS — one-time Python, then double-click

Mac needs **Python 3.12+ installed once** (Windows users do not). After that, use the app like any Mac program.

### One-time setup (~3 minutes)

1. Install **Python 3.12+** from https://www.python.org/downloads/  
   Use the **python.org** installer (not Homebrew) — it includes the desktop UI.
2. Download **`FindMyPhotos-PhotographerUpload-Mac.zip`** and unzip
3. Double-click **`Start Upload.command`**
   - First launch installs uploader dependencies (about 1 minute, needs internet)
   - If macOS says the file is from an unidentified developer: **right-click → Open → Open**

### Every upload session

Double-click **`Start Upload.command`** → validate → choose folder → upload.

**No `.env` file or API URL** — connection is built into the app.

> **Optional (admins on a Mac):** run `scripts/build-photographer-mac.sh` on a Mac to build a standalone `.app` with no Python install required.

---

## After upload

Tell your event admin. They run thumbnails and search indexing before photos appear in public search.

---

## Troubleshooting

| Problem | Fix |
|---------|-----|
| Validation failed | Confirm 8-digit code and email with event admin |
| Windows: cannot reach server | Check internet / firewall |
| Mac: Python not found | Install from python.org/downloads, then retry |
| Mac: tkinter missing | Reinstall Python from python.org (not Homebrew) |
| Mac: won't open `.command` | Right-click → Open, or `chmod +x "Start Upload.command"` |
| Some files failed | Retry; check files are valid JPEG/PNG |

---

## Web upload (small batches)

https://ca-face-match-wus2-api.ashysea-65a2222f.westus2.azurecontainerapps.io/photographer

---

## For event admins

Rebuild download zips and redeploy:

```powershell
.\scripts\package-photographer-desktop.ps1
.\scripts\deploy-api-v22.ps1 -ImageTag v25
```
