Using the client



The Bluecherry Client lets you watch live and recorded video from your Bluecherry server. It is a cross-platform application that runs on Android, iOS, Windows, macOS, and Linux.

Refer to README.md for installation instructions.

You will need a Bluecherry server to use this application. You can buy a license from the Bluecherry website.

These steps will guide you through easily connecting to your Bluecherry server. You can add as much servers as necessary. The steps are similar for all platforms.

1. Enter the hostname or IP address of the Bluecherry server. The default login and password for new installations is Admin and bluecherry. You can optionally click Use default to have this information automatically entered for you.

Click Next to connect.

2. You can optionally change some settings for the server, such as the streaming type, RTSP protocol, and rendering quality.

You can optionally leave these as they are. Click Finish to add the server.

3. If the server was successfully added, you will be able to see the server in the server list and view the cameras.

Click Finish to close the process.

After your server is added, you will be redirected to the camera list. You can view the live video from the cameras by clicking on them or by dragging them to the layout.

You can repeat this process or any camera or DVR that you have listed on the left side. Note: It’s possible to connect as many devices together as you need, and mix and match the videos in different layouts.

The PTZ feature allows you to control the pan, tilt, and zoom of a camera. To enable it, click on the PTZ button on the camera tile.



You can press and move the mouse to control the camera.

You can perform the following movements:

The PTZ movements are scheduled and will be executed after the previous movement is completed. Depending on the speed of the internet connection, you can experience minor delays between the movements and the camera response.



The matrix view is a feature that allows you to zoom into a camera. This is useful for multicast streams. This works better with cameras with larger resolutions.

To enable it, go to Settings -> Updates -> Beta Features -> Matrix view zoom.

You can create layouts to organize the cameras. You can add cameras to the layout by dragging them from the camera list to the layout.

The multiple layout allows you to view as many cameras as you want in a grid. The grid will adapt to the number of cameras you add.

The compact layouts creates a 2x2 grid with sub 2x2 grids. This is useful for viewing a large number of cameras in a small space.

You can enable the cycling to change the layouts automatically at a given interval (defaults to 30 seconds). This is useful for monitoring a large number of cameras.

You can add external streams to the layout. This is useful for adding streams from other sources, such as webcams, IP cameras, or other Bluecherry servers.

To add an external stream, click on the Add external stream tile and enter the stream URL:

External streams are added to the External Stream layout.

You can open the app from a configuration file. This is useful for opening the app from a web browser or from a file manager. The configuration file is a .bluecherry file that contains the devices data.

Here is an example of a configuration file:

You can open the app from the configuration file by double-clicking it and opening it with the Bluecherry Client.

Additionally, you can add overlays to the video by adding the following sections to the configuration file:

The overlay can be edited from within the app:

Press Finish to add the stream to the layout.

The events section allows you to view the events that were recorded by the server. You can view the events by clicking on the Events History tab.

Select the camera you want to view the events and click on the Filter button. You can filter the events by date range.

The timeline of events allows you to view the events in a timeline. This is useful for quickly finding events. You can filter the events by date.



You can download the events by clicking on the Download button. To see the downloaded events, click on the Downloads tab.