[{"_1":2,"_173":-5,"_174":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_146":147},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":11,"_17":11,"_18":19,"_20":11},"username","isBillingDecouplingSeatCount","isSearchBoxExperimentEnabled","isAskGordonEnabled",true,"isUsingNewTemplate","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_139":-5,"_140":11,"_141":11,"_142":11,"_143":-5,"_144":145},"canonicalUrl","https://hub.docker.com/r/rjsears/unifi-timelapse-api/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","rjsears","reponame","unifi-timelapse-api","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2026-02-06T16:47:48.564945Z","description","","is_private","last_updated","2026-02-28T01:09:10.292528Z","last_modified","2026-02-28T01:11:51.620524Z","media_types",[52],"application/vnd.oci.image.index.v1+json","name","pull_count",2697,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# UniFi Timelapse System\n\n[![Docker](https://img.shields.io/badge/Docker-Container-2496ED?logo=docker&logoColor=white)](https://www.docker.com/)\n[![Python](https://img.shields.io/badge/Python-3.11+-3776AB?logo=python&logoColor=white)](https://www.python.org/)\n[![FastAPI](https://img.shields.io/badge/FastAPI-REST_API-009688?logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com/)\n[![Vue.js](https://img.shields.io/badge/Vue.js-Frontend-4FC08D?logo=vue.js&logoColor=white)](https://vuejs.org/)\n[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-Database-336791?logo=postgresql&logoColor=white)](https://www.postgresql.org/)\n[![Redis](https://img.shields.io/badge/Redis-Cache-DC382D?logo=redis&logoColor=white)](https://redis.io/)\n[![FFMPEG](https://img.shields.io/badge/FFMPEG-Video-007808?logo=ffmpeg&logoColor=white)](https://ffmpeg.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Version](https://img.shields.io/badge/Version-1.0.0-blue.svg)]()\n[![Release](https://img.shields.io/badge/Release-February%202026-orange.svg)]()\n\n> ### *\"The best time to plant a tree was 20 years ago. The second best time is now.\"* — Chinese Proverb\n\n---\n\n## What This Project Does\n\nThe **UniFi Timelapse System** is a comprehensive Docker-based solution that captures images from UniFi cameras (or any HTTP-accessible cameras) at configurable intervals, organizes them in a structured directory hierarchy, and automatically generates beautiful timelapse videos using FFMPEG.\n\nThe system captures images every 30 seconds (configurable) from multiple cameras concurrently, stores them in an organized `{camera_name}/{YYYYMMDD}/` structure, and generates daily 24-hour timelapse videos automatically each night. For longer-term storytelling, it also creates multi-day summary timelapses by intelligently selecting a configurable number of images per hour across multiple days, with those selected images protected from automatic cleanup.\n\nA dedicated health monitor continuously checks camera connectivity, detects blank or frozen images, and sends notifications via Apprise to any platform you choose (Slack, Discord, NTFY, Email, and 80+ others). The Vue.js web interface provides real-time monitoring, camera management, timelapse browsing, and system configuration—all in a clean, dark-themed dashboard.\n\nThe entire system runs as a self-contained Docker Compose stack with 8 containers working in harmony, designed for hands-off 24/7 operation with automatic cleanup and intelligent retention policies.\n\n---\n\n## Table of Contents\n\n- [Features](#-features)\n- [System Architecture](#-system-architecture)\n- [Container Overview](#-container-overview)\n- [Requirements](#-requirements)\n- [Quick Start](#-quick-start)\n- [Configuration](#-configuration)\n- [Web Interface](#-web-interface)\n- [API Reference](#-api-reference)\n- [Directory Structure](#-directory-structure)\n- [Multi-Day Timelapses](#-multi-day-timelapses)\n- [Health Monitoring](#-health-monitoring)\n- [Notifications](#-notifications)\n- [Useful Commands](#-useful-commands)\n- [Troubleshooting](#-troubleshooting)\n- [Development](#-development)\n- [Docker Images](#-docker-images)\n- [License](#-license)\n- [Special Thanks](#-special-thanks)\n\n---\n\n## ✨ Features\n\n### Image Capture\n\n- **Async Concurrent Capture** — Captures from up to 50 cameras simultaneously using asyncio\n- **Configurable Intervals** — Per-camera capture intervals (default 30 seconds)\n- **Automatic Retry** — Configurable retry logic with exponential backoff\n- **Blackout Periods** — Per-camera scheduling to skip captures during specific hours (supports overnight spans like 22:00-06:00)\n- **Organized Storage** — Images stored in `{camera_name}/{YYYYMMDD}/{timestamp}_{camera}.jpeg`\n\n### Daily Timelapses\n\n- **Automatic Generation** — Creates 24-hour timelapse videos every night at configurable time\n- **FFMPEG Powered** — High-quality H.264 encoding with configurable CRF, frame rate, and pixel format\n- **Web Optimized** — Uses `-movflags +faststart` for instant web playback\n- **Cleanup After Encode** — Optionally removes source images after successful timelapse generation\n\n### Multi-Day Timelapses\n\n- **Two Generation Modes** — Historical (look back) and Prospective (collect forward)\n- **Historical Mode** — Generate timelapses from existing images on a schedule\n- **Prospective Mode** — Protect images as they're captured over a period, then generate\n- **Custom Timelapse** — One-off generation from existing images with date range picker\n- **Smart Selection** — Configurable images per hour across the date range\n- **Image Protection** — Selected images marked as protected from automatic cleanup\n- **Scheduled Generation** — Runs weekly on configurable day and time\n\n### Health Monitoring\n\n- **Connectivity Checks** — Regular HTTP HEAD requests to verify camera reachability\n- **Blank Detection** — Identifies cameras returning blank/black images using pixel variance analysis\n- **Frozen Detection** — Detects stuck cameras using perceptual image hashing\n- **Uptime Tracking** — Maintains historical uptime percentage per camera\n- **Alert Cooldown** — Prevents notification spam with per-camera alert cooldowns\n\n### Notifications\n\n- **Apprise Integration** — 80+ notification platforms supported out of the box\n- **Flexible Triggers** — Alerts for capture failures, health issues, timelapse completion\n- **Failure Thresholds** — Configurable consecutive failures before alerting\n- **Per-Camera Cooldowns** — Prevent notification fatigue\n\n### Web Interface\n\n- **Vue.js 3 Dashboard** — Modern, responsive interface with dark/light mode toggle\n- **Top Navigation** — Clean horizontal navigation bar with quick access to all sections\n- **Real-Time Monitoring** — Live camera status and capture statistics\n- **Timelapse Browser** — View, play, and download generated videos\n- **Custom Timelapse Builder** — Create one-off timelapses from existing images with date range picker\n- **Image Gallery** — Browse captured images with protection toggle\n- **Collapsible Settings** — Organized settings panels with icons for easy navigation\n- **About Dialog** — Version information, author details, and GitHub link\n\n### Automatic Cleanup\n\n- **Retention Policies** — Separate retention periods for images and videos\n- **Protected Images** — Images used in multi-day timelapses excluded from cleanup\n- **Scheduled Runs** — Cleanup runs daily at configurable time\n- **Safe Deletion** — Never deletes in-progress or referenced files\n\n---\n\n## 🏗 System Architecture\n\n```mermaid\nflowchart TB\n subgraph CAMERAS[\"📷 Camera Network\"]\n CAM1[\"Camera 1\"]\n CAM2[\"Camera 2\"]\n CAM3[\"Camera N\"]\n end\n\n subgraph DOCKER[\"Docker Compose Stack\"]\n subgraph FRONTEND[\"Frontend Layer\"]\n NGINX[\"Nginx
Reverse Proxy\"]\n VUE[\"Vue.js
Frontend\"]\n end\n\n subgraph API_LAYER[\"API Layer\"]\n API[\"FastAPI
REST API\"]\n end\n\n subgraph WORKERS[\"Worker Layer\"]\n WORKER[\"Worker
Capture & FFMPEG\"]\n HEALTH[\"Health
Monitor\"]\n end\n\n subgraph DATA[\"Data Layer\"]\n PG[(\"PostgreSQL
Database\")]\n REDIS[(\"Redis
Cache\")]\n end\n\n subgraph NOTIFY[\"Notification Layer\"]\n APPRISE[\"Apprise
Notifications\"]\n end\n\n subgraph STORAGE[\"Storage Layer\"]\n IMAGES[(\"Images
/output/images\")]\n VIDEOS[(\"Videos
/output/videos\")]\n end\n end\n\n subgraph PLATFORMS[\"📱 Notification Platforms\"]\n SLACK[\"Slack\"]\n DISCORD[\"Discord\"]\n NTFY[\"NTFY\"]\n EMAIL[\"Email\"]\n end\n\n CAM1 & CAM2 & CAM3 -->|\"HTTP GET\"| WORKER\n WORKER -->|\"Store\"| IMAGES\n WORKER -->|\"Encode\"| VIDEOS\n WORKER <-->|\"Read/Write\"| PG\n WORKER -->|\"Cache\"| REDIS\n\n HEALTH -->|\"Check\"| CAM1 & CAM2 & CAM3\n HEALTH <-->|\"Read/Write\"| PG\n HEALTH -->|\"Alerts\"| APPRISE\n\n API <-->|\"CRUD\"| PG\n API -->|\"Cache\"| REDIS\n API -->|\"Notify\"| APPRISE\n\n VUE -->|\"/api/*\"| NGINX\n NGINX -->|\"Proxy\"| API\n NGINX -->|\"Static\"| VUE\n NGINX -->|\"Media\"| IMAGES & VIDEOS\n\n APPRISE -->|\"Send\"| SLACK & DISCORD & NTFY & EMAIL\n\n style NGINX fill:#009639,color:#fff\n style API fill:#009688,color:#fff\n style WORKER fill:#FF6D00,color:#fff\n style HEALTH fill:#E91E63,color:#fff\n style PG fill:#336791,color:#fff\n style REDIS fill:#DC382D,color:#fff\n style VUE fill:#4FC08D,color:#fff\n style APPRISE fill:#9C27B0,color:#fff\n```\n\n---\n\n## 📦 Container Overview\n\nThe system runs as 8 Docker containers:\n\n| Container | Image | Purpose |\n|-----------|-------|---------|\n| `timelapse_postgres` | `postgres:16-alpine` | PostgreSQL database for all persistent data |\n| `timelapse_redis` | `redis:7-alpine` | Redis cache for session data and rate limiting |\n| `timelapse_api` | `rjsears/unifi-timelapse-api` | FastAPI REST API for all operations |\n| `timelapse_worker` | `rjsears/unifi-timelapse-worker` | APScheduler worker for capture and FFMPEG |\n| `timelapse_health` | `rjsears/unifi-timelapse-health` | Dedicated health monitoring service |\n| `timelapse_frontend` | `rjsears/unifi-timelapse-frontend` | Vue.js web interface |\n| `timelapse_apprise` | `caronc/apprise` | Notification service |\n| `timelapse_nginx` | `nginx:alpine` | Reverse proxy and static file serving |\n\n---\n\n## 📋 Requirements\n\n| Requirement | Version | Notes |\n|-------------|---------|-------|\n| **Docker** | 20.10+ | With Docker Compose v2 |\n| **Memory** | 16GB+ | 4K timelapse encoding uses ~12GB RAM |\n| **CPU** | 8+ cores | 4K encoding uses 10+ threads; 16+ cores recommended |\n| **Camera Access** | — | HTTP endpoint serving JPEG images |\n| **Storage** | — | ~50MB/camera/day for images at 30s intervals |\n\n### Camera Requirements\n\nCameras must be accessible via HTTP and return JPEG images. Examples:\n\n```bash\n# UniFi Protect cameras (via snapshot URL)\nhttp://camera-ip/snap.jpeg\n\n# Generic IP cameras\nhttp://camera-ip/cgi-bin/snapshot.cgi\n\n# RTSP cameras with snapshot endpoint\nhttp://camera-ip/snapshot.jpg\n```\n\n---\n\n## 🚀 Quick Start\n\n### Step 1: Clone the Repository\n\n```bash\ngit clone https://github.com/rjsears/unifi_timelapse.git\ncd unifi_timelapse\n```\n\n### Step 2: Configure Environment\n\n```bash\n# Copy the example environment file\ncp .env.example .env\n\n# Edit with your settings\nnano .env\n```\n\n**Required settings to change:**\n\n```bash\n# Security (REQUIRED - generate with: openssl rand -hex 32)\nPOSTGRES_PASSWORD=your_secure_database_password\nSECRET_KEY=your_32_character_secret_key\nADMIN_PASSWORD=your_admin_login_password\n\n# Timezone\nTZ=America/Los_Angeles\n```\n\n### Step 3: Start the Stack\n\n```bash\n# Pull and start all containers\ndocker compose up -d\n\n# Watch the logs\ndocker compose logs -f\n```\n\n### Step 4: Access the Web Interface\n\nOpen your browser to `http://localhost` (or your server IP).\n\nLogin with:\n- **Username:** `admin` (or your `ADMIN_USERNAME`)\n- **Password:** Your `ADMIN_PASSWORD`\n\n### Step 5: Add Your First Camera\n\n1. Go to **Cameras** in the web interface\n2. Click **Add Camera**\n3. Enter:\n - **Name:** `front-door`\n - **URL:** `http://192.168.1.100/snap.jpeg`\n - **Capture Interval:** `30` seconds\n4. Click **Save**\n\nThe worker will begin capturing images immediately.\n\n---\n\n## ⚙️ Configuration\n\n### Environment Variables\n\nAll configuration is done via environment variables in `.env`:\n\n#### Database & Security\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `POSTGRES_USER` | `timelapse` | Database username |\n| `POSTGRES_PASSWORD` | — | **Required.** Database password |\n| `POSTGRES_DB` | `timelapse` | Database name |\n| `SECRET_KEY` | — | **Required.** JWT signing key (32+ chars) |\n| `ADMIN_USERNAME` | `admin` | Initial admin username |\n| `ADMIN_PASSWORD` | — | **Required.** Initial admin password |\n\n#### Capture Settings\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `DEFAULT_CAPTURE_INTERVAL` | `30` | Seconds between captures |\n| `MAX_CONCURRENT_CAPTURES` | `50` | Maximum parallel camera captures |\n| `CAPTURE_TIMEOUT` | `30` | HTTP request timeout in seconds |\n| `CAPTURE_RETRIES` | `3` | Retry attempts on failure |\n\n#### Camera Blackout Periods\n\nBlackout periods allow you to skip image captures during specific hours (e.g., nighttime when there's no activity). Configure per-camera via the web interface or API:\n\n```bash\ncurl -X PUT http://localhost/api/cameras/{id} \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"blackout_start\": \"22:00\",\n \"blackout_end\": \"06:00\"\n }'\n```\n\n**Features:**\n- **Overnight Spans** — Supports periods that cross midnight (e.g., 22:00 to 06:00)\n- **Per-Camera** — Each camera can have its own blackout schedule\n- **Optional** — Leave both times empty to capture 24/7\n- **Timezone Aware** — Uses the system's configured timezone\n\n**Use cases:**\n- Skip nighttime captures when there's no activity\n- Avoid capturing during maintenance windows\n- Reduce storage for cameras monitoring daytime-only activities\n\n---\n\n#### Timelapse Settings\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `DEFAULT_FRAME_RATE` | `30` | Output video FPS |\n| `DEFAULT_CRF` | `20` | Quality (0-51, lower = better) |\n| `DEFAULT_PIXEL_FORMAT` | `yuv444p` | Pixel format (yuv420p, yuv444p, rgb24) |\n| `FFMPEG_TIMEOUT` | `14400` | Max encoding time in seconds (4 hours) |\n| `DAILY_TIMELAPSE_TIME` | `01:00` | When to generate daily timelapses |\n\n#### Multi-Day Timelapse Settings\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `MULTIDAY_IMAGES_PER_HOUR` | `2` | Images to select per hour |\n| `MULTIDAY_DAYS_TO_INCLUDE` | `7` | Days to include in summary |\n| `MULTIDAY_GENERATION_DAY` | `sunday` | Day of week to generate |\n| `MULTIDAY_GENERATION_TIME` | `02:00` | Time to generate |\n\n#### Cleanup Settings\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `RETENTION_DAYS_IMAGES` | `7` | Days to keep images |\n| `RETENTION_DAYS_VIDEOS` | `365` | Days to keep videos |\n| `CLEANUP_TIME` | `03:00` | When to run cleanup |\n\n#### Health Monitor Settings\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `HEALTH_CHECK_INTERVAL` | `60` | Seconds between connectivity checks |\n| `BLANK_CHECK_INTERVAL` | `300` | Seconds between blank image checks |\n| `FROZEN_CHECK_INTERVAL` | `300` | Seconds between frozen image checks |\n| `BLANK_THRESHOLD` | `0.02` | Pixel variance threshold for blank detection |\n\n#### Notification Settings\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `APPRISE_ENABLED` | `false` | Enable notifications |\n| `APPRISE_DEFAULT_URLS` | — | Comma-separated Apprise URLs |\n| `MIN_FAILURES_BEFORE_ALERT` | `3` | Consecutive failures before alerting |\n| `ALERT_COOLDOWN_MINUTES` | `30` | Minutes between repeat alerts |\n\n---\n\n## 🖥 Web Interface\n\nThe Vue.js dashboard provides complete system management with a modern, responsive design featuring dark and light mode support.\n\n### Theme Support\n\n- **Dark/Light Mode Toggle** — Switch between dark and light themes with a single click\n- **System Preference Detection** — Automatically follows your OS theme preference\n- **Persistent Selection** — Theme choice saved to local storage\n\n### Navigation\n\n- **Top Navigation Bar** — Horizontal navigation with quick access to all sections\n- **User Menu** — Profile dropdown with password change and logout options\n- **System Status Indicator** — Real-time health status in the header\n- **About Dialog** — Version information, author details, and GitHub link\n\n### Dashboard\n\n- Real-time capture statistics with colored stat cards\n- Camera health overview with status indicators\n- Recent timelapses with status badges\n- Storage usage indicator with warning colors\n\n### Cameras\n\n- Add/edit/delete cameras with modal forms\n- Configure per-camera capture intervals\n- **Blackout Period Configuration** — Set start/end times to skip captures (supports overnight spans)\n- Test camera connectivity with one click\n- Trigger manual captures\n- View capture history and last capture time\n\n### Timelapses\n\nThree-tab interface for complete timelapse management:\n\n#### Videos Tab\n- Browse daily and multi-day timelapses\n- In-browser video player with download option\n- Filter by camera, status, and type\n- View encoding details (frame count, duration)\n\n#### Scheduled Configs Tab\n- Create and manage multi-day timelapse configurations\n- **Historical Mode** — Look back and generate from past images on a schedule\n- **Prospective Mode** — Collect images going forward, then generate when complete\n- Progress indicator for active prospective collections\n- Start/cancel collection controls\n- Trigger manual generation\n\n#### Custom Timelapse Tab\n- Generate one-off timelapses from existing images\n- Camera selection with available date range display\n- Date range picker showing image availability\n- Configurable video settings (images per hour, frame rate, CRF, pixel format)\n- Estimated output preview (frame count and duration)\n\n### Images\n\n- Gallery view of captured images with thumbnails\n- Filter by camera and date\n- Toggle protection status (protected images survive cleanup)\n- Image viewer with navigation between images\n- Download and delete options\n\n### Health\n\nCollapsible card interface for organized health monitoring:\n\n- **Camera Status** — Connectivity status, uptime percentage, response times\n- **Health History (24h)** — Timeline visualization of camera health\n- **Recent Alerts** — Camera warnings and errors with timestamps\n\n### Settings\n\nCollapsible card interface organized by category:\n\n- **Capture Settings** — Default intervals, concurrent captures, timeouts\n- **Timelapse Settings** — Frame rate, CRF quality, pixel format, generation time\n- **Retention Settings** — Image and video retention days, cleanup time\n- **Notification Channels** — Add/test/delete Apprise notification channels\n- **System Information** — Version, status, database, uptime\n- **Storage** — Visual usage bar with percentage\n- **Scheduled Tasks** — View background job schedules\n\n---\n\n## 📡 API Reference\n\nFull OpenAPI documentation available at `/api/docs` when running.\n\n### Key Endpoints\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| `POST` | `/api/auth/login` | Authenticate and get JWT token |\n| `GET` | `/api/cameras` | List all cameras |\n| `POST` | `/api/cameras` | Add a new camera |\n| `GET` | `/api/cameras/{id}` | Get camera details |\n| `PUT` | `/api/cameras/{id}` | Update camera |\n| `DELETE` | `/api/cameras/{id}` | Delete camera |\n| `GET` | `/api/cameras/{id}/images` | List camera images |\n| `POST` | `/api/cameras/{id}/capture` | Trigger manual capture |\n| `POST` | `/api/cameras/{id}/timelapse` | Trigger manual timelapse |\n| `GET` | `/api/timelapses` | List all timelapses |\n| `GET` | `/api/timelapses/{id}` | Get timelapse details |\n| `GET` | `/api/health/cameras` | Camera health status |\n| `GET` | `/api/health/system` | System health check |\n| `GET` | `/api/settings` | Get system settings |\n| `PUT` | `/api/settings` | Update system settings |\n| `GET` | `/api/images/camera/{id}/available-dates` | Get available image dates for a camera |\n| `GET` | `/api/multiday` | List multi-day timelapse configs |\n| `POST` | `/api/multiday` | Create multi-day config |\n| `POST` | `/api/multiday/generate-historical` | Generate one-off timelapse from date range |\n| `POST` | `/api/multiday/{id}/start-collection` | Start prospective collection |\n| `GET` | `/api/multiday/{id}/progress` | Get collection progress |\n| `POST` | `/api/multiday/{id}/cancel-collection` | Cancel prospective collection |\n\n### Authentication\n\nAll endpoints except `/api/auth/login` and `/api/health/system` require JWT authentication:\n\n```bash\n# Login\nTOKEN=$(curl -s -X POST http://localhost/api/auth/login \\\n -H \"Content-Type: application/json\" \\\n -d '{\"username\":\"admin\",\"password\":\"yourpassword\"}' | jq -r '.access_token')\n\n# Use token\ncurl -H \"Authorization: Bearer $TOKEN\" http://localhost/api/cameras\n```\n\n---\n\n## 📁 Directory Structure\n\nOutput files are organized as:\n\n```\n/output/\n├── images/\n│ └── {camera_name}/\n│ └── {YYYYMMDD}/\n│ ├── {YYYYMMDDHHMMSS}_{camera_name}.jpeg\n│ ├── {YYYYMMDDHHMMSS}_{camera_name}.jpeg\n│ └── ...\n└── videos/\n └── {camera_name}/\n ├── daily/\n │ ├── {YYYYMMDD}.mp4\n │ └── ...\n └── summary/\n ├── {YYYYMMDD}-{YYYYMMDD}_summary.mp4\n └── ...\n```\n\n### Storage Estimates\n\n| Interval | Images/Day | Size/Day (per camera) |\n|----------|------------|----------------------|\n| 30 sec | 2,880 | ~150 MB |\n| 60 sec | 1,440 | ~75 MB |\n| 120 sec | 720 | ~40 MB |\n\n---\n\n## 📅 Multi-Day Timelapses\n\nMulti-day timelapses create summary videos spanning multiple days—perfect for weekly progress videos or long-term project documentation.\n\n### Generation Modes\n\nThe system supports two distinct modes for multi-day timelapses:\n\n#### Historical Mode (Look Back)\n\nHistorical mode generates timelapses from images that already exist. This is the traditional approach:\n\n1. Configure a schedule (e.g., every Sunday at 2 AM)\n2. When triggered, the system looks back X days from yesterday\n3. Selects images at the configured rate (e.g., 2 per hour)\n4. Generates the timelapse immediately\n\n**Use case:** Weekly summary videos from the past 7 days of captures.\n\n**Limitation:** If your image retention is 7 days, you can't build a 30-day timelapse because older images are deleted.\n\n#### Prospective Mode (Collect Forward)\n\nProspective mode solves the retention limitation by protecting images as they're captured:\n\n1. Create a prospective config (e.g., \"Collect for 30 days\")\n2. Start the collection from the web interface\n3. As images are captured, matching ones are marked as protected\n4. Progress shows \"Day 12 of 30\" in the configs list\n5. When collection completes, the timelapse generates automatically (if enabled)\n\n**Use case:** Long-term construction timelapses, seasonal changes, or any period longer than your retention window.\n\n**Benefit:** Protected images survive automatic cleanup, so you can build 30, 60, or 90-day timelapses even with 7-day retention.\n\n### Custom Timelapse (One-Off Generation)\n\nFor ad-hoc timelapse generation, use the **Custom Timelapse** tab:\n\n1. Select a camera\n2. View available date range and image counts\n3. Pick start and end dates\n4. Configure video settings (images per hour, frame rate, CRF, pixel format)\n5. See estimated output (frame count and duration)\n6. Click Generate\n\nThis creates a one-time timelapse without creating a recurring schedule.\n\n### How Image Selection Works\n\n1. **Image Selection** — Selects `images_per_hour` images evenly distributed across each hour\n2. **Protection** — Selected images are marked as `is_protected = true` to prevent cleanup\n3. **Encoding** — FFMPEG generates the summary video using configured quality settings\n4. **Storage** — Videos saved to `videos/{camera}/summary/`\n\n### Configuration\n\nIn `.env` (defaults for new configs):\n\n```bash\n# Select 2 images per hour\nMULTIDAY_IMAGES_PER_HOUR=2\n\n# Include 7 days of footage\nMULTIDAY_DAYS_TO_INCLUDE=7\n\n# Generate every Sunday at 2 AM\nMULTIDAY_GENERATION_DAY=sunday\nMULTIDAY_GENERATION_TIME=02:00\n```\n\n### Per-Camera Configuration\n\nEach camera can have multiple multi-day configurations via the web interface or API:\n\n```bash\n# Create a historical config (weekly summary)\ncurl -X POST http://localhost/api/multiday \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"camera_id\": \"uuid-here\",\n \"name\": \"Weekly Summary\",\n \"mode\": \"historical\",\n \"is_enabled\": true,\n \"days_to_include\": 7,\n \"images_per_hour\": 2,\n \"generation_day\": \"sunday\",\n \"generation_time\": \"02:00\",\n \"frame_rate\": 30,\n \"crf\": 20,\n \"pixel_format\": \"yuv444p\"\n }'\n\n# Create a prospective config (30-day collection)\ncurl -X POST http://localhost/api/multiday \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"camera_id\": \"uuid-here\",\n \"name\": \"Monthly Progress\",\n \"mode\": \"prospective\",\n \"is_enabled\": true,\n \"days_to_include\": 30,\n \"images_per_hour\": 2,\n \"auto_generate\": true,\n \"frame_rate\": 30,\n \"crf\": 20,\n \"pixel_format\": \"yuv444p\"\n }'\n\n# Start prospective collection\ncurl -X POST http://localhost/api/multiday/{config_id}/start-collection \\\n -H \"Authorization: Bearer $TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"days\": 30}'\n\n# Check collection progress\ncurl http://localhost/api/multiday/{config_id}/progress \\\n -H \"Authorization: Bearer $TOKEN\"\n\n# Generate custom timelapse from existing images\ncurl -","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":19,"_79":11,"_80":11},"read","write","admin","user","storage_size",7106339339,"orgData","recentTags",[87,132],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":120,"_121":90,"_122":29,"_123":52,"_53":124,"_125":126,"_127":128,"_129":120,"_130":62,"_131":19},"content_type","creator",8638307,"digest","sha256:54f4e6a1de01262cb8809fe56afa55da8389aabc5ac03274a36a237ea9617e77","full_size",166801184,"id",1068580290,"images",[99,114],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},"architecture","amd64","sha256:c77730506e2dce76e067e2a1b06e95bc1a7a6dc434a20d635fa8fd29d26ac5ef","features","last_pulled","2026-07-16T02:19:22.271159218Z","last_pushed","2026-02-28T01:09:06.398122048Z","os","linux","os_features","os_version","size","variant",{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":115,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},"unknown","sha256:dce9abfdc749f025b7494e2a50b2f0d33045ccd917d0d3369226950bd91f5ff1","2026-07-16T02:19:22.270936646Z","2026-02-28T01:09:06.905340898Z",43758,"2026-02-28T01:09:09.136984Z","last_updater","last_updater_username","media_type","latest","repository",30020162,"tag_last_pulled","2026-07-21T19:30:54.630827098Z","tag_last_pushed","tag_status","v2",{"_88":40,"_89":90,"_91":92,"_93":94,"_95":133,"_97":134,"_46":137,"_121":90,"_122":29,"_123":52,"_53":138,"_125":126,"_127":128,"_129":137,"_130":62,"_131":19},1068580266,[135,136],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":115,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},"2026-02-28T01:09:07.454707Z","main","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":148,"_155":156,"_144":171,"_172":11},{"_36":149,"_38":150,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":151,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":152,"_75":11,"_76":154,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":153},[74],{"_78":19,"_79":11,"_80":11},"tags",{"_157":158,"_159":-5,"_160":-5,"_161":162},"count",2,"next","previous","results",[163,167],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":164,"_46":120,"_121":90,"_122":29,"_123":52,"_53":124,"_125":126,"_127":128,"_129":120,"_130":62,"_131":19},[165,166],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":115,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},{"_88":40,"_89":90,"_91":92,"_93":94,"_95":133,"_97":168,"_46":137,"_121":90,"_122":29,"_123":52,"_53":138,"_125":126,"_127":128,"_129":137,"_130":62,"_131":19},[169,170],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":115,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

rjsears/unifi-timelapse-api

Tags for rjsears/unifi-timelapse-api