Skip to content

agnify camera

Create a camera and print its cam-… id.

Push cameras need no driver; managed cameras require --driver and may carry --config-json. In table mode a ready-to-run agnify camera stream … hint is printed to stderr.

Usage

Terminal window
agnify camera create [OPTIONS] NAME

Arguments

NameDescription
NAMEHuman-readable camera name.

Options

FlagDescription
--ingestIngest mode: ‘push’ or ‘managed’. (default: push)
--driverManaged driver: neolink
--config-jsonDriver config as a JSON object (managed only).
--profilesComma-separated profiles to declare (main,sub). (default: main)
--segment-durationSegment chunk length in seconds (10..3600). (default: 60)

Download a thumbnail of recorded camera footage and print its local path.

The camera analog of agnify file frame: peek at the footage before authoring a pipeline over it. Resolves through the closest-segment thumbnail at GET /api/v1/vms/cameras/{id}/thumbnail; no Authorization header is sent to the presigned S3 URL itself.

Usage

Terminal window
agnify camera frame [OPTIONS] CAMERA_ID

Arguments

NameDescription
CAMERA_IDCamera id, e.g. cam-304d00 — as listed by agnify camera list.

Options

FlagDescription
--atMoment to grab — ISO-8601 or unix seconds. Defaults to now; pass the source’s date_from to peek the start of the analysis window.
--out-dirDirectory to write the frame into. Defaults to a temp dir.

List the active org’s cameras with a per-profile status summary.

Usage

Terminal window
agnify camera list

Show per-profile status, desired state, and last segment/heartbeat.

Usage

Terminal window
agnify camera status CAMERA_ID

Arguments

NameDescription
CAMERA_IDCamera id (cam-…).

Chunk a local source into segments and push them to a camera.

Runs ffmpeg -c copy -f segment, uploads each finalized segment via the presigned ingest flow, heartbeats in between, and obeys the desired_state envelope (pause/stop/resume) every response returns.

Usage

Terminal window
agnify camera stream [OPTIONS] CAMERA_ID

Arguments

NameDescription
CAMERA_IDCamera id (cam-…).

Options

FlagDescription
--sourceRTSP/HTTP URL or local device (e.g. /dev/video0).
--profileProfile this process streams (main
--segment-durationOverride the chunk length in seconds. (default: 60)
--heartbeat-intervalSeconds between heartbeats when no segment activity. (default: 30.0)