aero-pi-cam documentation

Documentation

A Python 3.13 background service for Raspberry Pi that captures images from an IP camera via RTSP/ffmpeg on a day/night schedule and uploads them via API or SFTP.

Key features:

• Free and open source - no subscription or permission required to use
• Scheduled capture with different intervals for day and night based on sunrise/sunset
• RTSP capture via ffmpeg with authentication support (works with any RTSP camera)
• Multiple upload methods: API (PUT requests with retry logic) or SFTP upload
• METAR/TAF overlay: Optional weather information overlay from Aviation Weather API
• EXIF and XMP metadata: Automatic embedding of camera info, GPS coordinates, and license information
• Systemd service: Auto-start, auto-restart, journald logging

• aero-pi-cam

  Main project documentation and installation guide
• Contributing Guide

  Development setup, workflow, and contribution guidelines
• Python Version Compatibility

  Python version requirements and compatibility information
• Testing Pip Package Installation

  How to test the pip package installation process
• Advanced Usage

  Custom fonts, logos, metadata, upload methods, and advanced configuration

API Documentation

OpenAPI 3.0 specification for the webcam image upload API: