Kiosk Options

The optional kiosk section of the configuration file controls which user input methods, remote-control groups, and utility pages are available. Most options default to true; set an option to false to disable that capability.

These settings are useful when Television Simulator is installed as a public display, dedicated television, exhibit, or other controlled installation. For browser and operating-system setup, see Running as a Kiosk.

Example

kiosk:
  keyboardControls: true
  touchControls: true

  pictureControls: false
  mediaControls: true
  volumeControls: false
  channelControls: false
  infoControls: false
  navigationControls: true
  powerControls: false
  remotePairing: false

  examples: false
  setup: false
  help: true

  fullscreen: true
  menuBar: false
  debug: false

Input methods

Option	Default	Description
`keyboardControls`	`true`	Enables all keyboard shortcuts. When `false`, TVS does not register keyboard controls, regardless of the individual control-group settings below.
`touchControls`	`true`	Enables TV-screen touch gestures and the press-and-hold touch menu. This does not disable the separate Web Remote page.

Control groups

Control-group options determine which groups are available through the applicable built-in controls. They also control which sections are shown on the Web Remote.

Option	Default	Description
`pictureControls`	`true`	Allows picture-effect and screen-scaling controls, including resetting picture settings.
`mediaControls`	`true`	Allows Play, Pause, Stop, Fast Forward, and Rewind commands used by applications such as the Audio Player and Video Player.
`volumeControls`	`true`	Allows volume and muting controls. It also controls volume swipe gestures when touch controls are enabled.
`channelControls`	`true`	Allows channel entry and channel up/down controls. It also controls channel swipe gestures when touch controls are enabled.
`infoControls`	`true`	Allows the Info control.
`navigationControls`	`true`	Allows Menu, Guide, Home, Back, directional navigation, Select, and the Red, Green, Yellow, and Blue application buttons.
`powerControls`	`true`	Allows the TV power control.
`remotePairing`	`true`	Allows the built-in remote-pairing control and QR-code screen to be opened. To disable the Web Remote service itself, set `remote.enabled: false`.

Utility pages

Option	Default	Description
`examples`	`true`	Allows navigation to the configuration examples page.
`setup`	`true`	Allows navigation to the Setup page.
`help`	`true`	Allows navigation to the Help page.

Host options

These options are primarily consumed by standalone or kiosk hosts. Support can vary when TVS is opened directly in a normal web browser.

Option	Default	Description
`fullscreen`	`true`	Requests that the host start TVS in full-screen mode. Browsers may require user interaction or command-line kiosk configuration before allowing full-screen mode.
`menuBar`	`true`	Controls whether a host-provided menu bar is shown.
`debug`	`false`	Enables host-provided debug flags and tools.

The keyboard commands belonging to each group are listed on the Keyboard Shortcuts page.