kamera 1.0.1

Realtime webcam streaming and video processing with a FastAPI UI

Kamera

Kamera is a small Python app that streams your webcam to a local web page and lets you control video effects in real time.

Features

• Live webcam stream in your browser
• Camera selection (camera_index)
• Rotation (0, 90, 180, 270)
• Brightness control (0.1 to 2.0)
• Grayscale and mirror toggles
• Filters: none, sepia, blur, edges
• Simple HTTP API for automation

Requirements

• Python 3.10+

Install

pip install kamera

If pip is not available in your shell, use:

uv tool run --from kamera kamera

Run

kamera

Open: http://127.0.0.1:4141

How to Use

1. Start kamera
2. Open the web UI
3. Pick a camera index if needed (0 is usually default camera)
4. Change controls and click Apply
5. Click Reset to restore defaults

API

GET /video_feed

Returns the MJPEG stream.

GET /api/settings

Returns current settings.

POST /api/settings

Updates one or more settings.

Example:

curl -X POST http://127.0.0.1:4141/api/settings \
  -H "content-type: application/json" \
  -d '{"camera_index":1,"rotate":90,"brightness":1.3,"grayscale":true,"mirror":false,"filter_name":"sepia"}'

POST /api/settings/reset

Resets all settings to defaults.

curl -X POST http://127.0.0.1:4141/api/settings/reset

Development

uv sync --extra dev
uv run pytest
uv run kamera

License

MIT