Skip to content

Troubleshooting FAQ

Miiden edited this page Jan 9, 2026 · 2 revisions

EyeSpy Troubleshooting & FAQ

This page covers common issues, errors, and frequently asked questions when using EyeSpy.


Troubleshooting

❓ EyeSpy Does Not Run / Script Is Blocked

Problem

PowerShell refuses to run the script.

Solution

Temporarily bypass execution policy:

Set-ExecutionPolicy Bypass -Scope Process

Then re-run EyeSpy.

❓ No RTSP Services Found

Possible Causes

  • RTSP is running on a non-standard port
  • Firewall blocking connections
  • Network latency too high
  • Target devices are offline

Solutions

Increase timeout:

EyeSpy -Search 192.168.1.0/24 -Timeout 5000
  • Verify reachability with ping or Test-NetConnection
  • Scan smaller IP ranges

❓ Authentication Fails Even with Correct Credentials

Possible Causes

  • Incorrect RTSP path
  • Firewall blocking connections
  • Network latency too high
  • Target devices are offline

Solutions

Specify RTSP path manually:

-Path 'Streaming/Channels/101'
  • Try -Common paths
  • Increase scan timeout and retry
-Timeout 800

❓ Script Appears to Hang

Explanation

EyeSpy may be waiting for network timeouts on unresponsive hosts.

Solutions

  • Reduce CIDR range size
  • Lower timeout value
-Timeout 100
  • Let the scan complete — this is expected behavior in large networks

FAQ

❓ Can EyeSpy Be Detected?

Yes. RTSP authentication attempts and path enumeration will appear in logs on many camera systems.

Best Practices:

  • Use minimal credentials
  • Avoid brute-forcing where possible
  • Limit testing scope

❓ Is EyeSpy a Brute-Force Tool?

EyeSpy supports credential spraying/stuffing, not high-speed brute-forcing.

  • Limited attempts
  • Designed for auditing default credentials with scope for custom credentials
  • User-controlled credential lists

❓ Does EyeSpy Exploit Vulnerabilities?

No. EyeSpy:

  • Enumerates services
  • Tests authentication
  • Does not exploit firmware bugs or vulnerabilities

❓ Supported Camera Brands?

EyeSpy is vendor-agnostic but commonly works with:

  • Hikvision
  • Dahua
  • Reolink
  • Generic ONVIF / RTSP cameras
  • Results vary depending on firmware and configuration.

❓ Is This Legal?

Only when used on systems you own or are authorized to test.

Unauthorized scanning or access may violate:

  • Local laws
  • Computer Misuse Act
  • Corporate policies

🧠 Still Having Issues?

  • Review the Wiki or README for usage examples
  • Test individual IPs before CIDR ranges

Open an issue on GitHub with:

  • PowerShell version
  • Command used
  • Error output (sanitized)

Clone this wiki locally