The Web Server

The Blue Iris Web Server feature allows you to create a LAN and/or Internet home page right on your own PC.  You can use this server to view your cameras and recordings from another PC in your home or office, or from anywhere in the world.  When you first install Blue Iris, the web server is enabled, and is configured for local network (Intranet) use.  Click the Earth toolbar icon to view your home page in your default Internet browser (e.g. Internet Explorer).

The home page that is installed with Blue Iris (its name is default.htm) contains a window for live video, and a window with thumbnails of the four most recent clips.  There are also options to switch cameras in multiple-camera configurations, and to open any clip on the clip list.  Because of the ActiveX control that is used, this page will only be used by Internet Explorer.  Other browsers will open JAVA-based pages, either jpegpush.htm or jpegpull.htm.

To view and edit the Web Server's configuration, click the Options toolbar icon (the gear, second from the left), and then click the "web server" tab. 

The new help page network configuration and troubleshooting offers instructions on how to configure your web server for viewing on either the local network (LAN), the Internet, or both.

Port number

You should not change the port number from 81 unless you know what you are doing and have a reason for doing so.  Port 80 is actually the default HTTP address used by websites on the Internet, but it is often blocked by ISPs for incoming connections or is very difficult to forward through your router.

Local, internal (LAN) access

The LAN address shows you how to access the Blue Iris server from another PC on your LAN.  For a wireless network, you may need to instead use a LAN IP address instead of the computer name.  Note: for configuration/testing purposes, the name "localhost" and the IP address "127.0.0.1" always refer to your own PC.  Note: your PC's LAN IP address (192.168.x.x) is internal, and cannot be used in a browser outside of your local network.

If you want to access the Blue Iris Web Server from another PC on your LAN (local area home or business network), open a browser and type into the address bar the Blue Iris computer's name (e.g., http://officepc) or LAN IP address (typically http://192.168.x.x).  For your convenience, a list of LAN IP addresses in use by your PC is generated.  This list is for reference only; it is not necessary to select from this list.  You will need your PC's LAN IP address later when you configure your router for remote access. 

When connecting, you will be prompted for a user name and password.  These are configured on the Options/Users page.

Remote, external (Internet) access

The Router's IP address is the IP address that must be used from OUTSIDE of your LAN for remote access to Blue Iris.  In order to see Blue Iris via this IP address from the outside world, you are going to have to configure your router and firewall to allow access.  Again, see the page network configuration and troubleshooting for these instructions.   If your IP address is "67.1.2.3" for example, you may then use "http://67.1.2.3" in a web browser on any PC on the Internet.  If the port number is other than the default of 80 that number will have to be added to the URL.  If the port is 81, for example, the URL becomes "http://67.1.2.3:81".   If your ISP changes your IP address periodically, you may wish to use the option provided here to periodically find the new address automatically.

If you want to get a name to use instead of using your IP address when doing a remote connection, you can click on the Get a domain name link.

Advanced

If you choose to enable Authentication, Blue Iris will automatically cause remote users' browsers to prompt them for a username and password.  If they do not match a valid user account, they will be denied access.  Users are configured on the Options/Users page.  If you select to authenticate Non-LAN connections only, users connecting from within your local home/office network will not be prompted, while those connecting from the Internet will be prompted.  The connections status page will show which username was used to authenticate.

Whenever a user is permitted access without a username or password, an Anonymous user will appear on the Options/Users page.  You may edit the privileges of this account as you would the others.

Select the Secure only authentication option in order to use the new login.htm page.  If you un-select this option, Blue Iris will also accept plaintext or "basic" authentication.  Basic authentication may be a requirement for the use of certain third-party add-on software such as TrackIT.

If you use the Allow directory listing option, web users will be able to view the list of files in your Blue Iris web root folder if you don't have a home page.  You may also use this feature to directly access your New and Stored clips folders.  To do this, add /clips/ or /stored/ respectively to your URL, for example, http://mydomain.dyndns.org/clips/.  Note that the trailing / is required.

Use the User limit setting to control the number of users which may login to your web server at any given time.

The List only clips from enabled cameras option will hide video and images from cameras which are either disabled, renamed, or no longer on the system.

Use the Listen/bind to one selected LAN IP option to force the web server to use a specific network interface on your PC.  You may wish to use this to force connections to be made from only wired or wireless sources for example.  Note that if your local IP addresses change, you may need to revisit this page in order to update the LAN IP list.

The Limit IP access box provides basic firewall capability for the web server.  If left blank, or if there are no specific inclusions, all IP addresses are allowed to connect if not specifically excluded.  To add an included IP address or range of addresses, just enter the IP address, optionally preceded by a + (plus).  Use the * character in place of a number as a wildcard.  To add an excluded IP address or range of addresses, precede the address with a - (minus).  Separate multiple addresses with either a comma or a semicolon.  Here are some example:

+192.168.*.*        allow all typical LAN addresses
-58.*.*.*                deny any address beginning with 58.
+68.77.123.1        allow this one specific Internet address

Encoder Profiles

The ActiveX encoder options button allows you to select and configure the video compression technology that will be used for webcasting by the Blue Iris ActiveX control.  This setting does not affect Windows Media or Java/JPEG webcasting--these are configured on a per-camera basis on each camera's Webcasting page.  Here is the encoder options page:

The Quality setting when set at 50% is designed to produce visually lossless output.  You may increase this value to further refine the output or lower it as necessary to reduce bandwidth or hard drive space used.

When the encoder is used for streaming, you should enable the Rate control option for Max bitrate.  This option will insure that the outbound network bandwidth falls below a specified value in order to provide a smooth streaming experience.

You may also select a Maximum keyframe interval, also known as the Group of Pictures (GOP).  When streaming, using a higher value is acceptable as it raises the quality/bandwidth equation.  When recording, however, this value directly affects file seeking (random access) times and efficiency and should be kept relatively low at the expense of using additional storage resources.  B-frames offer further advanced compression technology, at the expense of some output latency (delay).

Under Advanced you may select an encoding Preset.  The "faster" presets will use less CPU, while the "slower" presets will produce a higher quality output. 

Use the Zero frame latency option along with 0 b-frames in order to produce encoder output that is closest to real-time, which may be desirable for streaming.  However if you can tolerate some latency, leaving this option un-checked will produce significantly higher quality output.

HTML Macros

Blue Iris pre-processes all files ending in ".htm" before they are sent.  This is useful if you're using a dynamic IP address (most dial-up networking does) as your server name.  Blue Iris will substitute your server name wherever "%%SERVERNAME%%" appears.  Other available macros include the following:

%%SERVER%% Server name without the HTTP port number appended
%%CAMLIST%% A list of HTML <OPTION> tags containing the available cameras
%%CLIPLIST%% A list of HTML <OPTION> tags describing the clips currently displayed in the Clip List
%%CAMPORT0%% The first camera's webcasting port number
%%CAMNAME0%% The first camera's name
%%THUMBn%% A virtual path to a thumbnail image for the "nth" clip currently displayed in the Clip List
%%CLIPn%% A virtual path to the actual "nth" clip currently displayed in the Clip List

The sample web pages that are installed demonstrate each of the webcasting formats in operation.

Direct image, video and command requests

In addition to serving HTML pages, Blue Iris can also act as a "video server."  There are a number of methods for retrieving images and video from the Blue Iris web server for use on mobile devices, converting a USB camera into a web camera, or for any other purpose.  Here are the paths to these methods:

/image/{cam-short-name}?q=50&s=80 A single JPEG image from a specific camera or group, with optional quality (q) and scale (s) parameters.  Quality is a percentage from 1-100, and scale may be any number >0.
/image/{cam-short-name}?h=100 You may also specify a specific height (h) or width (w) instead of scale.
/mjpg/{cam-short-name}/video.mjpg An M-JPEG stream.  This stream is compatible with Blue Iris's "MJPEG stream request."
/file/clips/{filename}&mode=jpeg&speed=100 An M-JPEG stream of a clip from your New clips folder.  You may include additional subdirectory names in the filename.  The speed parameter is optional, a percentage of normal playback speed.
/thumbs/{filename} A thumbnail image from a specific file in the New clips folder.
/alerts/{filename} A JPEG image from the Alerts folder.
/admin?profile=x Temporarily change the active profile to x.  Use x=-1 to toggle the lock status.
/admin?camera=x&trigger Trigger camera x (short name)
/admin?signal=x Changes the traffic signal state and returns the current state.  x=0 for red, x=1 for green, x=2 for yellow.  This requires admin authentication.
/audio/{cam-short-name}/temp.wav Pull a raw audio stream (MIME type audio/x-wav).
/cam/{cam-short-name}?pos=x Performs a PTZ command on the specified camera, where x= 0=left, 1=right, 2=up, 3=down, 4=home, 5=zoom in, 6=zoom out
/cam/{cam-short-name}?pos=100 Causes a snapshot image to be captured from the specified camera.
/h264/{cam-short-name}/temp.h264 Pull a raw H.264 stream (MIME type video/H264).  This stream will play in a tool like VLC, and may be used in future versions of the ActiveX control.
/h264/{cam-short-name}/temp.ts Pull an MPEG-2 transport stream (MIME type video/MP2T).
/h264/{cam-short-name}/temp.m or .m3u8 Pull a virtual M3U8 file (MIME type application/vnd.apple.mpegurl).  This will play in QuickTime, iPad and the iPhone using the iPhone Live Streaming format.