cctvql

n8n community nodes for cctvQL — natural-language CCTV queries, live events, and PTZ control across Frigate, Hikvision, Synology, and more.

Package Information

Downloads: 7 weekly / 122 monthly
Latest Version: 1.0.0
Author: arunrajiah

Available Nodes

cctvQL Query icon
cctvQL Query
Ask cctvQL a natural language question about your cameras
cctvQL Events icon
cctvQL Events
Fetch recent detection events from cctvQL, optionally filtered by camera or label
cctvQL PTZ icon
cctvQL PTZ
Send a pan/tilt/zoom command to a camera via cctvQL

Documentation

n8n-nodes-cctvql

n8n community nodes for cctvQL — a natural-language query layer for CCTV systems.

Ask questions like "Were there any people at the front door last night?" directly inside n8n workflows, fetch live detection events, and send PTZ commands — across Frigate, Hikvision, Synology, Dahua, Milestone, ONVIF, and more.

Installation

In your n8n instance: Settings → Community Nodes → Install → search n8n-nodes-cctvql

Or via CLI:

npm install n8n-nodes-cctvql

Prerequisites

A running cctvQL server:

docker run -p 8000:8000 \
  -e CCTVQL_ADAPTER=frigate \
  -e CCTVQL_FRIGATE_HOST=http://192.168.1.100:5000 \
  ghcr.io/arunrajiah/cctvql:latest

Credentials

Create a cctvQL API credential with:

  • Host — hostname or IP of your cctvQL server (default: localhost)
  • Port — port (default: 8000)
  • Protocol — http or https
  • API Key — optional, if you have auth enabled

Nodes

cctvQL Query

Ask cctvQL a natural language question. Supports n8n expressions so the query can come from upstream nodes.

Property Description
Query Natural language question (required)
Session ID For multi-turn conversations (default: n8n)

Output fields: answer, intent, session_id, plus the full API response.

cctvQL Events

Fetch recent detection events, optionally filtered by camera or label. Each event becomes a separate item when Split Into Items is on.

Property Description
Camera Filter by camera name (blank = all)
Label Filter by object label e.g. person, car
Limit Max events to return (default 20)
Split Into Items One item per event (default on)

cctvQL PTZ

Send a pan/tilt/zoom command to a camera.

Property Description
Camera ID Camera to control (supports expressions)
Action left / right / up / down / zoom_in / zoom_out / home / preset
Speed 1–100 (default 50)
Preset ID Required when action is Go to Preset

Example Workflow

[
  {
    "nodes": [
      { "name": "Schedule Trigger", "type": "n8n-nodes-base.scheduleTrigger" },
      { "name": "cctvQL Query",     "type": "n8n-nodes-cctvql.cctvqlQuery",
        "parameters": { "query": "Any motion at the back door in the last hour?", "sessionId": "nightly-check" } },
      { "name": "Send Telegram",    "type": "n8n-nodes-base.telegram",
        "parameters": { "text": "={{ $json.answer }}" } }
    ]
  }
]

License

MIT — arunrajiah/cctvql

Discussion