kiosk: A JavaScript repository from ezsoftware

#Chrome Kiosk

Basic kiosk packaged application. Allows any URL to be loaded as a fullscreen kiosk in Google Chrome or Chrome OS, also disables device sleep mode while app is running.

##Features

###System

Launches a specified URL full-screen at all times.
Device power-saving (sleep mode) disabled
Can be locked into-single app kiosk on managed Chrome devices.

###Interaction

Option to hide cursor
Option to disable context menu
Option to disable image dragging
Option to disable touch highlighting
Option to disable text selection

Caveat: these interaction adjustments will only be applied once your content is fully loaded. If you have a multi-page application, the cursor, etc. may be enabled on each page load until the content is fully loaded. Recommended solution is to develop content as single-page (AJAX) application and/or use the following CSS:

*{
  cursor:none;
  -webkit-tap-highlight-color: rgba(0,0,0,0);
  -webkit-touch-callout: none;
  -webkit-user-select: none;
  user-select: none;
}

and javascript:

window.oncontextmenu = function(){return false};
window.ondragstart = function(){return false};

###Local Administration

Setup can be accessed via keystroke (CTRL+A) and administer-configured username/password.

###Remote Administration

On desktop operating systems basic configuration as well as application restart options are available remotely. See "Known Limitations" for details on ChromeOS support.

###Inactivity Reset

Allow content to be reset after a administrator-specified period of inactivity.

###Daily restart

Application can be completely restarted at an administrator-specified time once per day.

###Remote Schedule Server

Accepts a URL to a JSON feed for a content schedule. If no item is currently scheduled, the default content (specified by the Content URL on Kiosk setup page) is used. Default content will be overridden by scheduled items. Schedule URL is polled every 15 minutes. Schedule should be formatted according to (a simplified version of) the format provided by Chrome Sign Builder (exported schedules from Chrome Sign Builder are currently supported without support for screen position, repetition or display settings):

{
  "schedule": {
    "Value":  {
      "items": [
        {
          "content": "http://www.zebradog.com",
          "end": "Tue Jul 14 2015 12:30:00 GMT-0500",
          "start": "Tue Jul 14 2015 09:30:00 GMT-0500",
        },
        {
          "content": "http://www.google.com",
          "end": "Tue Jul 15 2015 12:30:00 GMT-0500",
          "start": "Tue Jul 16 2015 09:30:00 GMT-0500",
        }
      ]
    }
  }
}

####Note:

Remote schedule server must have CORS headers set or the Allow-Control-Allow-Origin:* Chrome extension can be installed to allow access. JSONP is not an option since scripts from arbitrary domains cannot be executed inside Chrome extensions.

###Auto-start

On ChromeOS devices: Using managed devices and setting Kiosk application to start in Kiosk mode is the recommended solution. On Windows and OSX: From chrome://apps/ right click on "Kiosk" and "Create shortcut" then copy this shortcut into the startup folder (Windows) or add to login items (OSX). Linux: Likely similar to Windows and OSX, untested.

##Support

This product is maintained by ZEBRADOG and provided without warranty or guaranteed support. If you need a bug fix please check that it has not be reported and submit details here: https://github.com/zebradog/kiosk/issues Patches and new features are released at our convenience. If you need a bug fix or new feature on a specific schedule, please send details to support@zebradog.com for a quote.

##Known Limitations

##Changelog

v5.5.1
- Fixed bug: users on 5.4.0 with scheduling enabled experience rapid polling upon upgrade to 5.5.0.
v5.5.0
- Fixed bug with switching scheduled content
- Added ability to set schedule polling interval
v5.4.0
- Added remote schedule server support
- Added option to hide cursor
- Added option to disable context menu
- Added option to disable image dragging
- Added option to disable touch highlighting
- Added option to disable text selection
v5.3.4
- Fixed bug with restart scheduling
v.5.3.3
- Fixed bug with reset/restart combo.
v.5.3.2
- Optional webcam/mic access added.
v.5.3.1
- Prevent inactivity reset via console.log("kiosk:active") in content page.
v.5.3.0
- updated to Materialize v0.96.1
- added local administration
- added daily restart
- added inactivity reset
v.5.2.1
- auto-restart on content crash or unresponsive
v.5.2.0
- added remote administration
- remote restart for ChromeOS devices in kiosk mode
- skinned with Materialize
v5.1.2
- automatically attempt to reconnect to content if connection broken
v5.1.1
- fixed 1/5 screen fullscreen bug on Windows 8
v5.1.0
- started using proper semver
- added demo link
v5.0
- added support for offline use
v4.0
- prevent system sleep (previously only prevented display sleep)
v3.0
- cleaned up design files
v2.0
- added branding
- cleaned up interface
- switched to setup page from key-combo options page
v1.0
- initial draft version

ezsoftware/kiosk