Config Intents


To top

Config intents are a way to change the setting of some handheld apps from your own app. The system works by using broadcasts with the actual data provided as extras.


A special permission is required for this so make sure to add the permission to your AndroidManifest.xml

<uses-permission android:name="com.handheldgroup.permission.WRITE_APP_CONFIG" />

Make sure to grant this permission to your app before sending the broadcast.

Broadcast action

The broadcast action consists of the apps package name with “.WRITE_CONFIG” appended. For the KioskBrowser, this would be “com.handheldgroup.kioskbrowser.WRITE_CONFIG“.

Broadcast extras

There are two ways to send extras. You can provide all the different options as individual extras or provide the path to an XML file containing the values. Most apps provide a way to export the settings to XML so you can use that file.

Send config file

If you want to send the config as an XML file, you need two string extras. The first one has the key “format” and the value “file” to indicate that you want to import a file. The second extra has the key “file” and the value should be a path to the XML file you want to use.

Make sure that the receiving app actually has permission to read this file.
Send individual values

The available values might differ greatly between apps. Please select one of the apps in the list below to see possible keys for this app.

In most cases, it will be easier to set up an app as you need and export the settings. You can either use the exported file directly or open it to see the keys and values you could use.

Supported apps

To top

Kiosk Browser
Intent action
Possible values

The application lets you export the values to an XML file. Please look at that file for the possible keys.

Kiosk Home
Intent action
Possible values
Type Key Value Note
String password 1234 Set password to “1234” (or any other numeric value)
Boolean show_notifications true/false Show notifications inside the app
Boolean block_statusbar true/false Prevent access to the status bar
Boolean block_recent_apps true/false Prevent access to the recent apps list
Boolean ignore_default_apps true/false Do not enable the default apps (phone and contacts)
Boolean set_allowed_kiosk.internal.wifi true/false Show the Wi-Fi icon and allow access to the wifi settings
Boolean set_allowed_<packetname> true/false Adds or removed the app with the given package name
Was this article helpful?
Copyright © 2023 Handheld Group. All rights reserved.
Images, texts and other material downloaded from the Handheld web pages may not be reproduced in any form, without prior written permission from the Handheld Group.
Algiz® and Nautiz® are registered trademarks of Handheld Group AB. l Privacy Policy l Device Policy l GDPR l Legal