# mkiosk

Part of the **UNFPA TME** deployment — *United Nations Population Fund · Technical & Monitoring Environment*.

## Overview

`mkiosk` powers the fullscreen touchscreen kiosk on `unfpa_tme`. It handles HDMI detection, Chromium launch, screensavers, and session recovery for the TuneMe display at `https://tuneme.org/#/home`.

## Key Scripts

| Script | Description |
|---|---|
| `auto-display-setup.sh` | Boot entry — detects HDMI, sets resolution, launches Chromium kiosk |
| `failover.sh` | Restarts the kiosk session on failure |
| `setup_video_screensaver.sh` | Configures idle video screensaver |
| `setup_idle_video_screensaver.sh` | Idle detection + screensaver integration |
| `video_screensaver.sh` | Screensaver launcher |

## Screensaver

The `screensaver/` directory contains idle detection, video playback (VLC/mplayer), and watchdog scripts. See `screensaver/TWEAKING_GUIDE.md` for configuration details.

## Usage

```bash
# Launch kiosk display
./auto-display-setup.sh

# Set up idle video screensaver
./setup_idle_video_screensaver.sh
```

## Related

- Root repo: [catchupweb/unfpa_tme](https://github.com/catchupweb/unfpa_tme)
- Browser extension: `../fixes/tab-blocker/`

## Author

**Catchupweb**  
📧 [nsanasey@catchupweb.co.za](mailto:nsanasey@catchupweb.co.za)