Scenic is now available online at http://scenic-app.com. No other installation step is necessary to use this online version.
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.
|NodeJS||LTS||See the Ubuntu distributions||Required to build and bundle the source code|
|H2O HTTP Server||latest||
||Recommended server to run and serve Scenic locally|
git clone https://gitlab.com/sat-mtl/telepresence/scenic.git cd scenic make bundle # Build and bundle the app
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
First, launch the Scenic Core websocket server with the
Second, open Scenic in your browser (Chromium is recommended).
- If you are running Scenic locally, open http://localhost:8080 in your browser. (
- If you wish to run the online version of Scenic (no installation required), open http://scenic-app.com in your browser.
- For optimal support of touchscreens, consider launching Chromium with touch-event option. (
chromium-browser --touch-events http://localhost:8080).