The automatic config feature in Kiosk Launcher allows you to specify a Url (Settings > Advanced) where Kiosk Launcher will check for config changes every 15 mins. For example https://www.android-kiosk.com/klconfig.json This allows you to keep your devices configured consistently but also allows you to easily make changes. It also allows you to install and update applications silently.

The below list of properties is a complete list of all configuration properties. They are all optional, if you do not include a specific property, the default setting from Kiosk Launcher is used instead.

Please note that some fields require specific strings as detailed in the comments (comments must not be included in the final json as it does not support comments).

It's possible to clear a string property by just using an empty string "". Null can be applied to all of the sleep/wake/restart times

Example String Properties
{
"custom_app_title": "My App Title",
"settings_password": "0000",
"wifi_settings_password":, "WiFiPassword",
"automatic_config_url": "https://www.myconfigurl.com",
"serial_number_source": "DEFAULT", //must be "DEFAULT" OR "RIL_SERIAL_NUMBER" OR RO_SERIAL_NUMBER" OR "SYS_SERIAL_NUMBER"
"default_app": "",
"visible_apps": "com.android.chrome,com.android.camera", //comma separated package names
"allowed_apps": "", //comma separated package names
"theme": "Cyan", //must be "Blue" OR "Cyan" OR "Green" OR "Grey" OR "GreyOrange" OR "Orange" OR "Pink" OR "Purple" OR "Red" OR "Teal" OR "Yellow",
"background_colour": "#424242" //must be valid hex colour code
"app_text_label_colour": "#AAAAAA" //must be valid hex colour code
"screen_orientation""": "Not Set", //must be "Not Set" OR "LANDSCAPE" OR "REVERSE LANDSCAPE" OR "PORTRAIT" OR "REVERSE PORTRAIT"
"device_wake_time_sunday": "07:00", //must be valid time string or empty string to disable
"device_wake_time_monday": "", //must be valid time string or empty string to disable
"device_wake_time_tuesday": "", //must be valid time string or empty string to disable
"device_wake_time_wednesday": "", //must be valid time string or empty string to disable
"device_wake_time_thursday": "", //must be valid time string or empty string to disable
"device_wake_time_friday": "", //must be valid time string or empty string to disable
"device_wake_time_saturday": ", //must be valid time string or empty string to disable
"device_sleep_time_sunday": "20:00", //must be valid time string or empty string to disable
"device_sleep_time_monday": "", //must be valid time string or empty string to disable
"device_sleep_time_tuesday": "", //must be valid time string or empty string to disable
"device_sleep_time_wednesday": "", //must be valid time string or empty string to disable
"device_sleep_time_thursday": "", //must be valid time string or empty string to disable
"device_sleep_time_friday": "", //must be valid time string or empty string to disable
"device_sleep_time_saturday": "", //must be valid time string or empty string to disable
"app_restart_time": "19:00", //must be valid time string or empty string to disable
"device_reboot_time_sunday": "06:00", //must be valid time string or empty string to disable
"device_reboot_time_monday": "", //must be valid time string or empty string to disable
"device_reboot_time_tuesday": "", //must be valid time string or empty string to disable
"device_reboot_time_wednesday": "", //must be valid time string or empty string to disable
"device_reboot_time_thursday": "", //must be valid time string or empty string to disable
"device_reboot_time_friday": "", //must be valid time string or empty string to disable
"device_reboot_time_saturday": "", //must be valid time string or empty string to disable
"automatic_update_time": "23:00", //must be valid time string or empty string to disable
"custom_icon_base64": "" //image base64 to display as custom icon, max 256x256, example does not include base 64 value due to string length
}


Example Boolean Properties
{
"disable_safe_mode": true,
"suppress_error_dialogs": true,
"multitap_settings": true,
"colour_navigation_bar": false,
"hide_system_dialogs": true,
"hide_status_bar": false,
"prevent_notification_access": true,
"keep_screen_on": true,
"prevent_screen_power_off": true,
"control_wifi_state": false,
"wifi_enabled": false,
"volume_controls_enabled": false,
"physical_media_enabled": false,
"always_wake_device": false,
"sleep_power_connect": false,
"sleep_power_disconnect": false,
"hide_toolbar": false,
"custom_icon": false,
"allow_user_install_updates": true,
"show_reboot_device_menu": false,
"show_restart_app_menu": false,
"hide_menu_items": false,
"disable_lock_screen": false,
"bluetooth_enabled": true,
"auto_grant_permissions":false
}


Example Integer Properties
{
"multitap_count": 4, //between 4 and 10
"display_timeout": 300 //time in seconds,
"screen_brightness": 0 //valid values between 0 and 255, 0 = automatic brightness,
"automatic_config_download_frequency": 18 //valid values between 15 and 1440 minutes
"app_icon_size": 48 //value values between 16 and 256
}


Installing/Updating Applications
By including the "install_apps" JSON array in your config file, you can deploy and update applications silently. Simply provide the package name, version code (integer) & URL and let Kiosk Launcher handle the rest. The version code is a specific version given to all APK files, we use this to determine if the most recent version is installed before downloading the apk. To get the version number (often referred to as versionCode) for a specific apk you can either ask your app developer or use our service to read the information from the apk https://www.android-kiosk.com/apkinfo.htm
"install_apps": [
{
"package": "com.procoit.projectcamera",
"version": 65,
"url": "https://kbremote.blob.core.windows.net/apk/current/com.procoit.projectcamera.apk"
},
{
"package": "com.company.app2",
"version": 10,
"url": "https://www.android-kiosk.com/com.company.app2.apk"
}
]
Was this article helpful?
Cancel
Thank you!