# Getting started

This guide shows how to use TrueConf desktop client applications. TrueConf for Windows is taken as an example.

# Connecting the application to the server

When TrueConf client application is launched for the first time, it will automatically detect a TrueConf Server instance in the local network and display a dialogue window for connecting to it.

Only TrueConf Server 4.5 + instances can be automatically detected.


By default, the application connects to TrueConf Online cloud service.

To switch to a corporate TrueConf Server instance, click the Change button.

In the window that opens, switch to TrueConf Server in the Connect to the server section and enter the IP address or FQDN of your video conferencing server. Click the Connect button.


If the connection is successful, you will see Connected to server.company.com in the Network state string in the upper right corner of the window.

# Signing in

In the authorization window, enter your TrueConf ID (username) and Password. If you don't know your login details, please ask your server administrator to provide you with them.


# Application settings

# Video and audio

In the application window, go to the Settings by clicking on the corresponding button /client/media/gui/settings_button/en.png. After that, select the camera, speakers and microphone in the Audio and Video ( Main settings section).


In the Recording device section, there are two options related to audio processing:

  • Echo cancellation

  • Automatic gain control.

These options are automatically enabled, and they are helpful in most cases. However, if you use a recording device with integrated echo cancellation/AGC mechanisms, we recommend disabling these options in the application to avoid conflicts between algorithms.

For the echo cancellation algorithm to work properly, you can run an audio test and identify a possible delay. To do this, click Estimate at the bottom of the window.


During the testing, you will hear several audio signals from the selected playback device. When the test is successfully completed, the time of delay will be displayed.


You can run the audio test again by clicking the Restart button, which will replace the Estimate button after the first successful testing.

To select the sound notifications you want to receive from the application, go to the category Preferences on the Notifications and sounds tab. There you can also set up pop-up windows with text notifications.


# Background blurring

TrueConf provides background blurring feature. It is available for any computer that meets the general system requirements and can be used for both one-on-one video calls and group video conferences.

The blurred background feature can be useful in a slew of situations, e.g., if you need to focus on the task at hand during meetings. Even if you don't work remotely, office distractions can be a problem.

Besides, this feature will be useful in case of remote learning, as the children's room may look unsuitable due to the clutter or bright posters. By blurring the background, they will feel more comfortable at the meetings.

The background blurring feature may be unavailable if your system does not meet the required performance parameters or is overloaded with CPU consuming processes. Your CPU should also support AVX instructions.

To blur the background, take the following steps:

  1. Go to the Settings → Audio and Video → Main settings section

  2. Check the Blur background box. You will immediately see the result in the preview window.


# Network

In the Settings → Network → Connection section, you can connect to your TrueConf Server instance or TrueConf Online cloud-based service.

If the Suppress direct connection box (disabled by default) is checked, point-to-point video calls will be routed through the server.

To check the list of available servers, click View list.


The Limits and Test sections enable you to adjust your network settings.

# General preferences

You can go to Settings → Preferences → General to allow the application to launch automatically at your operating system startup (enabled by default).


The Sign in automatically checkbox (enabled by default) allows you to connect to the server automatically, without entering your login and password manually each time. The application will store login details for different servers and automatically sign in when you connect to one of them.

If you want to connect to a different server, go to the Settings → Network → Connection menu, enter your server address in the Connect to the server section and press Connect. Please don't sign out from the account on your current server using My profile → Sign out menu. Otherwise you will not be able to sign in automatically the next time you connect to this server.

If the user is inactive for a certain time, Away status is set automatically (in 15 minutes by default).

To change this setting, drag the slider to set your value (from 1 to 60 minutes).


Uncheck the box Set Away status... if you do not want the application to record your activity.

# Visual styles

Go to Settings → Preferences → Visual styles to configure the look of your application.


You can switch your application to a dark mode by choosing Dark theme colour scheme option.


Use Custom option in the Videoarea section to customize the frame color of active speaker window (orange by default).

If you want to change the space between video windows, move the slider in the Videoarea section (0 pixels by default) or set your value in the corresponding field.


Check the box Contacts/chats list compact mode to hide user avatars.


To change the layout background during meetings, go to Settings → Preferences → Visual styles and check the Change the background box. You can choose a standard background or set a custom one by uploading it from your computer.


# Accepting a call

During a call, the application may be minimized, while a video call or conference invitation window will appear on your screen. Click on the Accept button to join.


# Hotkeys

You can control the application using hotkeys. The list of all combinations is available in Settings → More → Hotkeys.


Uncheck the box next to the action name in the list to disable a given keyboard shortcut. To completely disable any combinations in the application, uncheck the box Enable keyboard shortcuts.

# Editing user profile

You can proceed to your profile and edit your personal information:

  1. Click on the avatar icon in the application menu to proceed to your profile

  2. Click on your avatar to change it

  3. Edit your personal information (display name, phone number, etc)

You may not be allowed to edit your personal information if Active Directory/LDAP extension is enabled on your TrueConf Server instance. In this case, please contact your server administrator to edit your profile.

4. Open your personal area in the browser

5. Sign out

6. Change your status (Online/Do not disturb)

7. Set additional status

8. Copy your TrueConf ID (you can use it to share your TrueConf ID with your colleagues)

To change your avatar, click on the avatar icon and select a preferred action:

  • Upload a photo. Select a photo on your PC or on an available network resource and click /client/media/gui/save_avatar/en.png button to save it:

  • Take a photo with your webcam. If you have multiple cameras connected to your PC, press /client/media/gui/change_camera/en.png to select a preferred camera. Click /client/media/gui/take_photo/en.png to save your avatar:

  • Delete your avatar.

# Possible settings options

You can set an additional custom status in their profiles. To set a status, open your profile and click on the Set my status button. Please note that the status field is limited to 256 characters.


# Exiting the application

By default, /client/media/gui/exit_button/en.png (exit button) minimizes the application to tray. You also can change this button action in Settings → Preferences → General. To exit the application, you need to:

  1. Right-click on the application icon in the tray (lower right corner on the screen)

  2. Select Exit.