WINK OnvifProbe CLI Reference

Commands Overview

discover

Find ONVIF cameras on the local network using WS-Discovery (UDP multicast on port 3702).

WINK_OnvifProbe discover [options]

Options

Examples

# Basic discovery
WINK_OnvifProbe discover

# Extended timeout for slow networks
WINK_OnvifProbe discover -t 15

# JSON output for scripting
WINK_OnvifProbe discover --format json

# Save to file
WINK_OnvifProbe discover -o cameras.json

scan

Actively scan IP ranges for ONVIF cameras. Supports CIDR notation.

WINK_OnvifProbe scan -n <network> [options]

Options

CIDR Examples

Examples

# Scan local subnet
WINK_OnvifProbe scan -n 192.168.1.0/24

# Multiple subnets
WINK_OnvifProbe scan -n 192.168.1.0/24,192.168.8.0/24

# With credentials
WINK_OnvifProbe scan -n 192.168.1.0/24 -u admin -p password

# Fast scan with more threads
WINK_OnvifProbe scan -n 10.0.0.0/16 --parallel 50

probe

Get RTSP URLs and stream details from a specific camera using ONVIF.

WINK_OnvifProbe probe -h <host> -u <username> -p <password> [options]

Options

Examples

# Basic probe
WINK_OnvifProbe probe -h 192.168.1.100 -u admin -p password

# JSON output
WINK_OnvifProbe probe -h 192.168.1.100 -u admin -p password --format json

# Save to file
WINK_OnvifProbe probe -h 192.168.1.100 -u admin -p password -o camera.json

guess

Guess RTSP stream URLs using manufacturer-specific patterns. Useful when ONVIF is not available or credentials differ for RTSP.

WINK_OnvifProbe guess -h <host> [options]

Options

Supported Manufacturers

Examples

# Auto-detect manufacturer
WINK_OnvifProbe guess -h 192.168.1.100 -u admin -p password

# Specify manufacturer
WINK_OnvifProbe guess -h 192.168.1.100 -u admin -p password -m Hikvision

# Try all manufacturers
WINK_OnvifProbe guess -h 192.168.1.100 -u admin -p password --all

# Stop after first working URL
WINK_OnvifProbe guess -h 192.168.1.100 -u admin -p password --stop-first

recordings

List recordings stored on an ONVIF camera (Profile G).

WINK_OnvifProbe recordings -h <host> -u <username> -p <password> [options]

Examples

# List recordings
WINK_OnvifProbe recordings -h 192.168.1.100 -u admin -p password

# JSON output
WINK_OnvifProbe recordings -h 192.168.1.100 -u admin -p password --format json

download

Get replay URI for a recording and optionally download it using ffmpeg.

WINK_OnvifProbe download -h <host> -u <user> -p <pass> -t <token> [options]

Options

Examples

# Get replay URL only
WINK_OnvifProbe download -h 192.168.1.100 -u admin -p password -t recording_001

# Download 60 seconds to file
WINK_OnvifProbe download -h 192.168.1.100 -u admin -p password -t recording_001 -o clip.mp4

# Download 5 minutes
WINK_OnvifProbe download -h 192.168.1.100 -u admin -p password -t recording_001 -o clip.mp4 -d 300

test

Batch test multiple cameras from a JSON file.

WINK_OnvifProbe test -i <input.json> [-o <output.json>]

Input File Format

{
  "cameras": [
    {
      "host": "192.168.1.100",
      "username": "admin",
      "password": "password",
      "port": 80
    },
    {
      "host": "192.168.1.101",
      "username": "admin",
      "password": "password"
    }
  ]
}

Exit Codes

Common ONVIF Ports

The tool automatically tries these ports when --port is not specified:

Scripting Examples

Bash: Discover and probe all cameras

#!/bin/bash
# Discover cameras and probe each one

WINK_OnvifProbe discover --format json -o /tmp/cameras.json

jq -r '.cameras[].host' /tmp/cameras.json | while read host; do
    echo "Probing $host..."
    WINK_OnvifProbe probe -h "$host" -u admin -p password --format json
done

Bash: Check if camera is online

#!/bin/bash
if WINK_OnvifProbe probe -h 192.168.1.100 -u admin -p password -q; then
    echo "Camera is online"
else
    echo "Camera is offline"
fi

Python: Parse JSON output

import subprocess
import json

result = subprocess.run(
    ['WINK_OnvifProbe', 'probe', '-h', '192.168.1.100',
     '-u', 'admin', '-p', 'password', '--format', 'json'],
    capture_output=True, text=True
)

data = json.loads(result.stdout)
for profile in data['profiles']:
    print(f"Stream: {profile['rtspUrl']}")

PowerShell: Scan and export

# Scan network and export to CSV
$result = WINK_OnvifProbe scan -n 192.168.1.0/24 --format json | ConvertFrom-Json
$result.cameras | Export-Csv -Path cameras.csv -NoTypeInformation

Environment Variables

Troubleshooting

Discovery finds no cameras

• Ensure cameras are on the same subnet
• Check firewall allows UDP port 3702
• Some cameras don't respond to WS-Discovery - try scan command instead

Authentication fails

• Verify username/password
• Some cameras have separate ONVIF and web UI credentials
• Try different authentication ports

RTSP URLs don't work

• Camera may use different RTSP credentials
• Try guess command with --ffprobe flag
• Check if camera requires TCP transport

WINK OnvifProbe is licensed under Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0). ONVIF is a registered trademark of ONVIF, Inc.