Evoko Overview Screen

Last updated
Save as PDF

This article explains how to set up the Evoko Overview Screen with your Evoko Home booking system.

The Evoko Overview Screen can be deployed across several large-screen displays within your organization and provides an at-a-glance view of which rooms are nearby, where each room is located relative to the screen, and whether each room is currently booked.

Installing the Evoko Overview Screen

The Evoko Overview Screen server is written as a separate Node.js application from Evoko Home and runs on its own dedicated port that utilizes the Evoko Home API to fetch meeting data. Evoko Overview Screen can be installed on the same server as Evoko Home or on a separate server.

System Requirements

A server running Windows Server 2008 R2 (or later) or Ubuntu.
An accessible application port (default port 4000 TCP).
Access to an Evoko Home server running v2.x on the application port (default port 3000 or 3002).
SSL/TLS certificate to use HTTPS (recommended). HTTP can be used, but is discouraged for accessing the Overview Screen admin portal from anything other than localhost, as Evoko Home admin credentials will need to be submitted to login to the admin portal.

The Overview Screen can be displayed on any device with a modern web browser that can connect to the Evoko Overview Screen server.

Downloading and installing Evoko Overview Screen for Windows Server

Download the latest version of Evoko Overview Screen server for Windows from the Evoko Liso Download Page.
Right-click on the downloaded file and click Run As Administrator.
Select the install location.
Click the ☑ Install Service check box to install Evoko Overview Screen as a background service.
Once the installation completes, click Finish to open the configuration file.

Downloading and installing Evoko Overview Screen for Ubuntu

Download the latest version of Evoko Overview Screen server for Linux from the Evoko Liso Download Page.
Open Terminal. Install Node.js/npm if they are not already installed:

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - sudo apt install -y nodejs

Install Evoko Overview Screen using NPM:

sudo npm install -g evoko-overview-screen-server-v2.*.tgz

Generate the default configuration file:

sudo evoko-overview config

Configure Evoko Overview Screen to run as a service and start on boot:

sudo evoko-overview install sudo systemctl enable evoko-overview-screen

Start the Evoko Overview Screen server:

sudo systemctl start evoko-overview-screen

Edit the configuration file (config.toml)

You will need to edit the Evoko Overview Screen configuration file to connect to your Evoko Home server:

In Windows, open a Command Prompt and enter notepad C:\ProgramData\Evoko\config.toml
In Ubuntu, open Terminal and enter sudo nano /etc/evoko/config.toml

Edit the configuration file as needed:

uri: the address of your Evoko Home server
- Use 'ws://localhost:3000/websocket' if Evoko Home runs on the same host
- Use 'wss://evokohomeserver.tld:3002/websocket' if Evoko Home runs on another host
token: the API token provided by Evoko Home
email/password: if no API token is available, enter the email and password for a Global Admin user
key/cert: if using HTTPS, the paths to the SSL/TLS key (.pem or .key file) and certificate (.pem or .crt file).
- If empty, the Appconnector will check the default directory: liso_files/certificates/server.key and server.crt respectively

After editing and saving the file, you will need to restart the Evoko Overview Screen service:

In Windows, open a Command Prompt and enter net stop evoko-overview & net start evoko-overview
In Ubuntu, open Terminal and enter sudo systemctl restart evoko-overview-screen

Registering an Overview Screen

In a web browser on a display device, navigate to your Evoko Overview Screen server URL (e.g., http://localhost:4000/overview).

If successful, a page will be displayed with a unique screen name for your device.

Using the Evoko Overview Screen admin portal

In a web browser, navigate to the Evoko Overview Screen admin interface (e.g., http://localhost:4000/admin) and log in as a Global Admin.

Screens

This page shows all online and offline Screens registered with Evoko Overview Screen.

Click on the name of a screen to rename it, assign a Layout to that screen, or delete (unregister) that screen.

Layouts

This page allows you to craft Layouts, and shows which Layouts are currently in use.

Click the + New button to create a new Layout, or click on an existing Layout to edit its properties:

Layout Name
Message: the message displayed on the Overview Screen (optional)
Assigned Screens: if the Layout is assigned to any Screens, they will be listed here
Direction: specify whether the Overview Screen should flip between directional arrows and booking information
- Flip Time: how long the screen should hold on direction arrows before flipping to booking information and vice versa
Number of columns/rows: adjusts the layout of the tiles on the Overview Screen
Tiles: this provides a preview of the tiles on the Overview Screen
- Click the name to change the Room assigned to that tile, or select Blank to hide the tile
- Click the directional arrow to rotate the arrow's direction (in 45° increments)
Delete

Settings

This page allows you to toggle the date/time and logo displayed on the Overview Screen.

The Evoko logo is shown by default. You can also upload a custom company logo in PNG format.

This page also provides the URL of the Overview Screen as well as HTML code for embedding the Overview Screen as an iframe.

Logout

Selecting this will immediately log out of the Evoko Overview Screen admin portal.