kiosk-browser

A generic Electron-based kiosk-mode browser that runs our vxsuite app frontends in production.

Build & Install

1. Install NodeJS and Yarn.
2. Install native package dependencies with make install.
3. Build a Debian/Ubuntu package with make build.
4. Install it with sudo dpkg -i dist/kiosk-browser_*.deb.
5. Run with the URL you want to visit as a CLI argument (e.g. kiosk-browser https://example.com/) or with an environment variable (e.g. KIOSK_BROWSER_URL=https://example.com/ kiosk-browser).

Kiosk Page API

Web pages loaded by kiosk-browser have an extra API accessible via the global kiosk object.

We're increasingly moving away from these APIs in vxsuite, but a few last uses remain.

Debugging

First, check the command-line help:

$ kiosk-browser --help

If something isn't working as you'd expect it to, try running with debug logging:

$ DEBUG=kiosk-browser:* kiosk-browser https://example.com/

Development

If you're working on a bug fix or feature for kiosk-browser, here's how to build and run it in development:

1. Install NodeJS and Yarn.
2. Install native package dependencies with make install.
3. Run with yarn start. Changes will not automatically be picked up, so just Ctrl-C the yarn start and run it again.

kiosk-browser has a number of command line arguments you can use if you want the permissions and print config to mimic production while also having access to devtools. You probably want to run kiosk-browser locally with the following command:

DEBUG=kiosk-browser:* \
  DISPLAY=:0 \
  KIOSK_BROWSER_ALLOW_DEVTOOLS=true \
  KIOSK_BROWSER_FILE_PERMISSIONS='o=http://localhost:3000,p=/**/*,rw' \
  KIOSK_BROWSER_URL=http://localhost:3000 \
  yarn start

License

All files are licensed under GNU GPL v3.0 only. Refer to the license file for more information.