Device

1. Keep Screen On

Enable this option to keep your device awake (no screen timeout).

Useful if you have a kiosk application that should always remain active.

Default: false

2. Rotation

Select one of:

For more details, refer to Android's official documentation for R.attr.screenOrientation.

Default: Auto

3. Brightness

Set the app window brightness from 0 (very dim) to 100 (very dark).

Use -1 to disable (i.e. the system default brightness will be used).

Default: -1

4. Allow Camera

Set to true to give WebView access to your device's camera.

You will need to grant the CAMERA permission, which is required for the WebView's RESOURCE_VIDEO_CAPTURE feature.

Default: false

5. Allow Microphone

Set to true to give WebView access to your device's microphone.

You will need to grant the RECORD_AUDIO permission, which is required for the WebView's RESOURCE_AUDIO_CAPTURE feature.

Default: false

6. Allow Location

When enabled, websites can request the device's location.

You can choose to request precise location (FINE) or approximate location (COARSE).

For more information, refer to location/permissions#accuracy.

You will need to grant either ACCESS_FINE_LOCATION or ACCESS_COARSE_LOCATION, required for the WebView's GeolocationPermissions.

Default: false

7. Allow Notifications

Set to true to allow Webview Kiosk to send notifications. For example, this will allow the MQTT notify command to create alerts.

You will need to grant the POST_NOTIFICATIONS android permission.

Please note that for foreground services, e.g. when using lock task mode kiosk-launch or MQTT, the notification will always be created irrespective of this setting. You can disable notifications at the device level if you do not want them.

Default: false

8. Back Button Hold Action

Customise the behaviour when the back button is held down (long pressed).

Default: Open Kiosk Control Panel

9. Custom Unlock Shortcut

Provide a custom keyboard shortcut using a modifier key (CTRL/SHIFT/ALT/META) in combination with another standard key to unlock/unpin the application.

For example, CTRL+1.

This is useful for devices with no navigation buttons on screen and instead has a physical keyboard connected.

Default: (blank)

10. Custom Auth Password

Specify a custom password to protect your settings or when unlocking from the kiosk state.

For user-owned devices that utilises screen pinning, this will only work if you are using an unlock method provided by the app.

Device-level unpin methods (e.g. gestures/holding overview + back button simultaneously) will bypass this setting. To enhance security, please refer to the security documentation.

Leave this setting blank to use your device's biometrics or credentials.

Default: (blank)

11. Unlock Auth Requirement

This setting only applies to in-app unlock methods, e.g. when unlocking using Kiosk Control Panel or Custom Unlock Shortcut.

For user-owned devices without lock task mode, the device will auto-lock when unpinning, which is outside the control of Webview Kiosk.

Default: Default

12. Block Screen Capture

Prevent screenshots, screen recording and content previews in Recent Apps. This is done by setting the FLAG_SECURE window flag.

For more information, see Android Fraud Prevention: Secure Sensitive Activities.

Default: false

13. Block Volume Keys

Disable the volume control buttons, specifically:

• KEYCODE_VOLUME_UP
• KEYCODE_VOLUME_DOWN
• KEYCODE_VOLUME_MUTE

Default: false

14. Device Owner

For more information about Device Owner, see the Security documentation.

14.1. Lock Task Features

Webview Kiosk The settings below are extracted from the official documentations:

• Lock Task Mode -> Customise UI
• DevicePolicyManager#LOCK_TASK_FEATURE_BLOCK_ACTIVITY_START_IN_TASK

Feature	Description
Show Home Button	Shows the Home button. Enable for custom launchers—tapping an enabled Home button has no action unless you allowlist the default Android launcher. LOCK_TASK_FEATURE_HOME
Show Overview Button	Shows the Overview button (tapping this button opens the Recents screen). If you enable this button, you must also enable the Home button. LOCK_TASK_FEATURE_OVERVIEW
Enable Global Actions	Enables the global actions dialog that shows when long-pressing the power button. The only feature that's enabled when setLockTaskFeatures() hasn't been called. A user typically can't power off the device if you disable this dialog. LOCK_TASK_FEATURE_GLOBAL_ACTIONS
Enable Notifications	Enables notifications for all apps. This shows notification icons in the status bar, heads-up notifications, and the expandable notification shade. If you enable this button, you must also enable the Home button. Tapping notification actions and buttons that open new panels doesn't work in lock task mode. LOCK_TASK_FEATURE_NOTIFICATIONS
Show System Info	Enables the status bar's system info area that contains indicators such as connectivity, battery, and sound and vibrate options. LOCK_TASK_FEATURE_SYSTEM_INFO
Enable Keyguard	Enables any lock screen that might be set on the device. Typically not suitable for devices with public users such as information kiosks or digital signage. LOCK_TASK_FEATURE_KEYGUARD
Block Activity Start in Task	Enable blocking of non-allowlisted activities from being started into a locked task. This requires Android 11 (API level 30). LOCK_TASK_FEATURE_BLOCK_ACTIVITY_START_IN_TASK

14.2. Dhizuku Request Permission on Launch

When enabled, if Dhizuku is installed and has not granted Webview Kiosk access through the Dhizuku API, prompt for permission.

Default: true