README.md

April 24, 2026 · View on GitHub

Strix  |  STRIX

GitHub Stars Docker Pulls GitHub Downloads License

Camera stream discovery and Frigate config generator.


Live Demo  •  Supported Cameras  •  Video  •  API Docs

Install

Any Linux or Proxmox, one command:

bash <(curl -fsSL https://raw.githubusercontent.com/eduard256/Strix/main/install.sh)

Run as root (or with sudo). Interactive installer detects your system (Linux / Proxmox) and guides you through setup.

Open http://YOUR_IP:4567

How it works

Enter camera IP. Strix probes the device - open ports, MAC vendor, mDNS, HTTP server.

Search camera model in database. Enter credentials if needed.

Strix builds all possible stream URLs from database patterns.

20 parallel workers test every URL. Live screenshots, codecs, resolution, latency.

Pick main and sub streams from results.

Generate ready Frigate config. Copy, download, or save directly to Frigate.

Camera works in Frigate. Done.

Other install methods

Docker

docker run -d --name strix --network host --restart unless-stopped eduard256/strix:latest

Docker Compose

Strix only:

curl -O https://raw.githubusercontent.com/eduard256/Strix/main/docker-compose.yml
docker compose up -d

Strix + Frigate:

curl -O https://raw.githubusercontent.com/eduard256/Strix/main/docker-compose.frigate.yml
docker compose -f docker-compose.frigate.yml up -d

Strix + go2rtc:

curl -O https://raw.githubusercontent.com/eduard256/Strix/main/docker-compose.go2rtc.yml
docker compose -f docker-compose.go2rtc.yml up -d

Podman

Podman drops NET_RAW and NET_ADMIN by default, which Strix needs for network scanning. Add them explicitly:

podman run -d \
  --name strix \
  --network host \
  --cap-add=NET_RAW \
  --cap-add=NET_ADMIN \
  --restart unless-stopped \
  eduard256/strix:latest

Or run with --privileged if you prefer.

Home Assistant Add-on

  1. Settings > Add-ons > Add-on Store
  2. Menu (top right) > Repositories > add https://github.com/eduard256/hassio-strix
  3. Install Strix, enable Start on boot and Show in sidebar

Umbrel

Install on Umbrel

Install in one click from the Umbrel App Store.

Binary

Download from GitHub Releases. No dependencies except ffmpeg for screenshot conversion.

chmod +x strix-linux-amd64
STRIX_LISTEN=:4567 ./strix-linux-amd64

Supported protocols

ProtocolPortDescription
RTSP554Most IP cameras
RTSPS322RTSP over TLS
HTTP/HTTPS80/443MJPEG, JPEG snapshots, HLS, MPEG-TS
RTMP1935Some Chinese NVRs
Bubble80XMeye/NetSurveillance cameras
DVRIP34567Sofia protocol DVR/NVR
HomeKit51826Apple HomeKit cameras via HAP

Configuration

VariableDefaultDescription
STRIX_LISTEN:4567HTTP listen address
STRIX_DB_PATHcameras.dbPath to SQLite camera database
STRIX_LOG_LEVELinfoLog level: debug, info, warn, error, trace
STRIX_FRIGATE_URLauto-discoveryFrigate URL, e.g. http://localhost:5000
STRIX_GO2RTC_URLauto-discoverygo2rtc URL, e.g. http://localhost:1984

Camera database

SQLite database with 3,600+ brands and 100,000+ URL patterns. Maintained separately in StrixCamDB. Database is embedded in Docker image and bundled with binary releases.

Browse supported cameras - search by brand or model to check if your camera is in the database.

Three entity types:

  • Presets - curated sets of popular URL patterns (e.g. "ONVIF", "Popular RTSP")
  • Brands - all URL patterns for a brand (e.g. "Hikvision", "Dahua")
  • Models - URL patterns for a specific model within a brand

Camera not in the database? Add it here.

Developers: integrate Strix HTTP API into your smart home platform.

Testing: StrixCamFake - IP camera emulator for development and testing. StrixAHKCamFake - Apple HomeKit camera emulator.