Installation Guide

Scenic is now available online at http://scenic-app.com. No other installation step is necessary to use this online version.

However, keep in mind that Scenic still requires that both Switcher and Scenic Core be installed and running on the system in order for it to do anything.

If you wish to build and run a local version of Scenic instead, follow the instructions below.

Installation from Source

Keep in mind that Scenic is tested and developed for the Chromium browser. On Ubuntu, you can install it using sudo apt install chromium.

Prerequisites

Name Version Command Description
NodeJS LTS See the Ubuntu distributions Required to build and bundle the source code
H2O HTTP Server latest sudo apt install h2o Recommended server to run and serve Scenic locally

Building steps

git clone https://gitlab.com/sat-mtl/telepresence/scenic.git
cd scenic
make bundle # Build and bundle the app

Local deployment

Once Scenic is built, you need to deploy it to a local HTTP server. If using H2O, you can do so with the following one-liner:

sudo make install

Once deployed, Scenic will be served on http://localhost:8080 and will be accessible from any modern browser.

All additional commands are documented in the development section.

Deployment from a Container

You can build and run the Docker container from source:

docker build -f dockerfiles/h2o.Dockerfile -t scenic:h2o .  # Building
docker run -p 8080:8080 localhost/scenic:h2o  # Running

Usage

First, launch the Scenic Core websocket server with the scenic command.

Second, open Scenic in your browser (Chromium is recommended).