Skip to content

weblauncher is an android launcher which only displays a website, made for kiosk purposes.

License

Notifications You must be signed in to change notification settings

programminghoch10/weblauncher

Repository files navigation

weblauncher

Weblauncher is a startscreen launcher which only displays a website, made for kiosk purposes.

Please read the install procedure for proper install and use! The download link is at the end of it.

This version is made only for rooted devices!

Soon it will be usable on unrooted devices too.

Features:

  • 2 webpages switchable using volume keys
  • reload webpage using volume keys
  • always uses current webpage due to disabled cache
  • auto enables wifi if disabled
  • full screen
  • acts as app launcher to be the only usable application (kiosk mode)
  • pulls website settings from build.prop (rooted device needed/subject to change)

Install

  1. Install the app by downloading on target device or by pushing via adb
  2. set the build.prop parameters "com.JJ.weblauncher.page1.url" and "com.JJ.weblauncher.page2.url" to the wished 2 websites you want to be used (and reboot)
  3. test the app by launching the weblauncher through your launcher
  4. if everything works fine set weblauncher as default launcher
  5. for complete kiosk mode disable apps like system settings, camera and other apps which may be launched using lockscreen, keys or the notification bar using adb and the pm disable command
  6. You're done!

Download APK

build.prop parameters

Website configuration parameters within the build.prop need to match this scheme:

com.JJ.weblauncher.pageX.parameter

pageX can either be page1 to modify the first website or page2 to modify the second website.

parameter can be one of the following:

Parameter Type Description Default Value
enabled Boolean Wether this page is enabled true
url String The URL of the Website shown, remember the leading http:// about:blank
interact Boolean Wether this page is interactable true
unload Boolean Wether the Website should be unloaded, when the other page is shown (it will reload to URL when its visible again) false
js Boolean Wether to enable JavaScript on the Website true
cache Boolean Wether to enable Caching for the Website (Recommended: false) false
haptic Boolean Wether Haptic Feedback is enabled on the Website false
back Boolean Wether the back button can be used on the Website false
useragent String The useragent string weblauncher should report to the website (device default)

Other parameters:

Parameter Type Description Default Value
com.JJ.weblauncher.WiFi.keepon Boolean Wether app will reactivate WiFi, when disabled by user (only enabled, when weblauncher is set as android home launcher) false
com.JJ.weblauncher.startpage Integer Which page to display when starting: 0 = no page, 1 = Page1, 2 = Page2 0
com.JJ.weblauncher.display.keepon Boolean Wether to keep screen on false

Problems

I always try to keep everything working flawlessly. But sometimes it's just not in my hands.

  • Android 5 might have issues regarding JS processing

If you find other issues (not listed here) I'll be happy to take a look at them. Please report them in this repo's issues.

How to properly make a kiosk

Here will be a section explaining how to properly use kiosk with this app soon.