Using the local.cfg File to Configure Custom Settings for the Windows Wall Client

Support Note
Your experience can be streamlined to be consistent, whether using Bluescape on a large-format display, desktop, or web browser. The legacy Wall client is no longer available and will not be maintained. Learn How to Download and Install the Bluescape Desktop Application today and experience the upgrades first-hand.

If you prefer to configure Bluescape on a large format device, read how to Install the Bluescape Native Application on a Large Format Touch Display.

The local.cfg file allows you to modify the default configuration settings that customize the functions and features available on a Windows Wall. Among other things, the file allows you to change default security settings - like timeout limits - to conform to the requirements of your company’s security protocols.

What to Include in the local.cfg File

The local.cfg file you save to Bluescape only needs to contain the specific settings you are changing. There are several configuration settings that you can change, and when only changing one, the local.cfg file only needs to contain a single line.

For example, if the only change you want to make to the default configuration settings is to increase the timeout_session value from the default 3600 seconds to a new value of 7200 seconds (two hours), create a local.cfg file containing only the following line:

  • timeout_session = 7200;

Create the local.cfg File

The local.cfg file is not installed by default; you must create and save it manually.

To create the local.cfg file:

  1. Click the Windows icon in the bottom left corner of your screen.
  2. Search for and open Notepad. Do not use word processing applications like Word or Wordpad, as these applications add metadata to the underlying content. This metadata causes problems when Bluescape tries to read the local.cfg file.
  3. Jump to the end of this topic and copy the line or lines of the sample configuration file you want to modify. For example:
    • enable_start_workspace = true;
  4. Paste the text into the Notepad file you opened in Step 2 above. Each line must be on a separate line.
  5. Modify each of the settings you want to change.

Save local.cfg

After you finish modifying the file, you must save the file to Bluescape with the correct extension: .cfg rather than .txt.

  1. Select File > Save As.
  2. On the Save As screen that appears, navigate to c:\ProgramData\Bluescape.
  3. In the File name field, type: local.cfg
  4. Select Save.

Restart the Application

For the local.cfg settings to take effect, you must restart the Wall application.

To restart a Windows Wall:

  1. Exit any workspace you are in so that you are on the default blue screen that displays Start New Workspace and Create Whiteboard options.
  2. In the bottom left of the screen, click the Quit button.
  3. On the Quit Bluescape pop-up screen that appears, click the Yes button.
  4. Restart Bluescape. Your new configuration settings are then in effect.

You’ve successfully customized your Windows Wall.

Configurable Settings Within the local.cfg File

Note: Changes made to the settings in the local.cfg file override the default Bluescape settings.

The following settings can be copied and pasted on separate lines into the local.cfg file. The settings can then be changed:

timeout_session = 3600;

The amount of time before a Wall is signed out of a workspace. The default is 3600 seconds (one hour). This setting is ignored if the Wall is in Presentation mode.

enable_whiteboard = true;

Set to true to allow users to create whiteboards. Set to false to hide this functionality. By default, this is set to true.

enable_start_workspace = true;

Set to true to enable the Start New Workspace button on a Wall. When enabled, users can create a temporary workspace on the Wall and save it. By default, it is set to true.

enable_home_workspace = true;

Set to true to allow users to set a specific workspace as the Home workspace. By default, it is set to true.

enable_quit = true;

Set to false to hide the Quit button from the Bluescape Enterprise for Windows lobby screen. By default, it is set to true.

Where to Next?

Not what you were looking for? Reply below or Search the community and discover more Bluescape.

1 Like

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.