POC

.canon.yaml

@@ -0,0 +1,9 @@
+fv:
+    image_amd64: ghcr.io/viamrobotics/antique2:amd64-cache
+    image_arm64: ghcr.io/viamrobotics/antique2:arm64-cache
+    image_arm: ghcr.io/viamrobotics/antique2:armhf-cache
+    minimum_date: 2023-10-26T20:00:00.0Z
+    update_interval: 168h0m0s
+    user: testbot
+    group: testbot
+    persistent: true

.github/workflows/lint.yml

@@ -0,0 +1,35 @@
+name: run linter on each commit
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - '**/**.go'
+      - 'Makefile'
+      - '.github/workflows/lint.yml'
+  pull_request:
+    paths:
+      - '**/**.go'
+      - 'Makefile'
+      - '.github/workflows/lint.yml'
+
+jobs:
+  quality-checks:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Go
+      uses: actions/setup-go@v3
+      with:
+        go-version: 1.21
+
+    - name: Install dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y libx264-dev
+
+    - name: Run linter
+      run: make lint

.gitignore

@@ -0,0 +1,5 @@
+*filtered-video
+FFmpeg
+*.mp4
+.env
+*.DS_Store

Makefile

@@ -0,0 +1,64 @@
+SOURCE_OS ?= $(shell uname -s | tr '[:upper:]' '[:lower:]')
+SOURCE_ARCH ?= $(shell uname -m)
+TARGET_OS ?= $(SOURCE_OS)
+TARGET_ARCH ?= $(SOURCE_ARCH)
+normalize_arch = $(if $(filter aarch64,$(1)),arm64,$(if $(filter x86_64,$(1)),amd64,$(1)))
+SOURCE_ARCH := $(call normalize_arch,$(SOURCE_ARCH))
+TARGET_ARCH := $(call normalize_arch,$(TARGET_ARCH))
+
+BIN_OUTPUT_PATH = bin/$(TARGET_OS)-$(TARGET_ARCH)
+TOOL_BIN = bin/gotools/$(shell uname -s)-$(shell uname -m)
+
+FFMPEG_TAG ?= n6.1
+FFMPEG_VERSION ?= $(shell pwd)/FFmpeg/$(FFMPEG_TAG)
+FFMPEG_VERSION_PLATFORM ?= $(FFMPEG_VERSION)/$(TARGET_OS)-$(TARGET_ARCH)
+FFMPEG_BUILD ?= $(FFMPEG_VERSION_PLATFORM)/build
+FFMPEG_OPTS ?= --prefix=$(FFMPEG_BUILD) \
+               --disable-shared \
+               --disable-programs \
+               --disable-doc \
+               --disable-everything \
+               --enable-static \
+			   --enable-libx264 \
+			   --enable-gpl \
+               --enable-encoder=libx264 \
+               --enable-muxer=segment \
+               --enable-muxer=mp4 \
+               --enable-demuxer=segment \
+               --enable-protocol=file \
+               --enable-protocol=concat \
+               --enable-protocol=crypto
+
+# TODO: cleanup libx264 static link
+CGO_LDFLAGS := "-L$(FFMPEG_BUILD)/lib -lavcodec -lavutil -lavformat -l:libjpeg.a /usr/lib/aarch64-linux-gnu/libx264.a -lz"
+CGO_CFLAGS := -I$(FFMPEG_BUILD)/include
+GOFLAGS := -buildvcs=false
+export PKG_CONFIG_PATH=$(FFMPEG_BUILD)/lib/pkgconfig
+
+.PHONY: lint tool-install
+
+$(BIN_OUTPUT_PATH)/filtered-video: *.go cam/*.go $(FFMPEG_BUILD)
+	go mod tidy
+	CGO_LDFLAGS=$(CGO_LDFLAGS) CGO_CFLAGS=$(CGO_CFLAGS) go build -o $(BIN_OUTPUT_PATH)/filtered-video main.go
+
+$(FFMPEG_VERSION_PLATFORM):
+	git clone https://github.com/FFmpeg/FFmpeg.git --depth 1 --branch $(FFMPEG_TAG) $(FFMPEG_VERSION_PLATFORM)
+
+$(FFMPEG_BUILD): $(FFMPEG_VERSION_PLATFORM)
+# Only need nasm to build assembly kernels for amd64 targets.
+ifeq ($(SOURCE_OS),linux)
+ifeq ($(SOURCE_ARCH),amd64)
+	which nasm || (sudo apt update && sudo apt install -y nasm)
+endif
+endif
+	cd $(FFMPEG_VERSION_PLATFORM) && ./configure $(FFMPEG_OPTS) && $(MAKE) -j$(NPROC) && $(MAKE) install
+
+tool-install:
+	GOBIN=`pwd`/$(TOOL_BIN) go install \
+		github.com/edaniels/golinters/cmd/combined \
+		github.com/golangci/golangci-lint/cmd/golangci-lint \
+		github.com/rhysd/actionlint/cmd/actionlint
+
+lint: tool-install $(FFMPEG_BUILD)
+	go mod tidy
+	CGO_CFLAGS=$(CGO_CFLAGS) GOFLAGS=$(GOFLAGS) $(TOOL_BIN)/golangci-lint run -v --fix --config=./etc/.golangci.yaml

README.md

@@ -0,0 +1,62 @@
+# Filtered Video
+The `filtered-video` module brings security camera functionality to your smart machine! The module consumes a source [Camera](https://docs.viam.com/components/camera/) and a [Vision Service](https://docs.viam.com/services/vision/), saves the camera output as video files to disk, and filters which video clips are uploaded to the cloud based on triggers from the vision service.
+
+> **Note:** This component is a work in progress and is not yet fully implemented.
+
+## Configure your `filtered-video` component
+
+Fill in the attributes as applicable to the component, according to the example below.
+
+```json
+    {
+      "name": "fv-cam",
+      "namespace": "rdk",
+      "type": "camera",
+      "model": "viam:camera:filtered-video",
+      "attributes": {
+        "camera": "webcam-1", // name of the camera to use
+        "vision": "vision-service-1", // name of the vision service dependency
+        "storage": {
+            "clip_seconds": 30,
+            "size_gb": 100
+        },
+        "video": {
+            "format": "mp4",
+            "codec": "h264",
+            "bitrate": 1000000,
+            "preset": "medium"
+        },
+        "objects": {
+            "Person": 0.8 // label key and threshold value
+        },
+        "cam_props": { // camera properties of the source camera
+            "width": 640,
+            "height": 480,
+            "framerate": 30
+        },
+      },
+      "depends_on": [
+        "webcam-1",
+        "vision-service-1"
+      ]
+    }
+```
+
+Make sure to configure a [Data Manager Service](https://docs.viam.com/services/data/cloud-sync/) to uplaod video files to the cloud.
+
+```json
+    {
+      "name": "data_manager-1",
+      "namespace": "rdk",
+      "type": "data_manager",
+      "attributes": {
+        "tags": [],
+        "additional_sync_paths": [
+          "/home/viam/.viam/video-upload/"
+        ],
+        "capture_disabled": true,
+        "sync_interval_mins": 1,
+        "capture_dir": ""
+      }
+    }
+```