# Installation and getting started

This guide is intended for Windows, macOS, and Linux users because TrueConf client applications for desktops are cross-platform and have the same features and UI.

If you are just starting to get acquainted with video communication from TrueConf, it is recommended to familiarize yourself with brief instructions on how to start working with the application. Afterwards, you will be able to supplement your knowledge from this documentation as you work more actively with video communication.

# TrueConf desktop client application features

Please note that the features listed below are available when the application is connected to the most recent versions of TrueConf Server or TrueConf Enterprise. If you connect to older versions of the video conferencing server or to the TrueConf Online cloud service, some of the following features may not be available.

For more details, check the comparison table for TrueConf Server and TrueConf Online.

  • Single Sign-On/Active Directory Federation Services (SSO/AD FS) authorization in the application

  • Ability to set up connection via proxy, including the use of system settings and manual configuration

  • Automatic discovery of available servers

  • Enjoy 4K (Ultra HD) video calls and conferences with a frame rate of 60 fps

  • Call VoIP users, landline and mobile phone numbers and send DTMF commands

  • Call SIP/H.323 and RTSP devices

  • Point-to-point video calls can be run directly between the users bypassing the server

  • Conferences with up to 2000 participants

  • Video communication modes: one-on-one call (point-to-point) and different types of conferences – all on screen, video lecture, smart meeting, moderated role-based conference

  • Ability to organize events with simultaneous interpretation which makes it possible for users to select one of the audio tracks with the required language

  • Hold both private video conferences and public webinars that can be joined by guest participants

  • Schedule conferences, create virtual rooms, and send email invitations to meeting participants

  • Quick call-to-conference escalation

  • Create conferences protected from unauthorized connections with a PIN

  • Change the PIN or identifier of an ongoing conference if you are the owner

  • Start meetings instantly and save their templates

  • Add and remove participants while the conference is in progress

  • Control participants’ cameras and microphones, change devices or adjust microphone sensitivity

  • Mute microphones for all participants except the selected one

  • The owner can lock an ongoing conference from new participants

  • Select and manage multiple conference participants

  • Move participants to the waiting room to manage access to a conference

  • Set mandatory registration for webinar guests

  • View detailed analytics about a conference (available only to the owner)

  • Highlight active speakers in the video window layout with a customizable color frame and set up microphone sensitivity level

  • Conference moderators can set a mandatory video layout for all participants, as well as individual layouts for each user, including SIP/H.323 endpoints and browsers

  • Configure your own video layout

  • Set the background and watermark for the video layout

  • Automatically enlarge speakers in a meeting

  • Ability to recognize a document or whiteboard in the transmitted video (it is possible to cut out people out of the frame)

  • Remote desktop control

  • PTZ camera control: both your local camera (via UDP/RTP/Q.922/H.224/H.281 protocols) and remote cameras of other participants

  • Meet both with guests and users registered on TrueConf Server

  • Join conferences without signing in to the application

  • Attendees can push to talk or send a request to become a speaker in role-based conferences, while moderators can appoint or remove speakers from the podium

  • Switch between a smart meeting and moderated role-based mode without interrupting the conference

  • Take polls or share reactions in conferences

  • Show slides and images in a separate media stream to all participants, including in-browser connections and SIP/H.323 endpoints over H.239/BFCP protocols

  • Share your desktop or application windows (the self-view can be displayed right next to content so that it could be visible in video recordings, streams and on the devices that do not support H.239/BFCP protocols)

  • Flexible customization of the content sharing scene: background removal (only the speaker will be displayed), it is possible to select the position and size of the self-view

  • Annotate over the shared screen

  • Stream audio when sharing content or showing slides

  • Stream video files to a conference

  • Stay focused on your meeting when sharing your content or switching to other windows thanks to a customizable widget with quick conference controls

  • Control how the recording of an ongoing conference will be saved on the server and download the video file when this meeting is over (available only to the owner)

  • Video recording of calls and conferences (it is possible to select the video format, resolution and the folder where the file should be saved)

  • Ability to select which of the users will be allowed to record your video

  • Built-in player for video recordings

  • Full address book support (adding and deleting contacts and groups, editing contact information, searching and blocking contacts)

  • Exchange messages and share files in personal and group chats. Your messages will be delivered even if your partner is currently offline

  • Pin important chats

  • Archive and chat folders: store outdated conversations in the archive without deleting them and organize chats into separate folders

  • Configuration of automatic file downloading

  • Built-in tool for viewing videos, images and PDF files in a text chat

  • View ODP, ODT, ODG, ODS, ODF files directly in the application (the corresponding office suite has to be installed)

  • Create group chats that can be escalated into a group conference with all chat participants in one click.

  • Chat history, including group chats of the meetings that have already finished

  • Appoint chat moderator

  • Transfer chat ownership to another participant

  • Configure display settings for chat notifications

  • Show/hide previous chat history from new participants

  • Disable notifications from private and group chats

  • Compress images sent to a chat if necessary

  • Text formatting in chats

  • Built-in spell check

  • Ability to check which of chat participants have read your message

  • Ability to share a contact in a private or group chat

  • Enjoy built-in algorithms of echo/noise cancellation and automatic gain control (AGC)

  • User status tracking (it is possible to enable notifications that will be displayed when certain contacts change their status to online)

  • Set a virtual background (select one of the default backgrounds or add a custom one)

  • Blur the background

  • Use face tracking during meetings (available for one and multiple participants)

  • Optional network speed limitation templates or manual settings

  • Try built-in tools for testing the quality of server connection

  • Change app notification settings

  • Configure the main menu: choose the elements to be displayed and select how they should be displayed during calls and conferences

  • A wide variety of hotkeys for managing app features (hotkeys can be remapped if necessary)

  • Power-saving mode with two options available: balanced and maximum resource saving

# Installing the application

Before installation, make sure that your computer and network connection meet our system requirements (these requirements depend on the expected video quality)

To get started with TrueConf client application, download it from the guest page of your TrueConf Server instance (please contact your server administrator to find out its URL address) or from our official website:

Before using the client application, make sure that your operating system and graphics card driver is up to date. Please note that we recommend downloading the drivers from the manufacturer's official website (Intel (opens new window), Nvidia (opens new window), AMD (opens new window)).

# Signing in

Depending on the settings of the video conferencing server to which you will connect and your location (e.g., the corporate network or the Internet), you may have to use one of the following authorization options:

When users connect to a corporate video conferencing server like TrueConf Server or TrueConf Enterprise, they can take advantage of multiple login, which allows them to sign in from multiple devices at the same time (e.g., a laptop and a smartphone).

If a user account is disabled on the side of TrueConf Server, the authorization will not be completed, and the corresponding message will be displayed. In case of such problems, please contact your server administrator.

# Authentication with the login and password.

To log in with your login and password, click the Sign in button:

/docs/client/media/first_start/en.png

Choose the login option in the pop-up window:

  • Corporate user account for authentication on the corporate server.

  • Cloud user account for authentication on the TrueConf Online cloud service without connecting to the corporate server.

Here, we will discuss authentication with the Corporate user account.

/docs/client/media/corp-or-cloud/en.png

Enter your corporate email or TrueConf ID (login). Click the Next button so that the application could try to automatically detect the server and connect to it.

/docs/client/media/login/en.png

If you choose to sign in to the cloud service, after entering your email or TrueConf ID, you will need to check your mail box for the authentication code.

If the application cannot automatically connect to the selected server, you will be asked to double-check your email or enter the server address manually. Click the button Enter server address manually which will open the menu where you can enter the address in the corresponding field or select one of the detected servers. The list of detected servers will also include the servers you previously connected to:

/docs/client/media/server_address/en.png

Choose the required server from the list or enter its address in the field, then click Connect.

# SSO authorization

SSO (Single Sign-On) is a technology that allows a user to sign in to multiple applications or web services with the same login information.

In this case it will enable users to sign in to TrueConf client application without entering the login and password if they have already signed in to the operating system. However, two requirements have to be met:

  1. You will need to be authorized in the OS with the domain account (specified on the LDAP server).

  2. TrueConf Server to which you are connected should be integrated with the LDAP server from part 1.

This feature is available not only on Windows (where Active Directory is used as the directory service), but also on Linux.

If these conditions are met, you will be automatically signed in to TrueConf application once it is started.

# Two-factor authentication via AD FS, Keycloak, etc.

  1. Click the Sign in button on the home page of the application:

    /docs/client/media/sign-in-but/en.png
  2. Click the Corporate user account button:

    /docs/client/media/corp-or-cloud/en.png
  3. Next, either enter the server address manually, as we showed earlier, or the application will automatically connect to the required server, if this feature is enabled by the administrator.

  4. Click the /docs/client/media/gui/adfs-auth-btn/en.png button to authenticate via AD FS.

    /docs/client/media/adfs-auth/en.png
  5. The AD FS authorization window will be displayed on the screen. Type your domain login and password (contact the server administrator to receive them). Next, click Sign in.

    /docs/client/media/adfs_auth_win/en.png

Once you have signed in, your user account information will be displayed in TrueConf client application.

In addition to AD FS, your company may use another provider for implementing two-factor authentication, such as Keycloak.

/docs/client/media/keycloak/en.png

The general application login scheme described for AD FS will remain the same when using another provider.

# Offline mode

You will be able to sign in and use some of the application features in offline mode.

If connection with the server is lost and you have signed into the client application before, you can still use some application features in offline mode. For example, you can view the history of received messages or write a message that will be sent as soon as connection is restored. In offline mode, you will be unable to make calls, exchange messages, and upload or download files.

When connection to the server is restored, you will be able to continue working in online mode.

# Multi-login

You will be able to sign on multiple devices with the same account. In this case:

  • When using the application on multiple devices, you won't have to sign out from your profile on the second device

  • Make calls/participate in different conferences from different devices at the same time

  • Reconnection to calls will be available simultaneously on all devices.

Multiple login is supported on all platforms, including mobile devices (iOS, iPadOS, Android), PCs running Windows, macOS, and Linux, smart TVs (Android TV), and browsers.

# Joining a conference as a guest

When the application is run for the first time, you will see a window offering you a choice between two buttons: Sign in or Join conference.

/docs/client/media/first-start/en.png

You can join a public conference (webinar) without authenticating on the video conferencing server. To do it, click the Join conference button and enter your name, which will be displayed in the participant list:

/docs/client/media/auth-guest/en.png

In this window, you can also choose:

  • Your microphone

  • Audio output device (headphones or speakers)

  • Video camera.

More advanced application settings are available after clicking the /docs/client/media/gui/sett_auth/en.png button. For more information about the Settings menu, refer to the corresponding part in this documentation.

# Exiting the application

By default, /docs/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 system tray (bottom right corner of the desktop).

  2. Select Exit.

/docs/client/media/tray_exit/en.png