Room Service

Conventions

The table below describes the notation used for the command line syntax in TrueConf Room Manager and TrueConfRoomService.

Notation	Description
`Text without square, curly, or round brackets`	Elements that must be entered exactly as they appear.
`[Text inside square brackets]`	Optional argument.
`{Text inside curly braces}`	Required argument.
`...`	Unlimited number of parameters in the argument.

Hierarchy of Room Service

TrueConf Room Service service/daemon
|
|→ TrueConf Room Manager
|
|→ TrueConf Room
|
|→ scripts

TrueConfRoomService service/daemon:
- starts/checks/stops the scripts and programs set in the JSON file;
- In Windows, it closes/reopens specified applications when the system goes into sleep mode.
Room Manager opens/closes the web manager and displays/saves settings.

Interaction between Room Service and Room Manager:

up (Room Manager -> Room Service): SCM/Posix signals;
down (Room Service -> Room Manager): ProcessController signals and open/close by process ID.

The difference in the start of Room Manager/Room and scripts:

scripts are automatically ended when the process is terminated and their presence is not checked except before the launch/shutdown;
Room Manager/Room is ended similarly according to the schedule: the timeout for shutdown is about a few seconds.

TrueConfRoomService Commands

install

In Windows, this command will be used to register the service under the specified path and initialize it.

In Linux, this command will launch the TrueConfRoomService daemon.

Rules:

it is not necessary to specify the path to Room Manage as the argument [path_to_RoomManager]. It may be needed only for some unstandard locations of Room Manager.
if this command is run without an argument, Room Manager is first searched in the TrueConfRoomService folder; then it is searched in the default installation folder.

Syntax:

install [path_to_RoomManager]

Example for Windows:

C:\Program Files\TrueConf\Room>TrueConfRoomService.exe install

Example for Linux:

trueconf-room-service install

uninstall

In Windows, this command cancels TrueConfRoomService registration under the specified path and deinitializes it.

In Linux, it stops the TrueConfRoomService daemon.

Syntax:

uninstall

Example for Windows:

C:\Program Files\TrueConf\Room>TrueConfRoomService.exe uninstall

Example for Linux:

trueconf-room-service uninstall

Command Line Keys for Room Manager

--pin

Authorize in the web interface with the specified PIN.

Rules:

The following characters can be used for PIN: abcdefghijklmnopqrstuvwxyz0123456789
PIN can be up to 8 characters.

Syntax:

--pin={some_pin}

Example for Windows:

C:\Program Files\TrueConf\Room>TrueConfRoomManager.exe --pin=d5f6g8

Example for Linux:

trueconf-room-manager --pin=d5f6g8

--monitor

Select the screen where Room Manager will be displayed.

Rules:

The argument must be the screen number

Syntax:

--monitor={monitor_index}

Example for Windows:

C:\Program Files\TrueConf\Room>TrueConfRoomManager.exe --monitor=1

Example for Linux:

trueconf-room-manager --monitor=1

Room Manager Command Flow

If a single line includes multiple commands, only the first command is processed while others will be ignored.

Example:

C:\Program Files\TrueConf\Room>TrueConfRoomManager.exe --start --settings --stop --restart --stop

--start will be executed

C:\Program Files\TrueConf\Room>TrueConfRoomManager.exe --settings --restart

--settings will be executed

Room Manager Commands

--settings

An option in the Room Manager command line. It opens the settings window when Room Manager starts.

Rules:

If no instance of Room Manager is running, it starts and displays the settings window.
If an instance of Room Manager is already running, the second copy starts and sends a command to the instance that had been opened previously. The command requests opening the settings dialogue window. The first copy opens the dialogue window.

Syntax:

--settings

Example for Windows:

C:\Program Files\TrueConf\Room>TrueConfRoomManager.exe --settings

Example for Linux:

trueconf-room-manager --settings

--start

A command line option for Room Manager that allows launching specified applications via the TrueConfRoomService service/daemon and starts monitoring them.

Rules:

On Windows, Room Manager starts and sends a command to TrueConfRoomService to begin displaying and monitoring the specified applications, then it closes.
On Linux, Room Manager starts and launches the TrueConfRoomService daemon, then closes.

Syntax:

--start

Example for Windows:

C:\Program Files\TrueConf\Room>TrueConfRoomManager.exe --start

Example for Linux:

trueconf-room-manager --start

--stop

The option for the Room Manager command line. This option ensures that the selected applications are stopped by TrueConfRoomService and no longer tracked.

Rules:

TrueConfRoomService daemon/service has to be started.
Room Manager starts and sends the command to TrueConfRoomService. The command requests that certain applications should no longer be displayed and tracked. Then, Room Manager is closed.

Syntax:

--stop

Example for Windows:

C:\Program Files\TrueConf\Room>TrueConfRoomManager.exe --stop

Example for Linux:

trueconf-room-manager --stop

--restart

The command line option for Room manager. This option is needed for stopping or starting the selected application with the help of TrueConfRoomService daemon/service.

Rules:

Room Manager launches and requests TrueConfRoomService to stop and start the selected applications. Then, Room Manager is closed.

Syntax:

--restart

Example for Windows:

C:\Program Files\TrueConf\Room>TrueConfRoomManager.exe --restart

Example for Linux:

trueconf-room-manager --restart

See also:

Additional video stream functionality