mrsleeps/frigate-timelapser

Frigate Timelapser

镜像概述

这是一个Node.js应用，用于从Frigate NVR的监控feed生成延时视频。它解决了Frigate自带延时功能不够便捷可靠的问题，支持与Home Assistant集成，可根据触发条件自动生成视频并发送至***等平台，已稳定运行一年。

核心功能

1. 定期从Frigate监控feed抓拍快照
2. 生成指定时间段（默认15秒）的延时视频
3. 支持通过API手动/自动触发视频生成
4. 与Home Assistant集成，通过webhook接收触发信号并返回视频链接
5. 可配置快照和视频的保留天数（默认各1天）

使用场景

• 家庭监控自动化：当门/窗传感器触发时，自动生成延时视频并发送至***
• 手动查看：通过浏览器访问API生成并查看特定摄像头的延时视频
• 个性化场景：结合Home Assistant规则，实现自定义触发条件的延时视频生成

配置说明

本地运行

1. 克隆仓库：

plaintext
git clone https://github.com/MrSleeps/FrigateTimelapser.git
cd FrigateTimelapser

2. 安装依赖：npm install
3. 编辑frigate.env文件配置参数
4. 启动应用：npm start或node server.js

Docker部署

1. 拉取镜像或自行构建：

plaintext
docker pull docker.xuanyuan.run/mrsleeps/frigate-timelapser

2. 创建docker-compose.yml：

yaml
version: '3.6'
services:
  timelapser:
    image: docker.xuanyuan.run/mrsleeps/frigate-timelapser
    container_name: frigate-timelapser
    volumes:
      - ${PWD}/files:/app/files
      - ${PWD}/timelapse.env:/app/.env
    ports:
      - 8500:8500
    restart: unless-stopped

3. 创建timelapse.env文件：

plaintext
timelapseURL = "http://your.host"
timelapsePort = "8500"

4. 启动容器：docker-compose up -d

生成延时视频API

通过GET请求调用：http://your.host:8500/:camera/timelapse/:hass/:json

• :camera：摄像头名称（如frontdoor）
• :hass：是否从Home Assistant触发（1=是，0=否）
• :json：是否返回JSON结果（1=是，0=否）

示例：

• 手动查看frontdoor摄像头延时：http://your.host:8500/frontdoor/timelapse/0/0
• 从Home Assistant触发并返回视频链接：http://your.host:8500/frontdoor/timelapse/1/0

Home Assistant集成

1. 配置REST命令（configuration.yaml）：

yaml
rest_command:
  get_frontdoor_timelapse:
    url: "https://your.timelapse.host/frontdoor/timelapse/1/0"
    method: get

2. 创建生成视频的脚本：

yaml
alias: 生成延时视频
sequence:
  - service: rest_command.get_frontdoor_timelapse
    data: {}
  - delay: 5 seconds
mode: single
icon: mdi:camera

3. 设置自动化触发（如门打开时）：

yaml
alias: 门打开时发送延时视频
trigger:
  - type: opened
    entity_id: binary_sensor.front_door_contact
condition: []
action:
  - service: script.生成延时视频
    data: {}
mode: single

4. 配置***发送视频：

yaml
alias: 发送延时视频到***
trigger:
  - platform: webhook
    webhook_id: "your_webhook_id"
action:
  - service: ***_bot.send_video
    data_template:
      url: "{{trigger.json.video}}"
mode: parallel