whozbin

Camera activity recorder with webcam-based motion detection, optional person detection backends, automatic recording, and asynchronous Telegram video upload.

Setup with uv

Default runtime:

uv sync

Optional Hugging Face detector backend:

uv sync --extra huggingface

Run

uv run whozbin

Configuration

Edit presence_recorder/config.py to set:

• TELEGRAM_BOT_TOKEN
• TELEGRAM_CHAT_ID
• DETECTOR_BACKEND ("motion", "hog", or "huggingface")

Detector recommendation for a MacBook M3 Pro

• Use motion for the default static-camera workflow when you want reliable record-on-movement behavior.
• Use hog or huggingface only when you specifically need person classification rather than general activity.
• Motion detection is intentionally more permissive: it will trigger on moving people and other moving foreground objects, and it may stop recording if someone stays completely still for the full stop timeout.