Skip to content

Install Android Tablet

dlomm edited this page Oct 23, 2026 · 1 revision

Android tablet kiosk app

A tiny Android app (see android/) that runs your wall's tablet page — /tablet/<wall-slug> — as a true kiosk: fullscreen, screen always on, auto-reconnecting when the server restarts. It works for /wall/<slug> on an Android TV stick too.

Get the APK

Every release attaches it: download kegwall-tablet.apk from the latest release — or directly from https://github.com/dlommm/Kegwall/releases/latest/download/kegwall-tablet.apk. (For a branch test build, run the Publish workflow from the Actions tab with no tag; the APK lands as a workflow artifact.)

Install on the tablet

  1. Copy the APK to the tablet (USB, a file-share, or just open the release download URL above in the tablet's browser).
  2. Open the APK from the Files app. Android will ask to allow installs from that source ("Install unknown apps") — allow it for the Files app/browser you used.
  3. Launch Kegwall, enter your tablet URL (e.g. http://192.168.1.50:8080/tablet/main), tap Start kiosk.

Change the URL later: tap the top-left corner of the screen 5 times within 3 seconds.

Camera permission (face sign-in)

If you use face sign-in, the app requests the Android camera permission on first launch — a normal system permission dialog, grant it there. If you deny it (or the tablet has no camera at all), the tablet page just falls back to the normal avatar grid; nothing crashes and face sign-in is simply unavailable. If you change your mind later, grant it from Android's own Settings → Apps → Kegwall → Permissions → Camera; no reinstall needed.

Make it survive a party (recommended)

  • Screen pinning (Settings → Security → App pinning): pin Kegwall so Home/Recents gestures don't leave the kiosk. Unpin needs the lock PIN.
  • Plug the tablet in — the app keeps the screen on, which eats battery otherwise.
  • Optional: set Kegwall as the launcher via any "kiosk launcher" app if the tablet is fully dedicated.

Updates

Without a signing key, CI produces only branch test builds — debug-signed APKs whose signature changes every build, so Android refuses to install an update over the old one — uninstall Kegwall first, then install the new APK. (Your saved URL is lost on uninstall; it's one field.)

To make updates install over the top, set up a signing key once:

keytool -genkeypair -v -keystore kegwall-kiosk.keystore -alias kegwall \
  -keyalg RSA -keysize 2048 -validity 10000
base64 -i kegwall-kiosk.keystore | pbcopy   # macOS; use `base64 -w0` on Linux

Then add four repository secrets on GitHub (Settings → Secrets and variables → Actions → New repository secret): ANDROID_KEYSTORE_B64 (the base64 you just copied), ANDROID_KEYSTORE_PASS, ANDROID_KEY_ALIAS (kegwall), ANDROID_KEY_PASS. From the next build on, the job produces (and every release requires) a release-signed APK with a stable signature. Keep the keystore file safe — losing it means one final uninstall/reinstall cycle with a new key.

Notes

  • The app allows plain-HTTP on purpose (usesCleartextTraffic) — Kegwall is a LAN-first, no-TLS-by-design server (see docker.md).
  • Nothing app-specific is native: it's the same web tablet page, so features arrive with normal server updates — the APK only needs updating if the shell itself changes.

Mirrored from docs/install/android-tablet.md. Edit the repo copy; this page is regenerated from it.

Clone this wiki locally