Kiosk Mode Set Up

The following is instructions for setting up kiosk functionality on a Linux machine, assuming the repository has already been cloned

Important Note: The kiosk script (deployment/start-scribear-kiosk.sh) has been updated to lock down keyboard shortcuts (such as Ctrl+W, Alt+Tab, etc.) when the Chrome Browser opens. Therefore, there is no way to exit/leave from the kiosk browser other than to shut down and restart the machine completely.

For best practices on a Linux machine:

• Users

  • Have two users on the machine, with one having root/sudo level access
  • The user with root level access will be the admin user to make any changes to the machine and its files (system level and user level)
  • The user without root level access will be the user that runs the locked down kiosk browser, so files will not be accessible from this user

• Adding to user auto-start script

  • On the user account without admin access, run:

  mkdir -p ~/.config/autostart
  nano ~/.config/autostart/kioskmode.desktop
  

  • Paste the following code into ~/.config/autostart/kioskmode.desktop

  [Desktop Entry]
  Type=Application
  Name=ScribeAR Kiosk
  Exec=/path/to/start-scribear-kiosk.sh
  Hidden=false
  X-GNOME-Autostart-enabled=true
  Terminal=true
  NoDisplay=false
  Comment=Start ScribeAR in kiosk mode
  

This should be set up to run kiosk mode on your Linux machine. To run kiosk mode, log into the kiosk user and the start-scribear-kiosk.sh script should run automatically.