https://github.com/eduard256/Strix
Smart IP camera stream finder. Tests 102K+ URL patterns in 30 seconds. Supports 67K camera models. Generates ready Frigate/go2rtc configs.
https://github.com/eduard256/Strix
camera-discovery cctv dahua docker ffmpeg frigate go2rtc golang hikvision home-assistant home-automation ip-camera mjpeg nvr onvif rtsp self-hosted selfhosted surveillance video-streaming
Last synced: 5 days ago
JSON representation
Smart IP camera stream finder. Tests 102K+ URL patterns in 30 seconds. Supports 67K camera models. Generates ready Frigate/go2rtc configs.
- Host: GitHub
- URL: https://github.com/eduard256/Strix
- Owner: eduard256
- License: mit
- Created: 2025-10-28T10:38:51.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-04-16T19:00:46.000Z (about 2 months ago)
- Last Synced: 2026-04-16T19:11:14.589Z (about 2 months ago)
- Topics: camera-discovery, cctv, dahua, docker, ffmpeg, frigate, go2rtc, golang, hikvision, home-assistant, home-automation, ip-camera, mjpeg, nvr, onvif, rtsp, self-hosted, selfhosted, surveillance, video-streaming
- Language: HTML
- Homepage:
- Size: 11.3 MB
- Stars: 645
- Watchers: 3
- Forks: 29
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-selfhosted - Strix - Auto-discovers working stream URLs for IP cameras and generates ready-to-use Frigate and go2rtc configs. `MIT` `Go/Docker` (Software / Video Surveillance)
- awesome-selfhosted - Strix - Auto-discovers working stream URLs for IP cameras and generates ready-to-use Frigate and go2rtc configs. `MIT` `Go/Docker` (Software / Video Surveillance)
- fucking-awesome-selfhosted - Strix - Auto-discovers working stream URLs for IP cameras and generates ready-to-use Frigate and go2rtc configs. `MIT` `Go/Docker` (Software / Video Surveillance)
README
|
STRIX
Camera stream discovery and Frigate config generator.
- 3,600+ camera brands with 100,000+ [URL patterns](#streams) in SQLite database
- automatic device [probing](#probe) in 100ms: ports, ARP/OUI, mDNS/HomeKit, HTTP
- 20 parallel workers [test every URL](#testing) with live screenshots
- supports [RTSP, HTTP, RTMP, Bubble, DVRIP](#supported-protocols) and more
- ready [Frigate config](#config-generation) with smart merge into existing setup
- auto-discovery of Frigate and [go2rtc](https://github.com/AlexxIT/go2rtc) on local network
- zero-dependency static [binary](#binary) for Linux amd64/arm64
- can be used as [standalone app](#binary), [Docker](#docker), or [Home Assistant add-on](#home-assistant-add-on)
---
Live Demo
•
Supported Cameras
•
Video
•
API Docs
## Install
Any Linux or Proxmox, one command:
```bash
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
```bash
docker run -d --name strix --network host --restart unless-stopped eduard256/strix:latest
```
### Docker Compose
Strix only:
```bash
curl -O https://raw.githubusercontent.com/eduard256/Strix/main/docker-compose.yml
docker compose up -d
```
Strix + [Frigate](https://github.com/blakeblackshear/frigate):
```bash
curl -O https://raw.githubusercontent.com/eduard256/Strix/main/docker-compose.frigate.yml
docker compose -f docker-compose.frigate.yml up -d
```
Strix + [go2rtc](https://github.com/AlexxIT/go2rtc):
```bash
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:
```bash
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 in one click from the [Umbrel App Store](https://apps.umbrel.com/app/strix).
### Binary
Download from [GitHub Releases](https://github.com/eduard256/Strix/releases). No dependencies except `ffmpeg` for screenshot conversion.
```bash
chmod +x strix-linux-amd64
STRIX_LISTEN=:4567 ./strix-linux-amd64
```
## Supported protocols
| Protocol | Port | Description |
|----------|------|-------------|
| RTSP | 554 | Most IP cameras |
| RTSPS | 322 | RTSP over TLS |
| HTTP/HTTPS | 80/443 | MJPEG, JPEG snapshots, HLS, MPEG-TS |
| RTMP | 1935 | Some Chinese NVRs |
| Bubble | 80 | XMeye/NetSurveillance cameras |
| DVRIP | 34567 | Sofia protocol DVR/NVR |
| HomeKit | 51826 | Apple HomeKit cameras via HAP |
## Configuration
| Variable | Default | Description |
|----------|---------|-------------|
| `STRIX_LISTEN` | `:4567` | HTTP listen address |
| `STRIX_DB_PATH` | `cameras.db` | Path to SQLite camera database |
| `STRIX_LOG_LEVEL` | `info` | Log level: `debug`, `info`, `warn`, `error`, `trace` |
| `STRIX_FRIGATE_URL` | auto-discovery | Frigate URL, e.g. `http://localhost:5000` |
| `STRIX_GO2RTC_URL` | auto-discovery | go2rtc URL, e.g. `http://localhost:1984` |
## Camera database
SQLite database with 3,600+ brands and 100,000+ URL patterns. Maintained separately in [StrixCamDB](https://github.com/eduard256/StrixCamDB). Database is embedded in Docker image and bundled with binary releases.
[Browse supported cameras](https://gostrix.github.io/) - 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](https://gostrix.github.io/#/contribute).
**Developers:** integrate [Strix HTTP API](DEVELOPERS.md) into your smart home platform.
**Testing:** [StrixCamFake](https://github.com/eduard256/StrixCamFake) - IP camera emulator for development and testing. [StrixAHKCamFake](https://github.com/eduard256/StrixAHKCamFake) - Apple HomeKit camera emulator.