whatisgithub

What is kiosk-browser?

ghuyphan/kiosk-browser — explained in plain English

Analysis updated 2026-05-18

24JavaAudience · ops devopsComplexity · 2/5Setup · easy

In one sentence

An Android kiosk app that locks a device into full screen browsing of one configured website, with remote cursor control from another device.

Mindmap

mindmap
  root((kiosk-browser))
    What it does
      Auto launch URL
      Lock to one site
      Remote cursor control
    Tech stack
      Android
      Java
      WebView
    Use cases
      Queue displays
      Info screens
      Waiting rooms
    Audience
      Ops teams
      Facility managers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a permanent queue display or information screen on a wall mounted tablet.

USE CASE 2

Lock a public kiosk to one website with HTTPS only navigation enforced.

USE CASE 3

Remotely control a mounted display's browser using a QR code paired phone.

What is it built with?

JavaAndroidWebView

How does it compare?

ghuyphan/kiosk-browserawrsha/garden-remote-controllericysymmetra/tiktok-patches-for-morphe
Stars242323
LanguageJavaJavaJava
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audienceops devopsdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

A prebuilt APK is available from GitHub releases, building from source needs Android Studio.

So what is it?

Kiosk Browser is an Android app designed for situations where a tablet, display screen, or other device needs to permanently show a single website: queue management dashboards, wall-mounted information displays, waiting room screens, and similar setups. It opens a configurable URL automatically every time it launches, so the device boots straight into the desired page without any extra steps. The toolbar with the address bar and navigation buttons hides itself automatically during normal use and can be revealed by pulling down on the page. The app supports the full set of browser controls you would expect: back, forward, reload, home, find in page, and a desktop-site toggle. It enforces HTTPS-only navigation, meaning regular HTTP addresses are blocked for security. Automated session-clearing policies can wipe cookies and storage on a schedule, which is useful for shared public devices. Optional Android screen pinning and startup-domain restriction can lock the device to just the configured site. One feature stands out: a built-in remote control system. From another device on the same network, you scan a QR code shown in the browser's menu, and you can then move a cursor on the kiosk screen, tap, scroll, type, and navigate, without any screen mirroring. This is useful for managing displays that are physically mounted out of easy reach. The app has no ads, no analytics, no required accounts, and no third-party runtime dependencies beyond Android System WebView, which is the Chromium-based browser component that ships with Android. It supports Android 6.0 and newer. A prebuilt APK is available from the project's GitHub releases page, and the source can be built with Android Studio using a standard Gradle command.

Copy-paste prompts

Prompt 1
Help me configure kiosk-browser to auto launch a specific URL on device boot.
Prompt 2
Walk me through setting up the QR code remote control to manage a wall mounted display from my phone.
Prompt 3
Explain how to enable Android screen pinning so the kiosk cannot be exited.
Prompt 4
Show me how to build the APK from source using the Gradle command.

Frequently asked questions

What is kiosk-browser?

An Android kiosk app that locks a device into full screen browsing of one configured website, with remote cursor control from another device.

What language is kiosk-browser written in?

Mainly Java. The stack also includes Java, Android, WebView.

How hard is kiosk-browser to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is kiosk-browser for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.