homesec 1.2.1__tar.gz → 1.2.2__tar.gz

{homesec-1.2.1 → homesec-1.2.2}/CHANGELOG.md

@@ -2,6 +2,112 @@
 
 <!-- version list -->
 
+## v1.2.2 (2026-01-27)
+
+### Bug Fixes
+
+- Align recording sensitivity constraints ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Defer rtsp detect fallback while recording ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Harden rtsp recording retries ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Honor exact rtsp reconnect attempts ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Improve rtsp reconnect and fallback ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Make recording motion threshold more sensitive ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+### Chores
+
+- Remove rtsp improvements plan from repo ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+### Documentation
+
+- Add homesec db logs skill ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+### Refactoring
+
+- Centralize rtsp recording state ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Export rtsp public api ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Extract rtsp motion detector ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Make rtsp pipeline lifecycle explicit ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Reorganize source configs ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Restrict rtsp package exports ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Simplify rtsp run loop ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Simplify rtsp run loop and probes ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Split rtsp into package modules ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Tighten rtsp detect fallback and backoff ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+### Testing
+
+- Add rtsp reconnect deferral coverage ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Add rtsp stall and detect recovery coverage ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Cover detect switch fallback ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Cover ffmpeg timeout fallback ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Cover ffprobe error handling ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Cover ffprobe timeout fallback ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Cover recording start backoff ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Cover rtsp frame pipeline edge cases ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Cover rtsp recording timers ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Expand rtsp config coverage ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Expand rtsp coverage and regroup tests ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Harden rtsp config paths ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+- Harden rtsp hardware detection ([#16](https://github.com/lan17/homesec/pull/16),
+  [`8ac42d2`](https://github.com/lan17/homesec/commit/8ac42d2e828cf2c5e9f7c0cc5da32b677ddbbd54))
+
+
 ## v1.2.1 (2026-01-19)
 
 ### Bug Fixes

{homesec-1.2.1 → homesec-1.2.2}/DESIGN.md

@@ -136,7 +136,14 @@ Build a reliable, pluggable pipeline to:
 
 ## Current Building Blocks (Repo)
 
-- Motion + recording: `src/homesec/sources/rtsp.py` (OpenCV motion detection + ffmpeg recording).
+- Motion + recording: `src/homesec/sources/rtsp/core.py` (OpenCV motion detection + ffmpeg recording).
+  - RTSP helpers live in `src/homesec/sources/rtsp/`:
+    - `frame_pipeline.py` (ffmpeg frame reader + stall/reconnect support)
+    - `recorder.py` (ffmpeg recording process)
+    - `motion.py` (motion detection logic)
+    - `hardware.py` (hwaccel detection)
+    - `clock.py` (clock abstraction for tests)
+    - `utils.py` (shared helpers)
 - Object detection plugin (reference): `src/homesec/plugins/filters/yolo.py` (YOLOv8 sampling to detect people/animals).
 - VLM plugin (reference): `src/homesec/plugins/analyzers/openai.py` (structured output with `risk_level`, `activity_type`, timeline).
 - Postgres (workflow state when available): Alembic migrations (`alembic/`) + telemetry logging (`src/db_log_handler.py`) + workflow state table `clip_states` (best-effort; DB outages may drop state updates).

{homesec-1.2.1 → homesec-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homesec
-Version: 1.2.1
+Version: 1.2.2
 Summary: Pluggable async home security camera pipeline with detection, VLM analysis, and alerts.
 Project-URL: Homepage, https://github.com/lan17/homesec
 Project-URL: Source, https://github.com/lan17/homesec
@@ -404,9 +404,11 @@ cameras:
       config:
         rtsp_url_env: DRIVEWAY_RTSP_URL
         output_dir: "./recordings"
-        # Critical for camera compatibility:
-        ffmpeg_flags: ["-rtsp_transport", "tcp", "-vsync", "0"]
-        reconnect_backoff_s: 5
+        stream:
+          # Critical for camera compatibility:
+          ffmpeg_flags: ["-rtsp_transport", "tcp", "-vsync", "0"]
+        reconnect:
+          backoff_s: 5
 
 filter:
   plugin: yolo
@@ -488,7 +490,7 @@ HomeSec uses a plugin architecture where every component is discovered at runtim
 
 | Type | Plugins |
 |------|---------|
-| Sources | [`rtsp`](src/homesec/sources/rtsp.py), [`ftp`](src/homesec/sources/ftp.py), [`local_folder`](src/homesec/sources/local_folder.py) |
+| Sources | [`rtsp`](src/homesec/sources/rtsp/core.py), [`ftp`](src/homesec/sources/ftp.py), [`local_folder`](src/homesec/sources/local_folder.py) |
 | Filters | [`yolo`](src/homesec/plugins/filters/yolo.py) |
 | Storage | [`dropbox`](src/homesec/plugins/storage/dropbox.py), [`local`](src/homesec/plugins/storage/local.py) |
 | VLM analyzers | [`openai`](src/homesec/plugins/analyzers/openai.py) |

{homesec-1.2.1 → homesec-1.2.2}/README.md

@@ -161,9 +161,11 @@ cameras:
       config:
         rtsp_url_env: DRIVEWAY_RTSP_URL
         output_dir: "./recordings"
-        # Critical for camera compatibility:
-        ffmpeg_flags: ["-rtsp_transport", "tcp", "-vsync", "0"]
-        reconnect_backoff_s: 5
+        stream:
+          # Critical for camera compatibility:
+          ffmpeg_flags: ["-rtsp_transport", "tcp", "-vsync", "0"]
+        reconnect:
+          backoff_s: 5
 
 filter:
   plugin: yolo
@@ -245,7 +247,7 @@ HomeSec uses a plugin architecture where every component is discovered at runtim
 
 | Type | Plugins |
 |------|---------|
-| Sources | [`rtsp`](src/homesec/sources/rtsp.py), [`ftp`](src/homesec/sources/ftp.py), [`local_folder`](src/homesec/sources/local_folder.py) |
+| Sources | [`rtsp`](src/homesec/sources/rtsp/core.py), [`ftp`](src/homesec/sources/ftp.py), [`local_folder`](src/homesec/sources/local_folder.py) |
 | Filters | [`yolo`](src/homesec/plugins/filters/yolo.py) |
 | Storage | [`dropbox`](src/homesec/plugins/storage/dropbox.py), [`local`](src/homesec/plugins/storage/local.py) |
 | VLM analyzers | [`openai`](src/homesec/plugins/analyzers/openai.py) |

{homesec-1.2.1 → homesec-1.2.2}/config/example.yaml

@@ -24,17 +24,30 @@ cameras:
         rtsp_url_env: FRONT_DOOR_RTSP_URL
         # Optional: separate low-res stream for motion detection
         # detect_rtsp_url_env: FRONT_DOOR_RTSP_SUB_URL
-        # Customize ffmpeg behavior (e.g., for flaky TCP streams)
-        ffmpeg_flags: ["-rtsp_transport", "tcp", "-vsync", "0"]
         output_dir: "./recordings"
-        # Motion detection settings
-        pixel_threshold: 45        # Pixel difference threshold (0-255)
-        min_changed_pct: 1.0       # Min % of frame that must change
-        blur_kernel: 5             # Blur kernel size (reduces noise)
-        stop_delay: 10             # Seconds of no motion before stopping
-        max_recording_s: 60        # Max clip length
-        frame_timeout_s: 2.0       # Timeout waiting for frames
-        reconnect_backoff_s: 1.0   # Backoff between reconnects
+        stream:
+          # Customize ffmpeg behavior (e.g., for flaky TCP streams)
+          ffmpeg_flags: ["-rtsp_transport", "tcp", "-vsync", "0"]
+          connect_timeout_s: 2.0  # RTSP connect timeout (seconds)
+          io_timeout_s: 2.0       # RTSP I/O timeout (seconds)
+          disable_hwaccel: false
+        motion:
+          pixel_threshold: 45        # Pixel difference threshold (0-255)
+          min_changed_pct: 1.0       # Min % of frame that must change (idle)
+          recording_sensitivity_factor: 2.0  # Recording keepalive sensitivity (>=1.0)
+          blur_kernel: 5             # Blur kernel size (reduces noise)
+        recording:
+          stop_delay: 10             # Seconds of no motion before stopping
+          max_recording_s: 60        # Max clip length before rotation
+        runtime:
+          frame_timeout_s: 2.0       # Timeout waiting for frames
+          frame_queue_size: 20       # Frame queue size
+          heartbeat_s: 30.0          # Heartbeat log interval
+          debug_motion: false
+        reconnect:
+          backoff_s: 1.0             # Backoff between reconnects
+          max_attempts: 0            # 0 = retry forever
+          detect_fallback_attempts: 3  # Switch detect stream to main after N failures
 
   # FTP server (receive uploads from cameras that support FTP)
   - name: ftp_camera

{homesec-1.2.1 → homesec-1.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "homesec"
-version = "1.2.1"
+version = "1.2.2"
 description = "Pluggable async home security camera pipeline with detection, VLM analysis, and alerts."
 readme = "README.md"
 authors = [

homesec-1.2.2/skills/local/homesec-db-logs/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: homesec-db-logs
+description: Query the HomeSec Postgres logs table to inspect recent runtime issues, counts by level/logger, and recurring error messages. Use when asked to check database logs in the telemetry DB, scan the last N hours for errors, or summarize log patterns. Enforce read-only access (SELECT only) and redact secrets.
+---
+
+# HomeSec DB Log Queries
+
+## Quick Start
+
+1. Confirm the DSN and time window; use SELECT-only queries.
+2. Confirm the logs table schema (from SQLAlchemy models) and time window.
+3. Pull counts by level/logger, then top error/warn messages.
+4. Inspect a few recent payloads to confirm fields.
+5. Summarize findings; avoid dumping large payloads or secrets.
+
+## Canonical Queries
+
+Use psql with `-Atc` for clean output. Replace the DSN as needed.
+
+- List tables:
+
+```bash
+psql "$DSN" -Atc "SELECT table_name FROM information_schema.tables WHERE table_schema='public' ORDER BY table_name;"
+```
+
+- Inspect columns:
+
+```bash
+psql "$DSN" -Atc "SELECT column_name, data_type FROM information_schema.columns WHERE table_schema='public' AND table_name='logs' ORDER BY ordinal_position;"
+```
+
+- Severity counts (logs table with JSON payload):
+
+```bash
+psql "$DSN" -Atc "SELECT payload->>'level' AS level, count(*) FROM logs WHERE ts >= now() - interval '12 hours' GROUP BY level ORDER BY count DESC;"
+```
+
+- Top error messages (logs table):
+
+```bash
+psql "$DSN" -Atc "SELECT payload->>'message' AS message, count(*) FROM logs WHERE ts >= now() - interval '12 hours' AND payload->>'level'='ERROR' GROUP BY message ORDER BY count DESC LIMIT 10;"
+```
+
+- Top warn/error by logger (logs table):
+
+```bash
+psql "$DSN" -Atc "SELECT payload->>'logger' AS logger, count(*) FROM logs WHERE ts >= now() - interval '12 hours' AND payload->>'level' IN ('ERROR','WARNING') GROUP BY logger ORDER BY count DESC;"
+```
+
+- Recent samples (logs table):
+
+```bash
+psql "$DSN" -Atc "SELECT payload FROM logs WHERE ts >= now() - interval '12 hours' ORDER BY ts DESC LIMIT 3;"
+```
+
+## Table Structure Notes
+
+- `logs`: generic JSONB log sink (defined in `src/homesec/telemetry/db/log_table.py`).
+  - Columns: `id` (bigint), `ts` (timestamptz), `payload` (jsonb).
+  - Common payload keys: `ts`, `kind`, `level`, `message`, `fields`, `logger`, `module`, `pathname`, `event_type`, `camera_name`, `recording_id`.
+  - Typical filters use JSONB: `payload->>'level'`, `payload->>'logger'`, `payload->>'message'`.
+
+## Guardrails
+
+- Use SELECT statements only. Never run INSERT/UPDATE/DELETE/DDL.
+- If output contains secrets (RTSP URLs with credentials, tokens), redact before reporting.
+- Keep results compact: aggregate counts first, then sample rows with LIMIT.
+- State the time window explicitly (use absolute dates when summarizing).
+
+## Interpretation Tips
+
+- For repeated ffmpeg/ffprobe errors, check for missing flags or unsupported options.
+- If warnings/errors cluster around a single logger, focus analysis there before expanding scope.

{homesec-1.2.1 → homesec-1.2.2}/src/homesec/models/__init__.py

@@ -25,7 +25,9 @@ from homesec.models.config import (
 )
 from homesec.models.enums import RiskLevel, RiskLevelField
 from homesec.models.filter import FilterConfig, FilterOverrides, FilterResult, YoloFilterSettings
-from homesec.models.source import FtpSourceConfig, LocalFolderSourceConfig, RTSPSourceConfig
+from homesec.models.source.ftp import FtpSourceConfig
+from homesec.models.source.local_folder import LocalFolderSourceConfig
+from homesec.models.source.rtsp import RTSPSourceConfig
 from homesec.models.vlm import (
     AnalysisResult,
     EntityTimeline,

{homesec-1.2.1 → homesec-1.2.2}/src/homesec/models/config.py

@@ -8,7 +8,9 @@ from pydantic import BaseModel, Field, field_validator, model_validator
 
 from homesec.models.enums import RiskLevel, RiskLevelField
 from homesec.models.filter import FilterConfig
-from homesec.models.source import FtpSourceConfig, LocalFolderSourceConfig, RTSPSourceConfig
+from homesec.models.source.ftp import FtpSourceConfig
+from homesec.models.source.local_folder import LocalFolderSourceConfig
+from homesec.models.source.rtsp import RTSPSourceConfig
 from homesec.models.vlm import VLMConfig
 
 

homesec-1.2.2/src/homesec/models/source/__init__.py

@@ -0,0 +1,3 @@
+"""Source configuration models."""
+
+__all__: list[str] = []

homesec-1.2.2/src/homesec/models/source/ftp.py

@@ -0,0 +1,97 @@
+"""FTP source configuration model."""
+
+from __future__ import annotations
+
+from pydantic import BaseModel, Field, field_validator
+
+
+class FtpSourceConfig(BaseModel):
+    """FTP source configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    camera_name: str | None = Field(
+        default=None,
+        description="Optional human-friendly camera name.",
+    )
+    host: str = Field(
+        default="0.0.0.0",
+        description="FTP bind address.",
+    )
+    port: int = Field(
+        default=2121,
+        ge=0,
+        le=65535,
+        description="FTP listen port (0 lets the OS choose an ephemeral port).",
+    )
+    root_dir: str = Field(
+        default="./ftp_incoming",
+        description="FTP root directory for uploads.",
+    )
+    ftp_subdir: str | None = Field(
+        default=None,
+        description="Optional subdirectory under root_dir.",
+    )
+    anonymous: bool = Field(
+        default=True,
+        description="Allow anonymous FTP uploads.",
+    )
+    username_env: str | None = Field(
+        default=None,
+        description="Environment variable containing FTP username.",
+    )
+    password_env: str | None = Field(
+        default=None,
+        description="Environment variable containing FTP password.",
+    )
+    perms: str = Field(
+        default="elw",
+        description="pyftpdlib permissions string.",
+    )
+    passive_ports: str | None = Field(
+        default=None,
+        description="Passive ports range (e.g., '60000-60100' or '60000,60010').",
+    )
+    masquerade_address: str | None = Field(
+        default=None,
+        description="Optional masquerade address for passive mode.",
+    )
+    heartbeat_s: float = Field(
+        default=30.0,
+        ge=0.0,
+        description="Seconds between FTP health checks.",
+    )
+    allowed_extensions: list[str] = Field(
+        default_factory=lambda: [".mp4"],
+        description="Allowed file extensions for uploaded clips.",
+    )
+    delete_non_matching: bool = Field(
+        default=True,
+        description="Delete files with disallowed extensions.",
+    )
+    delete_incomplete: bool = Field(
+        default=True,
+        description="Delete incomplete uploads when enabled.",
+    )
+    default_duration_s: float = Field(
+        default=10.0,
+        ge=0.0,
+        description="Fallback clip duration when timestamps are missing.",
+    )
+    log_level: str = Field(
+        default="INFO",
+        description="FTP server log level.",
+    )
+
+    @field_validator("allowed_extensions")
+    @classmethod
+    def _normalize_extensions(cls, value: list[str]) -> list[str]:
+        cleaned: list[str] = []
+        for item in value:
+            ext = str(item).strip().lower()
+            if not ext:
+                continue
+            if not ext.startswith("."):
+                ext = f".{ext}"
+            cleaned.append(ext)
+        return cleaned

homesec-1.2.2/src/homesec/models/source/local_folder.py

@@ -0,0 +1,30 @@
+"""Local folder source configuration model."""
+
+from __future__ import annotations
+
+from pydantic import BaseModel, Field
+
+
+class LocalFolderSourceConfig(BaseModel):
+    """Local folder source configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    camera_name: str | None = Field(
+        default=None,
+        description="Optional human-friendly camera name.",
+    )
+    watch_dir: str = Field(
+        default="recordings",
+        description="Directory to watch for new clips.",
+    )
+    poll_interval: float = Field(
+        default=1.0,
+        ge=0.0,
+        description="Polling interval in seconds.",
+    )
+    stability_threshold_s: float = Field(
+        default=3.0,
+        ge=0.0,
+        description="Seconds to wait for file size to stabilize before accepting a clip.",
+    )

homesec-1.2.2/src/homesec/models/source/rtsp.py

@@ -0,0 +1,165 @@
+"""RTSP source configuration models."""
+
+from __future__ import annotations
+
+from pydantic import BaseModel, Field, model_validator
+
+
+class RTSPMotionConfig(BaseModel):
+    """Motion detection configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    pixel_threshold: int = Field(
+        default=45,
+        ge=0,
+        description="Pixel intensity delta required to count a pixel as changed.",
+    )
+    min_changed_pct: float = Field(
+        default=1.0,
+        ge=0.0,
+        description="Percent of pixels that must change to trigger motion (idle state).",
+    )
+    recording_sensitivity_factor: float = Field(
+        default=2.0,
+        ge=1.0,
+        description="Factor to reduce the threshold while recording (>=1.0).",
+    )
+    blur_kernel: int = Field(
+        default=5,
+        ge=0,
+        description="Gaussian blur kernel size (odd or zero; even values are normalized).",
+    )
+
+
+class RTSPRecordingConfig(BaseModel):
+    """Recording lifecycle configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    stop_delay: float = Field(
+        default=10.0,
+        ge=0.0,
+        description="Seconds to keep recording after motion stops.",
+    )
+    max_recording_s: float = Field(
+        default=60.0,
+        gt=0.0,
+        description="Maximum seconds per recording before rotating.",
+    )
+
+
+class RTSPStreamConfig(BaseModel):
+    """RTSP/ffmpeg transport configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    connect_timeout_s: float = Field(
+        default=2.0,
+        ge=0.0,
+        description="RTSP connect timeout (seconds) passed to ffmpeg/ffprobe when supported.",
+    )
+    io_timeout_s: float = Field(
+        default=2.0,
+        ge=0.0,
+        description="RTSP I/O timeout (seconds) passed to ffmpeg/ffprobe when supported.",
+    )
+    ffmpeg_flags: list[str] = Field(
+        default_factory=list,
+        description="Additional ffmpeg flags appended to the command.",
+    )
+    disable_hwaccel: bool = Field(
+        default=False,
+        description="Disable hardware-accelerated decoding.",
+    )
+
+
+class RTSPReconnectConfig(BaseModel):
+    """Reconnect and fallback policy."""
+
+    model_config = {"extra": "forbid"}
+
+    max_attempts: int = Field(
+        default=0,
+        ge=0,
+        description="Max reconnect attempts (0 = retry forever).",
+    )
+    backoff_s: float = Field(
+        default=1.0,
+        ge=0.0,
+        description="Base backoff (seconds) between reconnect attempts.",
+    )
+    detect_fallback_attempts: int = Field(
+        default=3,
+        ge=0,
+        description="Failures before falling back from detect stream to main stream.",
+    )
+
+
+class RTSPRuntimeConfig(BaseModel):
+    """Runtime loop configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    frame_timeout_s: float = Field(
+        default=2.0,
+        ge=0.0,
+        description="Seconds without frames before considering the pipeline stalled.",
+    )
+    frame_queue_size: int = Field(
+        default=20,
+        ge=1,
+        description="Frame queue size used by the frame reader thread.",
+    )
+    heartbeat_s: float = Field(
+        default=30.0,
+        ge=0.0,
+        description="Seconds between heartbeat logs.",
+    )
+    debug_motion: bool = Field(
+        default=False,
+        description="Enable verbose motion detection logging.",
+    )
+
+
+class RTSPSourceConfig(BaseModel):
+    """RTSP source configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    camera_name: str | None = Field(
+        default=None,
+        description="Optional human-friendly camera name.",
+    )
+    rtsp_url_env: str | None = Field(
+        default=None,
+        description="Environment variable containing the RTSP URL.",
+    )
+    rtsp_url: str | None = Field(
+        default=None,
+        description="RTSP URL for the main stream.",
+    )
+    detect_rtsp_url_env: str | None = Field(
+        default=None,
+        description="Environment variable containing the detect stream RTSP URL.",
+    )
+    detect_rtsp_url: str | None = Field(
+        default=None,
+        description="RTSP URL for the detect stream.",
+    )
+    output_dir: str = Field(
+        default="./recordings",
+        description="Directory to store recordings and logs.",
+    )
+
+    motion: RTSPMotionConfig = Field(default_factory=RTSPMotionConfig)
+    recording: RTSPRecordingConfig = Field(default_factory=RTSPRecordingConfig)
+    stream: RTSPStreamConfig = Field(default_factory=RTSPStreamConfig)
+    reconnect: RTSPReconnectConfig = Field(default_factory=RTSPReconnectConfig)
+    runtime: RTSPRuntimeConfig = Field(default_factory=RTSPRuntimeConfig)
+
+    @model_validator(mode="after")
+    def _require_rtsp_url(self) -> RTSPSourceConfig:
+        if not (self.rtsp_url or self.rtsp_url_env):
+            raise ValueError("rtsp_url_env or rtsp_url required for RTSP source")
+        return self

{homesec-1.2.1 → homesec-1.2.2}/src/homesec/plugins/sources/ftp.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from homesec.interfaces import ClipSource
-from homesec.models.source import FtpSourceConfig
+from homesec.models.source.ftp import FtpSourceConfig
 from homesec.plugins.registry import PluginType, plugin
 
 # Import the actual implementation from sources module

{homesec-1.2.1 → homesec-1.2.2}/src/homesec/plugins/sources/local_folder.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from homesec.interfaces import ClipSource
-from homesec.models.source import LocalFolderSourceConfig
+from homesec.models.source.local_folder import LocalFolderSourceConfig
 from homesec.plugins.registry import PluginType, plugin
 from homesec.sources.local_folder import LocalFolderSource as LocalFolderSourceImpl
 

{homesec-1.2.1 → homesec-1.2.2}/src/homesec/plugins/sources/rtsp.py

@@ -5,9 +5,9 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
 
 from homesec.interfaces import ClipSource
-from homesec.models.source import RTSPSourceConfig
+from homesec.models.source.rtsp import RTSPSourceConfig
 from homesec.plugins.registry import PluginType, plugin
-from homesec.sources.rtsp import RTSPSource as RTSPSourceImpl
+from homesec.sources.rtsp.core import RTSPSource as RTSPSourceImpl
 
 if TYPE_CHECKING:
     pass