Agent DVR is a standalone replacement for iSpy that runs as a service, uses less CPU and features a web user interface that is accessible from anywhere with no port forwarding required!

We recommend that you use either iSpy or Agent - you can use both but it may cause issues with device drivers and network access.

Tip: Click the button above to show/ hide the userguide index.

Using Agent

Agent does not have a windows forms user interface like iSpy does. The user interface is all browser based via the local portal, web portal or mobile applications

Agent runs it's own webserver. By default this is running at http://localhost:8090 on the PC running Agent (although it may be using a different port if that wasn't available or was changed when it was installed - see the link "Agent UI" on the desktop on Windows).

Once you have the local UI open you can start adding devices to Agent - see the edit icon to get started.

Agent has help built into it - click on the "?" icon at top right to access videos and other help resources.

Tip: Enable shortcut keys in Account menu - Theme Settings. "C" opens the Commands menu, "S" opens the server menu. 1-5 opens the various views. Enable Tool-Tips and mouse-over the bottom controls in the UI to show additional shortcut keys.

Any issues? First thing to check is the logs at /logs.html on the local server. That will give you details about any problems Agent is having. If that doesn't help please feel free to jump onto our Reddit group and ask a question - include the logs and steps to reproduce the problem if possible.

Pro Tip: Be sure to read the Performance Tips to get the most out of your system.

Supported Languages

The Agent DVR application has been translated into English, Čeština, Deutsch, Español, Française, Hindi, Italiano, Nederlands, Polskie, Português, Русский, عربي, 中文, 繁体中文, বাংলা

To change the language, click on Account - Language.


Download Agent DVR from here and run the installer. Agent runs as a console application (or as a service on Windows) on Windows 7+, Linux X64 (tested with Ubuntu 18.04+), OSX 64, Arm and Arm64 based operating systems (like Raspberry Pi).

Follow the setup instructions for your operating system on the download page

Once Agent is running, you can access it via most web browsers at http://localhost:8090. Some web browsers (notably Firefox) require a media permission to start WebRTC which is needed to communicate with the Agent service. Just the permission is required - Agent won't actually use it. If you decline the permission and Agent fails to connect you'll need to grant it and click on Reload. You can grant the permission by clicking on the icons to the left of the Address bar in the web browser.


If the installer on Windows fails to complete and Agent doesn't start or you are having issues accessing Agent or you need to use functionality that isn't available when running as a windows service (like some GPU drivers and desktop monitoring) then you can run Agent from a command prompt:

  • Stop the Agent service if it is running: Click Start - Run - Type "services.msc" - press enter. Right click "Agent" in the list and click Stop. You can prevent it from starting as a service when you reboot by right clicking on Agent, click Properties and set the startup type to "Disabled". Click Apply and OK.
  • Open a console window: Click Start - Type "cmd", right click on "Command Prompt" and click "Run as administrator"
  • Change directory to the Agent directory. Usually this would be "cd C:\Program Files\Agent"
  • Run Agent DVR as a console application - type "Agent.exe" - press enter

Agent will then tell you if there are any problems starting and what local port it is running on. You can quit Agent at any time by pressing the enter key. When Agent is running in the console it is able to use more GPU devices and can record from the Desktop.

If there is an anti virus app or firewall blocking Agent from listening on a local port then you may need to add Agent.exe to a safe list or open the port it is listening on in the local firewall.

If you are using a Windows N variant you will need to install the media feature pack for Windows N

On Linux and Raspberry Pi your system may not have some required libraries installed and Agent may fail to start with an error like libcvextern.so could not be found. You will need to use ldd to find which libraries are missing. To do this, open a terminal window, change to the Agent directory and run ldd libcvextern.so (or whatever library is causing issues). The output should tell you which dependencies need to be installed. Please let us know what's needed and what operating system you are using so we can update our docs.

Corrupted Video? Agent defaults to using UDP to connect to cameras. UDP is a fast network protocol which prioritises real-time, low delay video. Unfortunately UDP doesn't have any error correction built into it so any electronic noise from faulty cabling to interference from power cables, amplifiers or other sources can result in corrupted video by the time the signal gets to Agent. You can switch to TCP instead which does have error correction built into it - but at the cost of some buffering and potential lag on the live feed. To switch to TCP instead, edit the camera, click to edit the Source on the General tab, select "FFMPEG" in the menu at top right and change the RTSP mode to TCP.

Stuttering Video? Some cameras (notably Reolink) emit frames in groups of audio and video which can result in stuttering live and recorded playback. To work around this, edit the camera, click to configure the videosource settings, select the FFMPEG tab and set a value for Max Delay (for example 4 seconds) and a value for Max Reorder Queue Size (for example 500).

Accessing Logs

Agent provides formatted live logs on the local server at /logs.html (so on a default install at http://localhost:8090/logs.html). As of version Agent also saves the 5 most recent raw logs in .json format to your Media location (on Windows that's C:\Program Files\Agent\Media). You can use these for debugging and getting more information on what Agent is doing. You can also download the raw logs remotely via the server menu in the web portal. Feel free to jump on our Community boards to ask questions!

Upgrading from iSpy

  • Save your object list in iSpy (File - Save object list)
  • Close iSpy (make sure it's not running in the task bar)
  • Install Agent DVR
  • Click on the Server icon in Agent DVR (top left), Backup/ Restore, Upload and choose the file you saved. Note this will only update your object list - you may need to adjust server settings manually.
  • Click on the account menu in Agent DVR and Remote Access to pair it with the remote portal (optional)
  • If you have multiple servers connected using the old version and the new version you'll need to swap between them using the account menu (top right of Agent DVR) and "Change Platform".
  • It's recommended you uninstall iSpy from Add/ Remove programs after you have setup Agent DVR as they may conflict for device access.

Upgrading from Agent (original version)

  • Stop the original version of Agent (If it's running as a service, click Start - Run - Type "services.msc" Find Agent in the list, right click -> stop).
  • Install Agent DVR
  • Click on the Server icon in Agent DVR (top left), Backup/ Restore, Upload and choose objects.xml from the Media/XML directory of the original Agent (usually C:\Program Files\Agent\Media\XML). Note this will only update your object list - you may need to adjust server settings manually.
  • Click on the Server icon in Agent DVR and Remote Access to pair it with the remote portal (optional)
  • If you have multiple servers connected using the old version and the new version you'll need to swap between them using the account menu (top right of Agent DVR) and "Change Platform".
  • Once you have the new version working you can delete (or archive) the old version of Agent

Moving to a new Computer

You can move Agent to a new computer easily - just copy the Agent directory to the new PC and delete it from the old one.

If you get an in-use error when you try to delete it you can double click on "agent-uninstall-service.bat" in the Agent directory (on Windows) to close it and stop it from starting up and then delete it again.

If you have a basic subscription and have 2 instances of Agent connected to your account only one will be visible on the web portal - you will need to stop the first one for the other to connect successfully.

Remove an instance from my account

You can either just stop Agent running and delete it or if you want to keep it running just not connected to your account then:

  • Stop Agent (If it's running as a service, click Start - Run - Type "services.msc" Find Agent in the list, right click -> stop).
  • Delete the file Media/serial.txt
  • Edit the file Media/XML/config.xml and remove the UserIdent element from that file and save it
  • Restart Agent

Move instance to another account

Remote Access

Agent DVR uses WebRTC to setup remote connections so doesn't require any port forwarding setup and will work even over mobile internet connections. To connect remotely you will need to pair Agent with your iSpyConnect account. To do this, click on the account icon in the local web interface and "Remote Access". You'll be redirected to the online portal.

Important: You do not need to install Agent DVR on other computers or setup port forwarding for remote access. Just open up a web browser on any device at https://www.ispyconnect.com/app once Agent is connected. Remote access to Agent is a subscription service.

Just Subscribed?: Sometimes it takes a few minutes for the notification to come through from our payment processor. Check back later and try clicking on Remote Access in the local web interface to connect Agent to your account. If paying by echeque it can take a few days to clear - if you need access urgently and are waiting for the payment to clear then contact us and we may be able to apply a trial to your account.

No UI?: If you have downloaded Agent DVR to a VPS or a PC with no graphical UI you can still setup Agent for remote access by calling "Agent.exe register" on Windows or "dotnet Agent.dll register" on Linux/ OSX. This will give you a claim code you can use to access Agent from another PC.

Can't connect?: In rare instances a connection may fail due to content filtering on a VPN connection. You'll need to add exceptions in your content filtering software for *.ispyconnect.com and *.azurewebsites.net

Why use the website?: Agent uses webrtc for media connections which gets around most firewalls and port forwarding issues. On your local network your web browser can connect directly to Agent but for remote access web browsers require SSL connections, STUN, TURN and relay servers for connection establishment which we provide via ispyconnect.com

Unsubscribe?: Just click on the Account menu, change subscription and cancel.

LAN Access

To access Agent over your LAN you will need to open up the port Agent is using in your Firewall for your local network (default is port 8090). When you have done this you can browse to Agent at http://IPADDRESS:8090 (where IPADDRESS is the IP address of the computer running Agent - for example,

Agent uses WebRTC which uses random ports to connect over the network. This can cause issues if you have a firewall or antivirus blocking incoming connections. Webrtc generally uses ports over 50000 so if you have problems connecting over the local network try allowing a LAN port range of 50000 - 65535 in your firewall (or use our website).

To secure LAN access set a username and password in Server Settings - Local Server. If you forget this password you can reset it by stopping Agent and calling "Agent.exe reset-local-login" on Windows or "dotnet Agent.dll reset-local-login" on OSX and Linux.

Some browser extensions can also block access so if you have issues connecting locally try a different browser (Safari, Chrome, Firefox and the latest version of Edge should all work). Also try disabling any extensions and clearing your cache.


If Agent is running as a service then stop the service (by clicking start - run and enter "services.msc". Find Agent in the list, right click it and click stop) and run agent-uninstall-service.bat in the Agent directory.

To remove Agent just delete the Agent directory (Agent is a portable application so doesn't install into the add/remove programs list in Windows). By default Agent is installed to C:\Program Files\Agent on Windows

Switching Accounts

Save your configuration from the Server menu using the Import/Export option. Then stop the Agent service and run the agent-reset.bat or agent-reset.sh command. Start Agent again and load back in your configuration and then click on Remote Access under the Server menu to connect to your new account.