UNFPA TME • Kiosk

Overview

Fullscreen kiosk deployment for unfpa_tme — a locked-down Raspberry Pi (Debian) running Chromium in kiosk mode against tuneme.org, with HDMI auto-detection, idle video screensavers, and custom kiosk extensions.

Platform: Raspberry Pi aarch64 Display: 1920×1080 HDMI kiosk

Key Components

mkiosk/ — Main kiosk launcher, failover, HDMI setup, and screensaver integration
- auto-display-setup.sh — Primary boot script (waits for X, detects output, launches Chromium kiosk)
- failover.sh — Session watchdog / recovery
- screensaver/ — Idle detection + video playback (VLC / mplayer)
fixes/ — Chromium kiosk hardening extensions (tab-blocker, popup control, content filters on tuneme.org)
Utilities: capture_logs.py, combine.py (background image composer), inspect.py, dump_dom.py

Quick Start (on the Pi)

git clone https://github.com/catchupweb/unfpa_tme.git
cd unfpa_tme
./mkiosk/auto-display-setup.sh

See mkiosk/README.md and screensaver/TWEAKING_GUIDE.md for details.

Assets & Files

README.md mkiosk/ directory fixes/ (extensions) screenshot.png new_background.png unfpa.jpeg tuneme.jpeg

Production Notes

Chromium is launched with extensive flags for stability, no popups, no tabs, forced scale.
Video screensaver activates on idle; multiple playback backends supported (cvlc, mplayer).
Custom extensions block unwanted tabs / UI elements while on the TuneMe site.