KioWare - Kiosk System Software - User Guides

« See All User Guides
Configuration Tool
KioWare   |   Platform: Android™   |   Version: 4.5

Introduction

For your convenience, the most up-to-date user guides are always available at KioWare.com, Support menu, User Guides.  Just remember that these online guides may describe features that your version does not have.

KioWare for Android Overview

Do you have questions about KioWare for Android?  If so, we have the answers.

What is the purpose?Allows you to lock down your Android browser or entire Android tablet, so the tablet can be used securely as a digital sign, kiosk, or self-service tool.  In other words, when using KioWare for Android, you ensure that no one can turn off your tablet, hack into it, or damage any applications you are running on it.  You can also limit which applications are run on the tablet, as well as which websites the browser can access.
What are the key components?KioWare for Android (a browser shell application) and the KioWare for Android Configuration Tool (Config Tool), which contains all the settings for running the KioWare browser
How does it work?You first use the Config Tool to set up how you want KioWare for Android to work.  The Config Tool then “talks” to the KioWare browser, telling it how to run.  The browser is opened by clicking a desktop icon, and once it runs, it creates a safe environment for public use of your tablet.
What is the application type?Browser-based
Where is it installed?On your Android tablet
Are different models available?Three models are available: Lite, Basic, and Full.
  • Lite provides browser lockdown protection, limits on the Android applications that are run, resetting of apps/clearing of prior user session, security audits, and automatic updating of settings from a settings file.
  • Basic provides everything that comes with Lite, plus support for using external devices, add-ins, and the tablet's camera.
  • Full provides everything that comes with Basic, and also allows you to monitor multiple tablets from a central location.
Can it be used with some type of server application?Only the Full model can, which includes a KioWare Server product.  This is installed on your server, and can be set up to “talk” to multiple tablets that are running KioWare for Android.
What is in it?Multiple tools to secure your browser and tablet, run attract screens, display a main toolbar, import/export settings, and use addins and devices.  (See KioWare for Android Tools below.)
Who can access it?Whomever you want.  An exit password and other security features keep unwanted users from exiting the KioWare browser and accessing system files and other items on your tablet.
Is it available in different languages?Yes, it can be translated to French, German, or Spanish (see Quick Start Guide, Configuration Tool, Translations).
What are some important things to know about installing/uninstalling it?It is not recommended to install KioWare for Android on Amazon Fire OS devices (see Quick Start Guide, Warnings, Amazon Fire OS Device Detected).

On the Security tab, Device Administrator mode (for KioWare for Android) must first be disabled before you can uninstall KioWare for Android (see Quick Start Guide, Warnings, Device Admin Prevents Uninstall (KioWare Kiosk) for more details).

Samsung KNOX support is available for KioWare for Android.  A KioWareSamsungSupport.apk file must be installed separately, and then a special Samsung KNOX tab appears in the left menu bar of the Config Tool (see Samsung KNOX Tab).

On the Samsung KNOX tab, Device Administrator mode must first be disabled before you can uninstall KioWare Samsung Support (see Quick Start Guide, Warnings, Device Admin Prevents Uninstall (Samsung Support) for more details).
What are some important things to know about running it?You will want to set a home page (see Configuration Tool, General Tab, Start Page URL) that appears when you open the KioWare browser.  If no home page is set, the KioWare Welcome screen will display.

Also, by default, the KioWare browser is not locked down for maximum security; you must change settings in the Config Tool (Quick Start Guide, Configuration Tool) to be fully secure and ready for public use.  The Audit tab (see Configuration Tool, Audit Tab) will show you the current settings, and those that are red or yellow are not set for maximum security and should be changed.

When changing the default Config Tool settings, you will want to avoid certain combinations of settings that prevent users from exiting KioWare for Android (see Quick Start Guide, Warnings, Exit Is Impossible for descriptions of these settings and what to do if you cannot exit).

If you know how you want to use your device but are unsure of how to set up the Config Tool to achieve this, let the Guided Setup help you (see Configuration Tool, Configuration Toolbar, Dropdown Menu, Launch Guided Setup).  Just select the mode (how the device is to be used), and the Guided Setup will take you step-by-step through all the settings for that mode.

Plus, it is always good to look at our Best Practices for the best (and easiest) ways to set up KioWare for Android.

KioWare for Android Tools

These tools, located in the Config Tool (see Quick Start Guide, Configuration Tool), make it easy to tell the KioWare browser how to run by setting up security and special features of KioWare for Android.

General tabProvides basic settings for using your tablet and KioWare for Android (e.g., sets home page, screen orientation, and tablet sleep mode, and enables KioWare for Android to start during boot and auto-load settings from a settings file)
Browser tabDetermines how the Android browser and KioWare browser will run during a user session (e.g., how zooming, popup windows, SSL errors, and media auto play are handled, and if data is stored or cleared)
Attract/Inactivity tabDetermines how the KioWare browser will run when sitting idle between user sessions (e.g., what screens will show, when and for how long, and if alerts should appear)
User Interface tabUsed to show/hide assets (e.g., browser windows, toolbars/toolbar controls, and spacers) on the KioWare browser
Keyboard Filtering tabEnables physical keyboard keys to be allowed/blocked
Security tabSets up security for KioWare for Android and your tablet (e.g., how the KioWare browser will handle file downloads, applications that are running, and various web pages, and if it shows the tablet's system bar or requires an exit password)
KioTouchTM tabProvides settings to run KioTouchTM touch-free kiosk control software with your Android device inside of KioWare
Communication tabProvides settings to run your kiosks/computers with KioCall video chat software and to set up KioCall buttons and other controls
Devices tabAllows KioWare for Android to use devices that are connected to or built into your tablet (e.g., the tablet's camera or a barcode reader)
Kiosk Management tabAllows KioWare for Android to “talk” with the KioWare Server product you loaded on your server (e.g., send to the server information on the running state of KioWare for Android, system and application logs, and usage statistics, and download from the server any updates to the Config Tool settings)
License tabDisplays information on your KioWare for Android license and can be used to get a license
Addins tabAllows you to manage any addins that give more features to KioWare for Android
Audit tabProvides a color-coded audit to show settings that will not give the KioWare browser its maximum security
Samsung KNOX tabAllows access to specific settings on devices that use the Samsung KNOX security platform [e.g., settings to enable/disable Samsung KNOX, airplane mode, USB host storage, SD card access, Air Command mode (S Pen features), clearing of user-specified application data at session end, and the device's Power Off feature and Power, Home, and Volume buttons]
Root tabProvides access to rooted device options (e.g., for setting up custom reboot schedules, showing/hiding the system bar, and showing/hiding the Shutdown button on the Exit popup window)
Advanced tabProvides access to advanced settings (e.g., for setting up machine-specific substitution variables for use throughout the Configuration Tool)

Quick Reference

If you are looking for certain information or steps for a specific setup, then look no further.  This quick reference table can be your guide.  Use the links below to quickly move to specific sections in the table.

  • Addins, Apps, and Communication (KioWare addins, Chrome's Inspect feature, third-party applications, running only one application/entering application package name, exit the application, enable inactivity timer for the application, close the application when the user session ends, KioTouchTM touch-free kiosk control software, KioCall video chat software, using SIP for audio calls, audit of settings)
  • Allowing and Blocking (activity stacks, protocols, domains, web pages/resources, web page scripts, HTTP error pages, applications, keys/key combinations, audit of settings)
  • Attract Screens (enable/disable use of attract screens, add/edit/remove screens, ordering, how long to display, behavior with user activity/override start page, attract screen looping, looper transition/time, override default looper directory, open looper directory, allow incoming calls via KioCall when attract screens are showing)
  • Devices (tablet's camera/custom button images, MagTek uDynamo/BulleT/Dynamag, OPN and Bluetooth devices, keyboard wedges, Chromecast, Star printers, Zxing software, ChipDNA devices, GoChip devices, Storm Interface ADA devices, Numato GPIO Board, Wattbox devices, Event Logs for KioWare Device Support APK, disable/enable settings on devices using Samsung KNOX, set schedules for auto-reboot of KNOX devices/rooted devices, set which applications will have their data cleared at session end, show/hide system bar and shutdown option on exit window for rooted devices)
  • File Downloads (storage, end-session behavior/warnings, mobile networks, allowing PDFs to open in new/current tab, mime type, progress meter)
  • Import/Export of Config Tool Settings and Resources (manual import from settings file, use provisioning file to auto-import after install and first run of KioWare, export, auto-generate settings file to set up new devices, addins/custom images and other resources, Google Drive, restore defaults/keep or delete custom images)
  • KioWare Browser - Back-End Features (real-time communication, SSL errors, cache, cookies, data storage, meta tags, proxy settings, auto-complete set actions when navigating to certain URLs, audit of settings)
  • KioWare Browser - Front-End Display Features (home/start page, additional start pages, non-mobile versions of websites, popup windows, Auto play of videos, browser tabs, show/hide “Navigation Blocked” page, hot keys, audit of settings)
  • KioWare Toolbar (custom logo/images, page load progress bar, address bar, show/hide web page title/URL, show/hide buttons, JavaScript Console, Logcat Viewer, custom URL/app/KioCall buttons, custom button images/using website favicon)
  • Licenses (connection to License Server, show/edit license info, get license)
  • Security (start on boot/wait for network delay, exiting/custom exit pattern/exit by fingerprint, exit screen timeout, passwords for KioWare/tablet, Android lock screen on top/bottom, monitor URLs/set timeouts for URL reload and KioWare restart, auto-sign-in to basic authenticated websites, specify if file browser or camera can/cannot be opened using web-based file selection button/set file browser path and filters, clearing known Wi-Fi access points, scanning for higher priority networks when connected to known network, setting scan frequency for all networks, adding Wi-Fi access points that KioWare stores/auto-connects to, audit of settings)
  • Server (server commands, communication/connection, SSL errors, heartbeats/runtime statistics, GPS data/geofencing, event/statistics/application logs, content updating/auditing, push communication)
  • Tablet (auto-run KioWare, Android browser/default browser, screen orientation/sleep/schedule, status bar, toolbar buttons, popup windows, running only one application, show/hide toast messages when any part of the OS is blocked, audit of settings)
  • User Session and Activity/Inactivity (auto-end session, alerts, overriding default time-outs, controlling session with user presence devices, setting max time a session will run before auto-ending, setting a URL to show on session end and before Attract mode begins, setting default screen brightness for session end, audit of settings)
Addins, Apps, and Communication
KioWare addins, Chrome's Inspect feature, third-party applications, running only one application/entering application package name, exit the application, enable inactivity timer for the application, close the application when the user session ends, KioTouchTM touch-free kiosk control software, KioCall video chat software, using SIP for audio calls, audit of settings
TaskWhere to Find the Information in This User Guide
Enable/disable addins that are installed for KioWare to useAddins tab - check (to enable) or uncheck (to disable) an addin in the list (this tab is only available with the Full model of KioWare)
Enable/disable debugging with Chrome's Inspect featureBrowser tab, Development Options - Enable Remote WebView Debugging
Make third-party application activity register as user activity in KioWare (Inactivity/Activity Service)Attract/Inactivity tab, Inactivity Timers - Inactivity/Activity Service
Security tab, Application Manager - Inactivity/Activity Service
Security tab, Application Manager, Single Application Mode - Inactivity/Activity Service
Show user if there are any issues with the Inactivity/Activity Service setting and if any third-party applications are enabledAudit tab, Attract/Inactivity - Accessibility Service
Set up an Exit button for use when running only one application (that is not KioWare)Security tab, Application Manager, Single application Mode, Exiting KioWare - check Enable Exit Button box, make a selection from the Button Position option, and uncheck the Exit Button Visibility box
Set up the tablet to run only one application (that is not KioWare)Security tab, Application Manager, Single application Mode - check Enable Single Application Mode box and make a selection from the Application option
Enter the package name of a single application (that is not KioWare) to be run on the tabletSecurity tab, Application Manager, Single application Mode - check Enable Single Application Mode box, select the Application option, and at the bottom left of the popup window that shows, select the App Not in List button and then enter the package name
Set up an invisible Exit button for use when running only one application (that is not KioWare)Security tab, Application Manager, Single application Mode, Exiting KioWare - check Enable Exit Button box, make a selection from the Button Position option, and check the Exit Button Visibility box
Start the inactivity timer when running only one application (that is not KioWare)Security tab, Application Manager, Single application Mode, Inactivity Timers - check Enable Inactivity Timer checkbox
Close the application at session end when running only one application (that is not KioWare)Security tab, Application Manager, Single application Mode, Inactivity Timers - check Kill App at Session End checkbox
Set up KioWare to run with KioTouchTM touch-free kiosk control software (set company ID, authorization key, length of an optional logon PIN, if Android navigation controls are/are not shown, if keyboard input is allowed, optional URL to show on session end, instructions to show on the user's device when the touchpad is ready for use, etc.)KioTouchTM tab - check the KioTouchTM Accessibility Service and Enable KioTouchTM checkboxes and then enter the KioTouchTM settings that show
Set up KioWare to run with KioCall video chat software (set authorization key, kiosk name, how to handle incoming calls, if session timeout is/is not allowed, default camera, which buttons to show/hide, call volume, etc.)Communication tab, Using KioCall for Video Chat - set the Communication Provider to KioCall and then enter the KioCall settings that show
Set up KioWare to use Session Initiation Protocol (SIP) to make audio calls (set SIP logon credentials, domain/IP, port, how to handle incoming calls, if session timeout is/is not allowed, call volume, etc.)Communication tab, Using SIP for Audio Calls - set the Communication Provider to SIP and then enter the SIP settings that show
Back to Top Navigation Links
Allowing and Blocking
Activity stacks, protocols, domains, web pages/resources, web page scripts, HTTP error pages, applications, keys/key combinations, audit of settings
Activity Stacks, Protocols, and Web Page Scripts
TaskWhere to Find the Information in This User Guide
Allow tablet to use activity stacks to determine how to allow/block other applications you try to runSecurity tab, Application Manager - Match On
Set which protocols KioWare will allow/block (e.g., ftp, file, mailto)Security tab - Protocol Access List
Set which web page scripts KioWare will allow/block (based on domains and pages)Security tab - Scripting Access List
Domains
TaskWhere to Find the Information in This User Guide
Set up a domain list as an “allow” listSecurity tab, Browsing Access List, Domain Entries - check Set Allow List box and make a selection from Match On option.  For each domain, select the Add New Domain option and enter all information.
Set up a domain list as a “block” listSecurity tab, Browsing Access List, Domain Entries - uncheck Set Allow List box and make a selection from Match On option.  For each domain, select the Add New Domain option and enter all information.
Allow an individual domain when the domain list is set up as a “block” listSecurity tab, Browsing Access List, Domain Entries - select the plus icon (to add) or the pencil icon (to edit) a domain.  Check the box to set the entry as an allow list.
Block an individual domain when the domain list is set up as an “allow” listSecurity tab, Browsing Access List, Domain Entries - select the plus icon (to add) or the pencil icon (to edit) a domain.  Uncheck the box to set the entry as an allow list.
Set a domain entry (in a “block” or “allow” list) as a regular expression (CONTAINS match)Security tab, Browsing Access List, Domain Entries - select the plus icon (to add) or the pencil icon (to edit) a domain.  Check the box that indicates the entry is a regular expression (regex).
Edit a domain in a “block” or “allow” listSecurity tab, Browsing Access List, Domain Entries - select the pencil icon
Guidelines for editing domains and pages in a “block” or “allow” listSecurity tab, Browsing Access List, Guidelines for Editing Domains and Pages
Show user if there are any issues with the Browsing Access List setupsAudit tab, Security - Browsing Access List
Web Pages and Resources
TaskWhere to Find the Information in This User Guide
Set which web pages and resources KioWare will allow/blockSecurity tab - Browsing Access List
Allow or block web pages and their resources (e.g., images)Security tab, Browsing Access List, Domain Entries - Match On
Set up a web page list as an “allow” listSecurity tab, Browsing Access List, Domain Entries - select the pencil icon for a domain entry and check the Set Allow List box.  For each web page, select the Add New page option and enter all information.
Set up a web page list as a “block” listSecurity tab, Browsing Access List, Domain Entries - select the pencil icon for a domain entry and uncheck the Set Allow List box.  For each web page, select the Add New page option and enter all information.
Set a web page entry (in a “block” or “allow” list) as a regular expression (CONTAINS match)Security tab, Browsing Access List, Domain Entries - select the pencil icon.  Below the Page Entries heading, select the plus icon (to add) or the pencil icon (to edit) a web page.  Check the box that indicates the entry is a regular expression (regex).
Edit a web page in a “block” or “allow” listSecurity tab, Browsing Access List, Domain Entries - below the Page Entries heading, select the pencil icon
Show user if there are any issues with the Browsing Access List setupsAudit tab, Security - Browsing Access List
HTTP Error Pages
TaskWhere to Find the Information in This User Guide
Set up a domain list as an “allow” listSecurity tab, Error Page Access List, Domain Entries - check Set Allow List box.  For each domain, select the Add New Domain option and enter all information.
Set up a domain list as a “block” listSecurity tab, Error Page Access List, Domain Entries - uncheck Set Allow List box.  For each domain, select the Add New Domain option and enter all information.
Allow an individual domain when the domain list is set up as a “block” listSecurity tab, Error Page Access List, Domain Entries - select the plus icon (to add) or the pencil icon (to edit) a domain.  Check the box to set the entry as an allow list.
Block an individual domain when the domain list is set up as an “allow” listSecurity tab, Error Page Access List, Domain Entries - select the plus icon (to add) or the pencil icon (to edit) a domain.  Uncheck the box to set the entry as an allow list.
Set a domain entry (in a “block” or “allow” list) as a regular expression (CONTAINS match)Security tab, Error Page Access List, Domain Entries - select the plus icon (to add) or the pencil icon (to edit) a domain.  Check the box that indicates the entry is a regular expression (regex).
Edit a domain in a “block” or “allow” listSecurity tab, Error Page Access List, Domain Entries - select the pencil icon
Remove a domain in a “block” or “allow” listSecurity tab, Error Page Access List, Domain Entries - select the minus icon
Set up an error page list as an “allow” listSecurity tab, Error Page Access List, Domain Entries - select the pencil icon to edit a domain entry and check the Set Allow List box.  For each error page, select the Add New page option and enter all information.
Set up an error page list as a “block” listSecurity tab, Error Page Access List, Domain Entries - select the pencil icon to edit a domain entry and uncheck the Set Allow List box.  For each error page, select the Add New page option and enter all information.
Set an error page entry (in a “block” or “allow” list) as a regular expression (CONTAINS match)Security tab, Error Page Access List, Domain Entries - select the pencil icon to edit a domain.  Below the Page Entries heading, select the plus icon (to add) or the pencil icon (to edit) an error page.  Check the box that indicates the entry is a regular expression (regex).
Edit an error page in a “block” or “allow” listSecurity tab, Error Page Access List, Domain Entries - below the Page Entries heading, select the pencil icon
Remove an error page in a “block” or “allow” listSecurity tab, Error Page Access List, Domain Entries - below the Page Entries heading, select the minus icon
Applications
TaskWhere to Find the Information in This User Guide
Set which applications/application groups KioWare will allow/blockSecurity tab - Application Manager
Include all applications in an “allow” listSecurity tab, Application Manager, Application List Tools - Add All Applications to List
Remove all applications from an “allow” listSecurity tab, Application Manager Application List Tools - Remove All Applications from List
Set up an application list as an “allow” listSecurity tab, Application Manager, Allowed Applications - for each application to be included, select the Add New Application option and then select that application from the list
Enter the package name of a custom application (not included in the list of available applications) to be added to the “allow” listSecurity tab, Application Manager, Allowed Applications - select the Add New Application option, and at the bottom left of the popup window that shows, select the App Not in List button and then enter the package name
Edit the package name of an application in the “allow” listSecurity tab, Application Manager, Allowed Applications - select the pencil icon to show the package name, and then select the package name to edit it
Remove an application from an “allow” listSecurity tab, Application Manager, Allowed Applications - select the minus icon
Keys/Key Combinations
TaskWhere to Find the Information in This User Guide
Block/allow use of all physical keyboard keysKeyboard Filtering tab, Blocked Keys List - Block All
Specify a physical key (or key combination) that KioWare will block (ignore) when usedKeyboard Filtering tab, Blocked Keys List, Blocked Keys - select the plus icon and in the popup window that shows, select a key from the Key Code dropdown and optionally check one or more boxes under Modifier Keys
Edit a blocked key (or blocked key combination)Keyboard Filtering tab, Blocked Keys List, Blocked Keys - select the pencil icon and in the popup window that shows, select a key from the Key Code dropdown and optionally check one or more boxes under Modifier Keys
Remove a blocked key (or blocked key combination)Keyboard Filtering tab, Blocked Keys List, Blocked Keys - select the minus icon
Back to Top Navigation Links
Attract Screens
Enable/disable use of attract screens, add/edit/remove screens, ordering, how long to display, behavior with user activity/override start page, attract screen looping, looper transition/time, override default looper directory, open looper directory, allow incoming calls via KioCall when attract screens are showing
TaskWhere to Find the Information in This User Guide
Set if attract screens can/cannot be usedAttract/Inactivity tab - Attract Screen Mode
Tell KioWare to allow incoming calls made via KioCall when the kiosk or tablet is showing attract screensCommunication tab, Using KioCall for Video Chat, KioCall Settings - check the Allow Incoming Calls in Attract Mode checkbox
Web Page List
TaskWhere to Find the Information in This User Guide
Set KioWare to create attract screens from a list of web pagesAttract/Inactivity tab, Attract Screen Mode - select the Web Page List option
Set the default length of time to show each attract screen in the web page listAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - Default Attract Duration
Set up an attract screenAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - select the plus icon and, in the popup window that shows, specify URL, Behavior with User Activity, and Duration settings
Remove an attract screenAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - select the minus icon for an attract screen
Edit an attract screenAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - select the pencil icon for an attract screen and, in the popup window that shows, change the URL, Behavior with User Activity, and/or Duration settings
Display the default Start Page when there is user activity (pressing buttons on a system navigation bar, selecting buttons on a touchscreen, etc.)Attract/Inactivity tab, Attract Screen Mode, Using Web Page List - select the plus icon (to add) or the pencil icon (to edit) an attract screen and, in the popup window that shows, select the Return to Start Page option
Display a new Start Page when there is user activityAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - select the plus icon (to add) or the pencil icon (to edit) an attract screen and, in the popup window that shows, select the Return to Start Page option and enter a new Start Page URL in the Override Start Page URL setting
Continue to display the current attract screen when there is user activity, and allow the attract screen to register that activityAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - select the plus icon (to add) or the pencil icon (to edit) an attract screen and, in the popup window that shows, select the Stay On Page option
Continue to display the current attract screen when there is user activity, and tell the attract screen to ignore that activityAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - select the plus icon (to add) or the pencil icon (to edit) an attract screen and, in the popup window that shows, select the Ignore User Input option
Set the length of time to show an individual attract screenAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - select the plus icon (to add) or the pencil icon (to edit) an attract screen and, in the popup window that shows, set the Duration to a value other than 0
Change the order for attract screens to displayAttract/Inactivity tab, Attract Screen Mode, Using Web Page List - press and drag any entry listed under the Attract Screens option
Local Folder Contents (Looping)
TaskWhere to Find the Information in This User Guide
Set KioWare to create attract screens using local files and loop through themAttract/Inactivity tab, Attract Screen Mode, Using Local Folder Contents - select the Local Folder Contents option
Set the default length of time to show each screen during attract screen loopingAttract/Inactivity tab, Attract Screen Mode, Using Local Folder Contents - Default Attract Duration
Add a fade or other transition to looping attract screensAttract/Inactivity tab, Attract Screen Mode, Using Local Folder Contents - Transition Animation
Set how long each attract screen transition will takeAttract/Inactivity tab, Attract Screen Mode, Using Local Folder Contents - Transition Duration
Allow KioWare to loop files stored in the default attract looper directoryAttract/Inactivity tab, Attract Screen Mode, Using Local Folder Contents - leave the Attract Looper Directory setting blank
Allow KioWare to loop files stored in another directoryAttract/Inactivity tab, Attract Screen Mode, Using Local Folder Contents - in the Attract Looper Directory setting, enter the file path to the new directory
Open the attract looper directory (default or another) in a file browser/file manager application loaded on the tabletAttract/Inactivity tab, Attract Screen Mode, Using Local Folder Contents - Attract Looper Content
Back to Top Navigation Links
Devices
Tablet's camera, MagTek uDynamo/BulleT/Dynamag, OPN and Bluetooth devices, keyboard wedges, Chromecast, Star printers, Zxing software, ChipDNA devices, GoChip devices, Storm Interface ADA devices, Numato GPIO Board, Wattbox devices, Event Logs for KioWare Device Support APK, disable/enable settings on devices using Samsung KNOX, set schedules for auto-reboot of KNOX devices/rooted devices, set which applications will have their data cleared at session end, show/hide system bar and shutdown option on exit window for rooted devices
Tablet's Camera
TaskWhere to Find the Information in This User Guide
Allow KioWare to use your tablet's cameraDevices tab, Camera - Enable Camera
Allow KioWare to auto-clear saved images when the user session endsDevices tab, Camera, Default Camera Settings - Clear Saved Images on Session End
Select the default camera that KioWare will use (front or back)Devices tab, Camera, Default Camera Settings - Default Camera
Show/hide the Exit button when KioWare is running the cameraDevices tab, Camera, Default Display Settings - Show Exit Button
Show/hide the Camera Switch button when KioWare is running the camera (button switches between front and back camera)Devices tab, Camera, Default Display Settings - Show Camera Switch Button
Show/hide the Capture button when KioWare is running the camera (button takes pictures)Devices tab, Camera, Default Display Settings - Show Capture Button
Show/hide the Timer button when KioWare is running the camera (button gives a countdown for taking pictures)Devices tab, Camera, Default Display Settings - Show Timer Button
Show/hide the Preview button when KioWare is running the camera (button allows you to accept/remove pictures after taking)Devices tab, Camera, Default Display Settings - Show Preview Screen
Add custom images on the Exit, Camera Switch, Capture, Timer, and Preview buttons when KioWare is running the cameraDevices tab, Camera, Default Display Settings - select the pencil icon for each button's settings and enter all information
Set how long (in seconds) before a picture is automatically taken after KioWare runs the cameraDevices tab, Camera, Default Display Settings - Default Timer
Set the width of camera images when using JavaScript with KioWare (for custom resolution)Devices tab, Camera, Default Display Settings - Base64 Image Width
Back to Top Navigation Links
MagTek Readers
TaskWhere to Find the Information in This User Guide
Allow the tablet to use MagTek magnetic card readers when running KioWareDevices tab, MagTek uDynamo/BulleT/Dynamag - Enable
Set up the tablet to use MagTek uDynamo, MagTek BulleT (Bluetooth), or Magtek Dynamag magnetic card reader when running KioWareDevices tab, MagTek uDynamo/BulleT/Dynamag - Device Type
Set up the tablet to use a specific MagTek BulleT (Bluetooth) device when running KioWareDevices tab, MagTek uDynamo/BulleT/Dynamag - Bluetooth Device
Back to Top Navigation Links
OPN Readers
TaskWhere to Find the Information in This User Guide
Allow the tablet to use OPN (Bluetooth SPP) barcode readers when running KioWareDevices tab, OPN Devices (Bluetooth SPP) - Enable OPN Devices
Make OPN (Bluetooth SPP) barcode readers use a secure connection to “talk” with the tablet when running KioWareDevices tab, OPN Devices (Bluetooth SPP) - Enable Secure Communication
Set up the tablet to use a specific OPN (Bluetooth SPP) barcode reader when running KioWareDevices tab, OPN Devices (Bluetooth SPP) - Bluetooth Device
Back to Top Navigation Links
Keyboard Wedges
TaskWhere to Find the Information in This User Guide
Show a list of all devices built into the tablet that can serve as a keyboard wedge (can pass data to KioWare as if entered on a keyboard)Devices tab, Keyboard Wedge - Connected Devices
Show/edit the keyboard wedge settings of a device built into your tabletDevices tab, Keyboard Wedge, Connected Devices - select the plus icon for a device
Set up a new keyboard wedge to pass data to KioWareDevices tab, Keyboard Wedge, Wedges - for each new keyboard wedge, select the plus icon and enter all information
Set an alternate name for a keyboard wedge that passes data to KioWareDevices tab, Keyboard Wedge, Wedges - select the plus icon (to add) or the pencil icon (to edit) and enter information in the Alias setting
Tell KioWare what characters will show the start and end of data passed from a keyboard wedgeDevices tab, Keyboard Wedge, Wedges - select the plus icon (to add) or the pencil icon (to edit) and enter information in the Start Sentinel and End Sentinel settings
Set how long (in milliseconds) after device timeout until the buffer is cleared (buffer is a division of memory on your tablet that is used to store data)Devices tab, Keyboard Wedge, Wedges - select the plus icon (to add) or the pencil icon (to edit) and set a value for the Clear Buffer setting
Edit a keyboard wedge that passes data to KioWareDevices tab, Keyboard Wedge, Wedges - select the pencil icon for a keyboard wedge
Remove a keyboard wedgeDevices tab, Keyboard Wedge, Wedges - select the minus icon for the keyboard wedge
Back to Top Navigation Links
Bluetooth Devices
TaskWhere to Find the Information in This User Guide
Set up a new Bluetooth device to run with KioWareDevices tab, Bluetooth Devices - for each new device, select the plus icon for the Add New Bluetooth Device option and enter all information
Set an alternate name for a Bluetooth device to run with KioWareDevices tab, Bluetooth Devices - select the plus icon (to add) or the pencil icon (to edit) and enter information in the Alias setting
Make a Bluetooth device use a secure connection to “talk” with the tablet when running KioWareDevices tab, Bluetooth Devices - select the plus icon (to add) or the pencil icon (to edit) and check the box that enables secure Bluetooth communication
Set up the tablet to use a specific Bluetooth device when running KioWareDevices tab, Bluetooth Devices - select the plus icon (to add) or the pencil icon (to edit) and make a selection from the Bluetooth Device setting
Remove a Bluetooth deviceDevices tab, Bluetooth Devices - select the minus icon for the Bluetooth device
Back to Top Navigation Links
Chromecast
TaskWhere to Find the Information in This User Guide
Allow the tablet to use Google's Chromecast digital media player when running KioWareDevices tab, Chromecast - Enable Chromecast Casting
Set the ID of your Chromecast application (or KioWare app ID) that you register with Google in the Chromecast Developer consoleDevices tab, Chromecast - App ID
Set the namespace (unique string identifier) your Chromecast application (or KioWare) usesDevices tab, Chromecast - Namespace
Show all Chromecast devices that are currently being used with the tabletDevices tab, Chromecast, Chromecast Devices - listing below the Chromecast Devices heading
Allow the Config Tool to begin searching for ChromecastsDevices tab, Chromecast, Chromecast Devices - Start Searching for Chromecasts
Back to Top Navigation Links
Star Printers
TaskWhere to Find the Information in This User Guide
Show a list of Star printers currently available on Bluetooth and Ethernet/Wi-FiDevices tab, Star Printers - Search for Star Printers
Set up the tablet to use a specific Star printer when running KioWareDevices tab, Star Printers - for each new star printer, select the Add New Star Printer option and enter all information
Set an alternate name for a Star printer to use with KioWareDevices tab, Star Printers - select the Add New Star Printer option (to add) or the pencil icon (to edit) and enter information in the Alias setting
Set the connection path of a Star printer to use with KioWareDevices tab, Star Printers - select the Add New Star Printer option (to add) or the pencil icon (to edit) and enter information in the Connection path setting
Remove a Star printerDevices tab, Star Printers - select the minus icon for the Star printer
Back to Top Navigation Links
Zxing Application
TaskWhere to Find the Information in This User Guide
Tell KioWare if the ZXing application (allows the tablet's camera to serve as a barcode reader) can/cannot be usedDevices tab - Enable Zxing
Back to Top Navigation Links
ChipDNA Devices
TaskWhere to Find the Information in This User Guide
Allow the tablet to use ChipDNA Bluetooth devices for Chip and PIN transactions when running KioWareDevices tab, ChipDNA Devices, Enabling Bluetooth Devices
Set up the tablet to use a specific ChipDNA Bluetooth device when running KioWareDevices tab, ChipDNA Devices, Enabling Bluetooth Devices - Bluetooth Device
Allow the tablet to use ChipDNA USB devices when running KioWareDevices tab, ChipDNA Devices, Enabling USB Devices
Back to Top Navigation Links
GoChip Devices
TaskWhere to Find the Information in This User Guide
Allow the tablet to use a specific GoChip EMV device when running KioWareDevices tab, GoChip Devices, GoChip Device Type - select a device from the popup window that shows
When using the Ingenico iUC285 (USB) device to complete a transaction, set the number of seconds before the transaction will time out and be cancelledDevices tab, GoChip Devices - Transaction Timeout
Back to Top Navigation Links
Storm Interface ADA Devices
TaskWhere to Find the Information in This User Guide
Allow the tablet to use Storm Interface devices (that comply with the Americans with Disabilities Act) when running KioWareDevices tab, Storm Interface ADA Devices - Enable Storm Interface Devices
Assign an action (log out, refresh, run script, etc.) to be performed when a specific key is pressed (by itself or in combination with the Ctrl, Alt, or Shift key) on a Storm Interface ADA device while the KioWare browser is runningDevices tab, Storm Interface ADA Devices - select the plus icon and with the popup window showing, either 1) press a key/key combination on the Storm Interface device and then choose an action from the Action Type dropdown that shows; or 2) select the Manual Entry button, select a key from the Key Code dropdown, optionally check one or more boxes under Meta Keys, and choose an action from the Action Type dropdown
Edit an action that is assigned to a specific key/key combinationDevices tab, Storm Interface ADA Devices - select the pencil icon and in the popup window that shows, select a new key from the Key Code dropdown, check/uncheck different boxes under Meta Keys, and/or choose a new action from the Action Type dropdown
Remove an action that is assigned to a specific key/key combinationDevices tab, Storm Interface ADA Devices - select the minus icon for the key action
Back to Top Navigation Links
Numato GPIO Board
TaskWhere to Find the Information in This User Guide
Allow the tablet to use the Numato GPIO Board when running KioWareDevices tab, Numato GPIO Board - Enable Numato GPIO Board
Set the default input/output states of pins on the Numato GPIO Board when running KioWareDevices tab, Numato GPIO Board - Default IO States
Set which output pins on the Numato GPIO Board will function as high-voltage pins by default when running KioWareDevices tab, Numato GPIO Board - Default Pin States
Tell KioWare to reset all pins on the Numato GPIO Board to their default states when a user session endsDevices tab, Numato GPIO Board - Reset Pin States on Session End
Assign an action (navigate to URL or run script) to be performed when specific conditions are met on the Numato GPIO Board while the KioWare browser is runningDevices tab, Numato GPIO Board, Automatic Actions - select the plus icon (to add) or the pencil icon (to edit), and in the popup window that shows, select the Trigger Type (Digital, Above/Below Voltage, or Voltage Range) and enter the related trigger conditions that show (Trigger On or Minimum and/or Maximum Voltage), set the Debounce Milliseconds (how long the trigger condition must be continuously met before the action is triggered), select the Action Type (Navigate or Run Script), and specify the action URL or JavaScript
Remove an action that is assigned to specific conditionsDevices tab, Numato GPIO Board, Automatic Actions - select the minus icon for the action
Back to Top Navigation Links
Wattbox Devices
TaskWhere to Find the Information in This User Guide
Allow the tablet to use SnapAV's Wattbox device when running KioWareDevices tab, Wattbox Devices - Enable Wattbox Device
Set up the tablet to use a specific Wattbox device/web interface when running KioWareDevices tab, Wattbox Devices - in the IP Address, Username, and Password settings, enter the IP address of the Wattbox web interface and the username/password to log onto it
Assign an action (navigate to URL or run script) to be performed when specific conditions are met on a Wattbox device while the KioWare browser is runningDevices tab, Wattbox Devices, Automatic Actions - select the plus icon (to add) or the pencil icon (to edit), and in the popup window that shows, select the Trigger Type (electrical measurement) and Threshold Type (Above, Below, or In Range), enter the Minimum and/or Maximum Value, set the Debounce Milliseconds (time it takes to re-enter allowed range), select the Action Type (Navigate or Run Script), and specify the action URL or JavaScript
Remove an action that is assigned to specific conditionsDevices tab, Wattbox Devices, Automatic Actions - select the minus icon for the automatic action
Back to Top Navigation Links
Specific Samsung Devices
TaskWhere to Find the Information in This User Guide
Turn on/off specific settings on devices that use the Samsung KNOX security platform [settings to enable/disable Samsung KNOX, airplane mode, USB host storage, SD card access, the device's Power Off feature, certain device buttons, Air Command mode (S Pen features), etc.]Samsung KNOX tab (when KioWareSamsungSupport.apk is installed)
Tell KioWare if custom schedules can/cannot be set up to automatically reboot a Samsung KNOX deviceSamsung KNOX tab, Reboot Schedule - Enable Schedules
Tell KioWare when and how often to automatically reboot a Samsung KNOX deviceSamsung KNOX tab, Reboot Schedule - select the Add New Reboot Schedule option (to add) or the pencil icon (to edit), and then enter a description, start date/time, and any recurrences for the custom schedule
Tell KioWare which applications are to have their data cleared at session endSamsung KNOX tab, Clear Application Data List - select the plus icon and in the popup window that shows, select an application.  Repeat for each application that you want to clear data from when a user session ends.
Enter the package name of a custom application (not included in the list of available applications) whose data is to be cleared when a user session endsSamsung KNOX tab, Clear Application Data List - select the plus icon and at the bottom left of the popup window that shows, select the App Not in List button and then enter the package name.
Edit the package name of an application whose data is to be cleared when a user session endsSamsung KNOX tab, Clear Application Data List - select the pencil icon to show the package name, and then select the package name to edit it
Back to Top Navigation Links
Rooted Devices
TaskWhere to Find the Information in This User Guide
Tell KioWare if custom schedules can/cannot be set up to automatically reboot a rooted deviceRoot tab, Reboot Schedule - Enable Schedules
Tell KioWare when and how often to automatically reboot a rooted deviceRoot tab, Reboot Schedule - select the Add New Reboot Schedule option (to add) or the pencil icon (to edit), and then enter a description, start date/time, and any recurrences for the custom schedule
Show/hide the tablet's system bar when running KioWareRoot tab - Hide System Bar
Allow KioWare to exit full-screen videos via the tablet's Back buttonRoot tab - uncheck Hide System Bar
Allow users to exit KioWare and shut down the tablet at the same timeRoot tab - check Exit Shutdown Option
Back to Top Navigation Links
Event Logs for KioWare Device Support APK
TaskWhere to Find the Information in This User Guide
Show Event Logs for the KioWare Device Support APK (Android Application Package)Configuration Toolbar - Dropdown Menu, Device Support Logcat Viewer
Back to Top Navigation Links
File Downloads
Storage, end-session behavior/warnings, mobile networks, allowing PDFs to open in new/current tab, mime type, progress meter
TaskWhere to Find the Information in This User Guide
Set up KioWare to download filesSecurity tab - Download Manager
Location where downloads are stored when running KioWareSecurity tab, Download Manager - Download Directory
Set how KioWare will behave if the user session is about to end when a file is being downloadedSecurity tab, Download Manager - Session End Behavior
Display a warning during file downloading that the user session will soon endSecurity tab, Download Manager - Warn Before Timeout
Allow KioWare to download files on 4G (mobile) networksSecurity tab, Download Manager - Allow Downloads on Mobile Networks
Allow KioWare to open PDFs in its browserSecurity tab, Download Manager - Display PDFs in Browser
Tell KioWare how to open PDFs in its browser (in the currently displayed tab or in a new tab)Security tab, Download Manager - check the Display PDFs in Browser checkbox, select the PDF Popup Mode option, and then choose whether to open PDFs in the current tab or in a new tab
Select a common mime type (string that tells KioWare the file extension) to use when downloading filesSecurity tab, Download Manager, Tools - Select a Common Mime Type
Retrieve a custom mime type for KioWare to use when downloading filesSecurity tab, Download Manager, Tools - Get Mime Type from URL
Add a new type of file download that KioWare can useSecurity tab, Download Manager, Downloads by Mime Type - select the plus icon on the Add New Download option and enter all information
Edit a file download type that KioWare can useSecurity tab, Download Manager, Downloads by Mime Type - select the pencil icon for a download
Set how KioWare will behave when a file download is completeSecurity tab, Download Manager, Downloads by Mime Type - select the plus icon (to add) or the pencil icon (to edit), and make a selection from the Action on Download Complete option
Set KioWare to show a progress meter while a file is downloadingSecurity tab, Download Manager, Downloads by Mime Type - select the plus icon (to add) or the pencil icon (to edit), and check the Show Progress Dialog box
Set KioWare to remove all downloaded files on user session endSecurity tab, Download Manager, Downloads by Mime Type - select the plus icon (to add) or the pencil icon (to edit), and check the Clear on Session End checkbox
Set KioWare to always associate a mime type with a specific applicationSecurity tab, Download Manager, Downloads by Mime Type - Associate Mime Type to Application
Back to Top Navigation Links
Import/Export of Config Tool Settings and Resources
Manual import from settings file, use provisioning file to auto-import after install and first run of KioWare, export, auto-generate settings file to set up new devices, addins/custom images and other resources, Google Drive, restore defaults/keep or delete custom images
TaskWhere to Find the Information in This User Guide
Embed custom images (for camera and KioWare toolbar buttons) into a settings file for import/exportImport/Export of Settings, Images, and Other Resources, Embedding Resources - Custom Images (Manual Insertion) and Custom Images (Auto-Insertion)
Embed KioWare addins into a settings file for import/exportImport/Export of Settings, Images, and Other Resources, Embedding Resources - KioWare for Android Addins
Embed other resources (e.g., HTML application) into a settings file for import/exportImport/Export of Settings, Images, and Other Resources, Embedding Resources - Other Resources
Auto-import settings file using a local file, remote/local file path, or Google Drive when starting KioWare (file contains Config Tool settings and any embedded resources)General tab, Remote Settings - Enable Automatic Settings Import and Settings File Location
Auto-check settings file for updates/auto-load updates to Config ToolGeneral tab, Remote Settings - Settings File Update Interval
Use a provisioning file to auto-load settings (from a local file, remote/local file path, or Google Drive) after install and first run of KioWare (settings file contains Config Tool settings and any embedded resources)Installation and Requirements, Installation Instructions, Provisioning
Manually import settings file using a local file, remote/local file path, or Google Drive before running KioWare (file contains Config Tool settings and any embedded resources)Import/Export of Settings, Images, and Other Resources, Importing
Manually export Config Tool settings and any embedded resources to a settings file stored on a local drive or Google DriveImport/Export of Settings, Images, and Other Resources, Exporting
Auto-generate a provisioning (settings) file to set up KioWare or specific device settings, and then save file to a chosen location for use in streamlining the setup of multiple devices (file can include license credentials and certain values for KioWare Server, devices, and Wi-Fi)General tab, Create Provisioning File
Clear information on Google account you were using to log onto Google Drive (be prompted to select a Google account the next time you try to log on)Configuration Toolbar - Dropdown Menu, Clear Google Account
Restore default Config Tool settingsConfiguration Toolbar - Load Defaults
Keep or delete custom (embedded) images when reloading Config Tool defaultsConfiguration Toolbar - Load Defaults
Back to Top Navigation Links
KioWare Browser - Back-End Features
Real-time communication, SSL errors, cache, cookies, data storage, meta tags, proxy settings, auto-complete set actions when navigating to certain URLs, audit of settings
TaskWhere to Find the Information in This User Guide
Tell KioWare to use real-time communication (RTC) for all websitesBrowser tab - Enable WebRTC
Tell KioWare how to handle Secure Socket Layer (SSL) errors in browserBrowser tab - Ignore SSL Errors in Browser
Store browser cacheBrowser tab, Browser Cache/Data, Browser Cache - Enable Browser Cache
Clear browser cache on session endBrowser tab, Browser Cache/Data, Browser Cache - Clear Cache at Session End
Store cookiesBrowser tab, Browser Cache/Data, Cookies - Enable Cookies
Clear cookies on session endBrowser tab, Browser Cache/Data, Cookies - Clear Cookies at Session End
Allow web pages to store HTML5 local/session dataBrowser tab, Browser Cache/Data, HTML 5 Web Storage - Enable Local/Session Storage
Allow web pages to store HTML5 web databasesBrowser tab, Browser Cache/Data, HTML 5 Web Storage - Enable Web Databases
Allow web pages to utilize HTML5's application cacheBrowser tab, Browser Cache/Data, HTML 5 Web Storage - Enable Application Cache
Show if there are any issues with the Clear HTML5 Storage at Session End settingAudit tab, Browser - Clear HTML5 Storage at Session End
Clear all web storage and all application cache on session endBrowser tab, Browser Cache/Data, HTML 5 Web Storage - Clear HTML5 Storage at Session End
Show if there are any issues with the Enable Browser Cache and Clear Cache at Session End settingsAudit tab, Browser - Clear Cache at Session End
Show if there are any issues with the Enable Cookies and Clear Cookies at Session End settingsAudit tab, Browser - Clear Cookies at Session End
Allow KioWare to display websites according to the mobile device displaying them (use website Viewport meta tags)Browser tab - Enable Wide Viewport Meta Tag
Tell KioWare to use a proxy server with web browsingBrowser tab - Proxy Settings
Tell KioWare to complete a set action when attempting to navigate to a specific URL (URL match can be CONTAINS or regular expression, and action can be a login to a form, redirect to another URL, ending of session, or running of set JavaScript)Browser tab, Automatic Action List
Back to Top Navigation Links
KioWare Browser - Front-End Display Features
Home/start page, additional start pages, non-mobile versions of websites, popup windows, Auto play of videos, browser tabs, show/hide “Navigation Blocked” page, hot keys, audit of settings
TaskWhere to Find the Information in This User Guide
Set the home page (main start page)General tab, Start Page Settings - Start Page URL
Add another start page (that shows in a new tab when the KioWare browser is run)General tab, Start Page Settings - select the plus icon of the Additional Start Pages setting and, in the popup window, enter a URL and set if the start page tab can/cannot be closed
Edit another start pageGeneral tab, Start Page Settings - select the pencil icon for a start page entry, and edit the settings for URL and if the start page tab can/cannot be closed
Delete another start pageGeneral tab, Start Page Settings - select the minus icon for a start page entry
Tell KioWare if the main start page tab will show first (with all other start page tabs showing to the right of it) or last (with all other start page tabs showing to the left of it)General tab, Start Page Settings - Start Page URL First
Tell KioWare if the main start page tab can/cannot be closedGeneral tab, Start Page Settings - Allow Start Page Closure
Display non-mobile version of websitesBrowser tab - Enable Desktop Browser Mode
Tell KioWare how to handle popup windows in its browserBrowser tab - Popup Window Handling
Enable/disable Auto play of videosBrowser tab - Enable Media Auto Play
Show settings for user-created browser tabsUser Interface tab, Tab Bar
Show/hide the tab bar in the browserUser Interface tab, Tab Bar - Show Tab Bar
Set the max number of tabs that can be open at one timeUser Interface tab, Tab Bar - Maximum Tabs
Allow users to open new browser tabsUser Interface tab, Tab Bar - Allow User Created Tabs
Set the default URL for all new browser tabs openedUser Interface tab, Tab Bar - New Tab URL
Show/hide the “Navigation Blocked” page when trying to access a domain or web page that will be blockedSecurity tab, Browsing Access List - Show Navigation Blocked Page
Assign an action (log out, refresh, run script, etc.) to be performed when a specific key (hot key) is pressed by itself or in combination with modifier keys (Ctrl, Alt, Shift, etc.) while the KioWare browser is runningKeyboard Filtering tab, Hot Keys List, Hot Keys - select the plus icon and in the popup window that shows, select a key from the Key Code dropdown, optionally check one or more boxes under Modifier Keys, and choose an action from the Action Type dropdown
Edit the key combination and action assigned to a hot keyKeyboard Filtering tab, Hot Keys List, Hot Keys - select the pencil icon and in the popup window that shows, select a new key from the Key Code dropdown, check/uncheck different boxes under Modifier Keys, and/or choose a new action from the Action Type dropdown
Remove a hot keyKeyboard Filtering tab, Hot Keys List, Hot Keys - select the minus icon
Show if there are any issues with the Show Tab Bar setting and if users can/cannot create new tabsAudit tab, Toolbar - Tab Bar
Show if application/KioCall buttons or URL links have been added (to the toolbar) under the Custom Toolbar Buttons settingAudit tab, Toolbar - Custom Toolbar Buttons
Back to Top Navigation Links
KioWare Toolbar
Custom logo/images, page load progress bar, address bar, show/hide web page title/URL, show/hide buttons, JavaScript Console, Logcat Viewer, custom URL/app/KioCall buttons, custom button images/using website favicon
TaskWhere to Find the Information in This User Guide
Show the toolbar in the KioWare browserUser Interface tab - Enable Action Bar
Add a custom image to the toolbarUser Interface tab - select the pencil icon for the Enable Action Bar option and enter the image information
Add custom title text to the toolbarUser Interface tab - select the pencil icon for the Enable Action Bar option and enter all information
Show a progress bar in the toolbar when loading pagesUser Interface tab - Enable Progress Bar
Show an address bar in the toolbar for displaying/editing the current page's URLUser Interface tab - Address Bar
Show/hide web page title/URL on the browser toolbarUser Interface tab - Show Page Title on Action Bar
Show/hide logo image on browser toolbarUser Interface tab, Standard Buttons - Display Logo
Show/hide Back button on browser toolbarUser Interface tab, Standard Buttons - Back Button
Show/hide Forward button on browser toolbarUser Interface tab, Standard Buttons - Forward Button
Show/hide Home button on browser toolbarUser Interface tab, Standard Buttons - Home Button
Show/hide Refresh button on browser toolbarUser Interface tab, Standard Buttons - Refresh Button
Show/hide Log Out button on browser toolbarUser Interface tab, Standard Buttons - Log Out Button
Show/hide Screen Brightness Control button on browser toolbarUser Interface tab, Standard Buttons - Brightness Control Button
Show/hide Wireless Network Status Indicator button on browser toolbarUser Interface tab, Standard Buttons - Wi-Fi Status Indicator
Show/hide Battery Indicator button on browser toolbarUser Interface tab, Standard Buttons - Battery Indicator Button
Show/hide System Time button on browser toolbarUser Interface tab, Standard Buttons - System Time Button
Add custom images on the Back, Forward, Home, Refresh, and Log Out buttonsUser Interface tab, Standard Buttons - select the pencil icon for each button's settings and enter all information
Show/hide JavaScript Console buttonUser Interface tab, Development Buttons - Hide/Show JavaScript Console Button
Show if there are any issues with the Hide/Show JavaScript Console Button settingAudit tab, Toolbar - JavaScript Console
Show/hide Logcat Viewer buttonUser Interface tab, Development Buttons - Hide/Show Logcat Viewer Button
Show if there are any issues with the Hide/Show Logcat Viewer Button settingAudit tab, Toolbar - Logcat Viewer
Add custom buttons (on the KioWare browser toolbar) for accessing URLs/files, running apps, and opening KioCallUser Interface tab, Custom Buttons - select the plus icon for the Custom Toolbar Buttons option
Add custom button that opens a website and use the website's icon (favicon) as the button imageUser Interface tab, Custom Toolbar Buttons - select the plus icon for the Custom Toolbar Buttons option, select the URL Link option, and then enter the Link URL (website address) and check the Use Favicon checkbox
Change the order of custom links in the toolbarUser Interface tab, Custom Buttons - press and drag any entry listed under the Custom Toolbar Buttons option
Back to Top Navigation Links
Licenses
Connection to License Server, show/edit license info, get license
TaskWhere to Find the Information in This User Guide
Allow KioWare to “talk” with the KioWare License ServerLicense tab - check the Use a License Server box and enter information in the License Server URL and (if needed) License Server Passcode settings
Test the connection between KioWare and the KioWare License ServerLicense tab, License Server Settings - Test License Server Connection
Set the model of KioWare that you have purchased (Lite, Basic, or Full)License tab - KioWare Model
Enter the name of the organization that is assigned the KioWare licenseLicense tab - Company Name
Show the license key for your KioWare licenseLicense tab, License - License Code
Show the status of your KioWare license (demo, valid, or invalid)License tab, License - [Status]
Show the system code of your KioWare license (for manual licensing)License tab, License - [Status], System Code
Show the name of your tabletLicense tab, License - [Status], Device Name
Get a license electronically from the License Server hosted at KioWareLicense tab, License - Get Electronic License
Use a provisioning file to get a license automatically after install and first run of KioWareInstallation and Requirements, Installation Instructions, Provisioning
Back to Top Navigation Links
Security
Start on boot/wait for network delay, exiting/custom exit pattern/exit by fingerprint, exit screen timeout, passwords for KioWare/tablet, Android lock screen on top/bottom, monitor URLs/set timeouts for URL reload and KioWare restart, auto-sign-in to basic authenticated websites, specify if file browser or camera can/cannot be opened using web-based file selection button/set file browser path and filters, clearing known Wi-Fi access points, scanning for higher priority networks when connected to known network, setting scan frequency for all networks, adding Wi-Fi access points that KioWare stores/auto-connects to, audit of settings
TaskWhere to Find the Information in This User Guide
Auto-run KioWare when the tablet bootsGeneral tab, Boot Settings - Start on Boot
Set the number of seconds that KioWare will wait (after device boot) before showing the start pageGeneral tab, Boot Settings - Wait for Network Delay Timeout
Tell KioWare if the Network Delay popup window can/cannot be closed during the waitGeneral tab, Boot Settings - Allow Network Delay Cancel
Tell KioWare what type of network connection to wait for (Wi-Fi, cellular, Ethernet, or any other connection)General tab, Boot Settings - Wait for Network Type
Show if there are any issues with the Start on Boot settingAudit tab, General - Start on Boot
Set the amount of time (in seconds) that KioWare will show the exit screen before auto-closing itSecurity tab, Exit Screen Timeout
Set the password for exiting the KioWare browserSecurity tab, Exit Passcodes - Exit Passcode
Set Administrator mode (set KioWare to run on top of or under the Android lock screen)Security tab - Enable Device Administrator
Show if there are any issues with the Enable Device Administrator settingAudit tab, Security - Enable Device Administrator
Use a provisioning file to automatically enable/disable Administrator mode after install and first run of KioWareInstallation and Requirements, Installation Instructions, Provisioning
Set the administrator password for exiting the Android tabletSecurity tab, Exit Passcodes - Exit Passcode
Set additional passcodes (for logging off or exiting KioWare) and the related actions to be performed (exit or restart KioWare, shut down or restart rooted device, run JavaScript command, open Logcat Viewer, etc.)Security tab, Exit Passcodes - select the plus icon (to add) or the pencil icon (to edit), enter/confirm the new passcode, and select an option from the Exit Action dropdown
Remove additional passcodesSecurity tab, Exit Passcodes - select the minus icon for an additional passcode entry
Show if there are any issues with the Enable Device Administrator and Exit Passcode settingsAudit tab, Security - Exit Passcode
Set a custom pattern (using the four browser corners) that will show the Exit windowSecurity tab - Exit Pattern
Allow users to exit KioWare using their fingerprintSecurity tab - Enable Fingerprint Exit
Allow users to exit KioWare without entering a passwordSecurity tab - Enable Quick Exit
Show if there are any issues with the Enable Quick Exit settingAudit tab, Security - Enable Quick Exit
Set the password for accessing the KioWare Config ToolSecurity tab - check the Passcode Protect the Configuration Tool box, select the Configuration Tool Passcode setting that becomes available, and enter a passcode
Create list of URLs (browsed during normal KioWare user sessions) to be monitored by KioWare for page hang-ups, and set timeouts for reloading URLs and restarting KioWareSecurity tab, Web App Monitoring List - select the plus icon (to add) or the pencil icon (to edit), and in the popup window that shows, enter a URL to be monitored, set the amount of time that a page hang-up can last before reload is attempted or before KioWare is restarted, and check the checkbox if the URL is a regular expression to match on
Tell KioWare to automatically sign into basic authenticated websitesSecurity tab - Basic Authentication List
Tell KioWare if the file browser or camera (set to take photos and/or video) can/cannot be opened when a file selection button is pressed in the KioWare browserSecurity tab, File Browser, General Options - check/uncheck the Allow File Browser, Allow Photo Capture, and/or Allow Video Capture checkboxes
Allow/block access to external storage devices (external hard drives, USB thumb drives, etc.) in the file browser when the KioWare browser is runningSecurity tab, File Browser, General Options - Allow External Storage Devices
Customize the file browser (set default browsing paths and filters for its folders/files)Security tab, File Browser, Default Browsing Path - use the Path setting to set the default browsing path, and in the Custom File Filter and Custom Directory Filter settings, enter text or file extensions to use as filters (if entering text to use as a regular expression, also check one or both of the File Filter is a Regular Expression/Directory Filter is a Regular Expression checkboxes)
Set up additional browsing path and filters for its folders/filesSecurity tab, File Browser, Additional Browsing Paths - select the plus icon (to add) or pencil icon (to edit), and enter the browsing path and text/file extensions to use as filters (if entering text to use as a regular expression, also check one or both of the Regex checkboxes)
Remove additional browsing pathSecurity tab, File Browser, Additional Browsing Paths - select the minus icon for an additional browsing path entry
Clear existing Wi-Fi (wireless network) access pointsSecurity tab, Wi-Fi Access Point List - check the Clear Known Wi-Fi List checkbox
Automatically scan for a higher priority network when KioWare is already connected to a network in the Wi-Fi Access Point ListSecurity tab, Wi-Fi Access Point List - check the Scan for Higher Priority Networks checkbox
Set the amount of time (in seconds) between each scan for a higher priority network (for both networks that are set to auto-connect and networks that are not)Security tab, Wi-Fi Access Point List - Network Scan Frequency
Set up access points (for logging into a wireless network) that KioWare will store and automatically try to connect toSecurity tab - Wi-Fi Access Point List
Allow users to exit KioWare and shut down the tablet at the same timeSecurity tab - Exit Shutdown Option
Show if there are any issues with the Start on Boot and Exit Shutdown Option settingsAudit tab, Security - Start on Boot/Exit Shutdown Option
Back to Top Navigation Links
Server
Server commands, communication/connection, SSL errors, heartbeats/runtime statistics, GPS data/geofencing, event/statistics/application logs, content updating/auditing, push communication
Server Commands
TaskWhere to Find the Information in This User Guide
Allow KioWare, at set intervals, to “ask” the server if there are any actions to carry outKiosk Management tab - Enable Server Commands
Server Connection/Communication Settings
TaskWhere to Find the Information in This User Guide
Set up KioWare to “talk” with KioWare ServerKiosk Management tab, Server Connection Settings - enter KioWare Server URL, Site Name, Kiosk Name, and Unit Name
Tell KioWare how to handle Secure Socket Layer (SSL) errors when “talking” with your serverKiosk Management tab, Server Connection Settings - Ignore Server SSL Errors
Test the connection between your tablet and KioWare ServerKiosk Management tab, Server Connection Settings - Test Server Connection
When KioWare and KioWare Server are “talking”, tell KioWare Server to “push” a message to the tablet that says a new server command is waiting, and allow the tablet to run the command (even if no other server settings are enabled)Kiosk Management tab, Server Connection Settings - Enable Push Communication
Set the maximum number of times that KioWare will auto-attempt to “talk” to KioWare Server (for sending data to the server) when communication failsKiosk Management tab - Maximum Communication Retry Attempts
Heartbeats
TaskWhere to Find the Information in This User Guide
Allow KioWare to send statistics about its running state to KioWare Server, as a heartbeatKiosk Management tab, Heartbeats - Enable Heartbeat
Set how often a heartbeat will be sent to KioWare ServerKiosk Management tab, Heartbeats - Heartbeat Interval
Allow GPS data to be included in heartbeatsKiosk Management tab, Heartbeats - Enable GPS Data in Heartbeats
Alert KioWare Server when the device running KioWare leaves a specific geographical boundary (geofence)Kiosk Management tab, Heartbeats - Geofencing
Enabling/Monitoring Event Logs
TaskWhere to Find the Information in This User Guide
Allow KioWare to upload its event logs to KioWare ServerKiosk Management tab, Log Monitoring - Enable Logging
Set how often event logs will be uploaded to KioWare ServerKiosk Management tab, Log Monitoring - Time Between Uploads
Select event types to be uploaded to KioWare ServerKiosk Management tab, Log Monitoring - Events to Upload
Event Logs for Statistics
TaskWhere to Find the Information in This User Guide
Allow KioWare to upload its statistics logs to KioWare ServerKiosk Management tab, Stats Logging - Enable Stats Logging
Set how often statistics logs will be uploaded to KioWare ServerKiosk Management tab, Stats Logging - Time Between Uploads
Upload statistics logs to KioWare Server on user session endKiosk Management tab, Stats Logging - Upload on Session End
Content Updating
TaskWhere to Find the Information in This User Guide
Allow KioWare to download from the server any updates to the Config Tool settingsKiosk Management tab, Content Updating - Enable Content Updates
Set the location KioWare will use for downloading updates to Config Tool settingsKiosk Management tab, Content Updating - Content Path
Set KioWare to check for and download Config Tool updates daily or at regular intervalsKiosk Management tab, Content Updating - Schedule Type
Set how often (in minutes) that KioWare checks for any Config Tool updates and loads themKiosk Management tab, Content Updating - Content Update Interval
Set the time and day(s) that KioWare checks for any Config Tool updates and loads themKiosk Management tab, Content Updating - Schedules
Allow KioWare to check that all files were downloaded and stored without errors (content auditing)Kiosk Management tab, Content Updating, Content Auditing - Enable Content Audits
Set the time and day(s) that content auditing will occurKiosk Management tab, Content Updating, Content Auditing - Schedules
Setup for Content Updating
TaskGeneral Steps and Where to Find Related Information
Set up your tablet (KioWare Config Tool) for content updating
  1. Open the Config Tool and enter all content update settings (see Kiosk Management tab, Content Updating in this user guide).
  2. Save Config Tool settings to a settings file (see Configuration Toolbar, Export Settings in this user guide).
Set up your server for content updating
  1. Load KioWare Server (see Installation in the KioWare Server user guide).
  2. Set up Internet Information Services (IIS) for content updating (see Content Updating, Useful Knowledge, Important IIS Setup in the KioWare Server user guide).
Create files for use in content updating
  1. Create a batch file to run during content updating (see Content Updating, Updating KioWare Client Settings in the KioWare Server user guide).
  2. Place batch file and settings file in the same directory on your server.
Set up KioWare Server for content updatingThe steps below refer to sections in the KioWare Server user guide:
  1. Set up File Server Host and URL Base Path (see Site Management Tab, Site Settings).
  2. Create a new revision (see Content Updating, Revisions).
  3. Assign the batch file and settings file to the new revision (see Content Updating, Files Tab).
  4. Set the client path to the location where the batch file and settings file are stored (see Content Updating, Update Client Paths).
  5. Set any actions to be performed after the tablet downloads updates (see Content Updating, File Actions).  You will want to set the action of the batch file to ServiceCommand.
  6. Assign the new revision to a kiosk and wait for the update to occur (see Kiosk Management, Utilities Tab, Kiosk Settings, Content Revisions Tab).  (If using groups, assign the revision via Group Management Tab, Group Settings.)
Event Logs for KioWare Custom Data
TaskWhere to Find the Information in This User Guide
Allow KioWare to upload custom data in its application logs to KioWare ServerKiosk Management tab, Custom App Logging - Enable App Logging
Set how often (in minutes) that application logs with custom data will be uploaded to KioWare ServerKiosk Management tab, Custom App Logging - Time Between Uploads
Upload application logs with custom data to KioWare Server on user session endKiosk Management tab, Custom App Logging - Upload on Session End
Back to Top Navigation Links
Tablet
Auto-run KioWare, Android browser/default browser, screen orientation/sleep/schedule, status bar, toolbar buttons, popup windows, running only one application, show/hide toast messages when any part of the OS is blocked, audit of settings
TaskWhere to Find the Information in This User Guide
Auto-run KioWare when the tablet bootsGeneral tab - Start on Boot
Enable/disable the Android browser's built-in zoomBrowser tab - Enable Browser Zoom
Set the Android browser's initial zoomBrowser tab - Default Zoom
Enable/disable the Android browser's HTML 5.0 geolocation featureBrowser tab - Enable Browser Geolocation
Set the tablet's screen orientationGeneral tab, Screen Settings - Screen Orientation
Set the tablet's sleep modeGeneral tab, Screen Settings - Prevent Screen Sleep
Set up a schedule for the tablet's screen to automatically turn on and offGeneral tab, Screen Settings - Screen Schedule
Edit a tablet's screen scheduleGeneral tab, Screen Settings, Schedules - select the pencil icon for a screen schedule
Delete a tablet's screen scheduleGeneral tab, Screen Settings, Schedules - select the minus icon
Set a repeat pattern (recurrence) for the tablet's screen to turn on and offGeneral tab, Screen Settings, Schedules - select the plus icon (to add) or pencil icon (to edit), and select the Set Recurrence Mode button
Hide the tablet's system bar until the bottom of the screen is touchedUser Interface tab - Use Immersive Mode
Use the tablet's Back button to move backward in KioWareUser Interface tab - Enable Android Back Arrow
Use the tablet's Home button to go to KioWare's home pageUser Interface tab - Enable Android Home Button
Hide all popup windows that are generated from the tabletSecurity tab - Hide System Dialogs
Prevent items on the tablet's status bar from being opened when running KioWareSecurity tab - Disable Status Bar
Show if there are any issues with the Disable Status Bar and Enable Device Administrator settingsAudit tab, Security - Disable Status Bar
Set if the tablet's Home button should leave KioWare or continue displaying it (Selected Home App)Security tab - Selected Home App
Show if there are any issues with the Selected Home App settingAudit tab, Security - Selected Home App
Set up the tablet to run only one application (that is not KioWare)Security tab, Application Manager, Single application Mode - check Enable Single Application Mode box and make a selection from the Application option
Tell the tablet's operating system which browser to use when third-party application links are selected and KioWare is not runningSecurity tab, Default Browser
Show/hide Android toast messages (notification messages) that fade in/out when users attempt to access any blocked feature of the operating system (OS)Security tab - Show Blocked Messages
Back to Top Navigation Links
User Session and Activity/Inactivity
Auto-end session, alerts, overriding default time-outs, controlling session with user presence devices, setting max time a session will run before auto-ending, setting a URL to show on session end and before Attract mode begins, setting default screen brightness for session end, audit of settings
TaskWhere to Find the Information in This User Guide
Auto-end user session during idle timeAttract/Inactivity tab, Inactivity Timers - Default Inactivity Timer
Display alert that session will soon endAttract/Inactivity tab, Inactivity Timers - Session End Warning
Set when the session end alert will displayAttract/Inactivity tab, Inactivity Timers - Session End Dialog Warning Time
Override the default inactivity timer on specific pages or domains (custom timeouts)Attract/Inactivity tab, Inactivity Timers - select the plus icon for the Custom Timeouts option
Change the order of custom timeoutsAttract/Inactivity tab, Inactivity Timers - press and drag any entry listed under the Custom Timeouts option
Make third-party application activity register as user activity in KioWare (Inactivity/Activity Service)Attract/Inactivity tab, Inactivity Timers - Inactivity/Activity Service
Show if there are any issues with the Inactivity/Activity Service setting and if any third-party applications are enabledAudit tab, Attract/Inactivity - Accessibility Service
Automatically enable/disable the Inactivity/Activity Service when installing KioWareInstallation and Requirements, Installation Instructions, Provisioning
Allow user presence devices to tell KioWare when to begin or end a user session based on how close a user is to the kiosk or tabletAttract/Inactivity tab, User Presence Device Configuration - select the Proximity Sensor, Larco Keyboard Wedge, or ProxSonar option under the User Presence Device Type setting
Tell KioWare the max time a user session can run before automatically endingAttract/Inactivity tab, Session End - Time Limited Sessions
Set up a URL (or file path) to show when a user session ends, but before Attract mode beginsAttract/Inactivity tab, Session End - Session End URL
Specify the amount of time the URL (or file path) will show after a user session endsAttract/Inactivity tab, Session End - Session End Time
Tell KioWare what screen brightness level to use whenever a user session endsAttract/Inactivity tab, Screen Brightness - check the Reset Screen Brightness on Session End checkbox, and then use the Default Screen Brightness option to set the default brightness
Back to Top Navigation Links

Scripting for KioWare

KioWare for Android allows the use of JavaScript.  You can use JavaScript commands to tell KioWare for Android to complete special actions.  For more details on how to do this, see Scripting.

CustomToolbarCode.js has been added to the UserData directory (see image below).  It is installed automatically, and developers can use this for browser and toolbar customization via JavaScript.

CustomToolbarCode in the UserData directory