# KPRSpaceAPI

Implementation of the Space API used in KPR, based on a simple webcam running through Motion which detects whether the light is turned on and updates the status of the space accordingly.

## Run (fish shell)

Create and activate a virtual environment, install dependencies and run the server (example using fish):

```fish
python3 -m venv venv
source venv/bin/activate.fish
pip install -r requirements.txt

# Configure environment (examples)
set -x SNAPSHOT_INTERVAL 600           # seconds (600 = 10 minutes)
set -x BRIGHTNESS_THRESHOLD 100        # 0-255
set -x AUTO_START false                # true to auto-start on process launch

# Run the app
python app.py
```

Notes
- Screenshots are saved to `./screenshots` by default. Override with `MOTION_DIR`.
- To start/stop the monitor at runtime:
  - Start: `curl -X POST http://localhost:5000/api/start`
  - Stop:  `curl -X POST http://localhost:5000/api/stop`
- The `SNAPSHOT_INTERVAL` env var is interpreted in seconds.
- If you want the server to auto-start the monitor on launch, set `AUTO_START=true` before launching.
- For production use, run under a WSGI server (gunicorn, systemd unit, docker, etc.).