Software Startup Issues

This forum lists all the articles available when you experience issues with Blue Iris.
Start with the Windows Tuning article.
Post Reply
varghesesa
Posts: 61
Joined: Thu Jul 11, 2019 9:52 pm

Software Startup Issues

Post by varghesesa » Mon Feb 08, 2021 6:29 pm

Introduction

If the software no longer starts, there is little that can be done to troubleshoot the issue. Follow the steps below to manually change registry settings to get the software running again.

If the software starts, but takes longer than before or takes a long time, i.e. more than 5s to start, this almost always implies you have a corrupt file.
Run Microsoft's System File Checker on your hardrive to see if there are any damaged files. From command prompt, run "sfc/scannow"


If you are unfamiliar with Windows registry, this YouTube video should provide enough context to carry out actions below.

Before starting

Before doing anything, make sure you have the below two pieces of information.
The worst feeling is when you start something and it breaks and there is no way to go back!
  • Your license key. The easiest way to store your license key is to mail your support info to yourself.
    This way you will always have a copy of your license in your email.
  • Working registry settings.
If you routinely backup BI settings great! Find your backup and save it to a thumb drive (better safe than sorry).
If not, BI automatically saves your settings from the last 3 days. Go to your program installation directory, usually "C:\Program Files\Blue Iris 5". You will find 3 settings: backup.reg, backup2.reg and backup3.reg from newest to oldest. Hopefully, one of those will work.


Quick Fixes

This section has quick fixes to common tickets.

Hardware acceleration

Scenario: BI starts crashing immediately. But you have no idea why. All you did was update BI or just notice instability one day.

Frequent crashes usually mean the hardware decoding is not happy with one of your cameras. Usual issue is the camera is set to H.265 encoding, but your QuickSync or hardware decoder does NOT support H.265. Easy fix is to go into the registry and turn off hardware acceleration globally.

Global hardware acceleration
How to turn HA off globally (for all cameras)
Find the below key in the Registry (Windows start button -> regedit):
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Perspective Software\Blue Iris\Options
Set hwaccel to 0.

Hardware acceleration per camera
How to turn off HA for each camera.
Find HKEY_LOCAL_MACHINE\SOFTWARE\Perspective Software\Blue Iris\Cameras
For each camera, set the value of ip_hwaccel to 2.



Clear registry

Scenario: This seems like the solution of choice when you did something funky, e.g. resulting in the display or something else no longer working properly or the software will not start. You can either clear the registry and start over or load past settings.

Make sure you meet all the requirements in the Before Starting section ABOVE especially having a working backup file. If not, you will be re-adding all your cameras.

Steps to clean out registry:
  • Stop BI. BI should not be running as a service or manually.
    See Stop BI service section (below) on how to stop the BI service.
  • Run regedit and delete the following keys if they exist:
    HKEY_CURRENT_USER\SOFTWARE\Perspective Software
    HKEY_LOCAL_MACHINE\SOFTWARE\Perspective Software
  • Start or Reinstall BI.
    (optional) If reinstalling BI, temporarily disable antivirus software after installing BI.
Step to restore past settings:
If you want to start from a previously stable setting, import your registry settings. Global settings -> About tab -> Import settings.
Need stable settings saved from the past as stated in Before starting section.


Troubleshooting Crashes

Below is how users can isolate crashes using the registry. Another cool tool in the toolbox. This is where you go if the Quick Fixes above do not start the software. If you prefer to watch the webinar associated with this article, checkout the Performance and Troubleshooting webinar.

Again, before doing anything with the registry, go through Before starting section ABOVE.
Stop the BI service (below) if not done so already.

Disconnect All your Cameras
This section explains how to disconnect all your cameras using the registry. It's an easy test to determine whether the startup issue lies with your cameras or some other functionality in BI. An example of isolating the issue.
  • First shutdown BI if it is running.
  • Type regedit in the Window search bar (lower left) and select Registry Editor
  • Search for the BI settings: HKEY_LOCAL_MACHINE\SOFTWARE\Perspective Software\Blue Iris (see image below)
  • Rename the Cameras key to CamerasX. This will immediately remove all your cameras from BI. If the software starts up, then you know there is an issue with one of your camera settings.
Once you know the issue lies with cameras, rename CamerasX back to Cameras. Proceed below to identify the offending camera(s).

Disabling a camera

This section explains how to disable a camera using the registry.
  • First shutdown BI if it is running.
  • Type regedit in the Window search bar (lower left) and select Registry Editor
  • Search for the BI settings: HKEY_LOCAL_MACHINE\SOFTWARE\Perspective Software\Blue Iris (see image below)
    registry.PNG
    registry.PNG (49.28 KiB) Viewed 3256 times
  • Go to a camera and change enabled to 0. This effectively disables the camera. (see image below)

    camera registry.png
    camera registry.png (59.14 KiB) Viewed 3256 times

Troubleshooting cameras

Now you know how to disable cameras using the registry. You can now leverage the registry to identify the offending camera(s).

I prefer using the UI to troubleshoot instead of the registry. In order to get the software started as quickly as possible, I first turn off hardware acceleration globally. Hardware acceleration with a camera(s) is often the issue with software startup.

Follow hardware acceleration steps above to turn off HA globally.
  • Disable all the cameras via the registry using technique above.
  • BI should start.
  • From the UI, you can now enable camera(s) one-by-one until software crashes.
  • Make note of offending camera and go back into registry and disable the camera.
  • Repeat steps and disable all offending camera(s).
If you have many cameras, users typically divide and conquer. Disable half your cameras and see if the other half crashes. If not, the disabled half of cameras has offending camera(s). If so, the current half of cameras has an offending camera(s). This logic applies to section below as well.

Identify Camera <> HA Conflicts

If the software starts with ALL the camera(s) enabled, it is very likely individual camera(s) incompatibility with HA is the reason for startup failures.
  • Turn HA off for each of the cameras via the registry. Follow hardware acceleration steps above to turn off HA for each camera.
  • Start the software.
  • Turn HA on globally. Global settings -> Cameras tab.
  • Software should still be running since HA is off for each camera. Camera settings -> Video tab.
  • Turn HA on for each camera. When the software crashes, you identified a camera with compatibility issues with HA.
  • Go back to registry and turn off HA for the offending camera. Repeat above until you identify all offending camera(s)
Troubleshoot offending camera(s)

Once you know the offending camera(s), revisit the Hardware decode section in the Video tab article for the offending camera(s).


Disable all settings (rare occasion)
If the software does not start with ALL the cameras disabled, there is the ability to start BI with no settings. By doing so, you can test if the BI executable is corrupt or there is a conflict between your server and BI.
  • First shutdown BI if it is running.
  • Type regedit in the Window search bar (lower left) and select Registry Editor
  • Search for the BI settings: HKEY_LOCAL_MACHINE\SOFTWARE\Perspective Software\Blue Iris (see image below)
    registry.PNG
    registry.PNG (49.28 KiB) Viewed 3256 times
  • Rename the Blue Iris key, e.g. Blue Iris Orig.
    This will cause BI to start with no settings, i.e. a new install.
    Start BI and see if the program starts.
  • To go back to your settings, first shutdown the BI program.
    In the Registry, go to your original settings, i.e. Blue Iris Orig in example, and rename key to Blue Iris.
If the program does not start with no settings, go to the website (blueirissoftware.com) and download/install the latest software.
Start the software. If the software still does not start, you will need to examine the hardware or operating system.



Miscellaneous

Reset password

Reset password is a common ticket. If you forgot your admin password and you cannot access BI follow the below steps.

**To reset your password**, run REGEDIT and delete this key:

HKEY_LOCAL_MACHINE\SOFTWARE\Perspective Software\Blue Iris\server\users\local_console

Then find the key

HKEY_LOCAL_MACHINE\SOFTWARE\Perspective Software\Blue Iris\Options

and set the "runasadmin" value back to its default of 1. This is the "require run as administrator" checkbox on the Settings/Startup page.
This will disable the login prompt altogether.


Stop BI service

How to stop a BI service manually. Used frequently in tasks above before editing the registry.
  • To do so, in the Windows search bar, type services and bring up the services app.
  • Find the "Blue Iris Service" service.
  • Double-click the entry
  • Change Startup type from Automatic to Manual
  • Then stop the service.

Final thoughts
At this point, your BI server should be up and running. Below are other topics dealing with system stability.

Rolling back to previous BI settings

Rolling back to previous BI software versions

Windows Tools: Leveraging Windows capabilities to roll back Windows updates or Software Security updates and other topics.
Post Reply