# chilipie-kiosk

**Raspberry Pi** image for booting directly into **full-screen Chrome**. Perfect for dashboards and build monitors. Main features:

* **Boots directly to full-screen Chrome** - with all the features of a modern browser
* **No automatic updates** - no surprises due to Chrome (or other packages) suddenly updating
* **Automatic crash-recovery** - accidentally unplugging your kiosk won't result in "Chrome did not shut down correctly :("
* **Custom startup graphics** - displays [customizable graphics](home/background.png) while the browser is starting up
* **Lightweight window manager** - uses [Matchbox](https://www.yoctoproject.org/tools-resources/projects/matchbox) for minimal clutter and memory footprint
* **HDMI output control** - ready-made scripts for e.g. turning off the display outside of office hours
* **Cursor hiding** - if you leave a mouse plugged in, the cursor is hidden after a brief period of inactivity
* **Based on a recent Ubuntu** - if you want to add your own hacks, all the expected packages are one `apt-get` away
* **Batteries included** - the most common how-to's have been collected to the [first-boot document](first-boot.md)

## Hardware

Not all hardware works perfectly with the Pi, so to save you some digging, here's a (non-exhaustive!) list of configurations *known to work*:

* Recommended kits (let us know of others!)
    * Raspberry Pi 3 Starter Kit ([amazon.de](https://www.amazon.de/Vilros-Raspberry-Pi-Complete-Kit---Enthalt/dp/B01DC6MKAQ), [verkkokauppa.com](https://www.verkkokauppa.com/fi/product/38619/gxgmc/Raspberry-Pi-3-model-B-aloituspakkaus))
* Components bought separately (let us know of others!)
    * Raspberry Pi 2 or 3 ([verkkokauppa.com](https://www.verkkokauppa.com/fi/product/4657/fjxtn/Raspberry-Pi-2-model-B-yhden-piirilevyn-tietokone))
    * [Compatible](http://elinux.org/RPi_SD_cards) 8+ GB microSD card ([verkkokauppa.com](https://www.verkkokauppa.com/fi/product/6501/dcmkv/Transcend-8GB-microSDHC-muistikortti-Class-10))
    * Micro-USB power source (most people will have these laying around)
    * Display cable, either
        * Regular HDMI for televisions, or
        * HDMI-to-DVI for computer displays
    * Optional extras
        * Case for the Pi ([verkkokauppa.com](https://www.verkkokauppa.com/fi/product/52391/fcrhq/Raspberry-Pi-muovikotelo-Raspberry-Pi-B-Pi-2-tietokoneille-l)) - if you're worried about looks and/or gathering dust
        * USB WiFi-dongle ([verkkokauppa.com](https://www.verkkokauppa.com/fi/product/41271/dqnbc/Asus-USB-N10-Nano-WiFi-adapteri)) - if you can't get ethernet, which will usually be more reliable

## Software

Preparing the image is easy. Assuming you're on OS X:

1. `$ wget https://github.com/futurice/chilipie-kiosk/releases/download/v1.2/chilipie-kiosk-v1.2.img.zip`
1. `$ unzip chilipie-kiosk-v1.2.img.zip`
1. Insert your microSD card
1. `$ diskutil list` to check the correct device
1. `$ diskutil unmountDisk /dev/disk2` to prepare it for imaging
1. `$ sudo dd bs=1m if=chilipie-kiosk-v1.2.img of=/dev/rdisk2` to flash the card
1. Grab a coffee, this will take a while
1. `$ diskutil unmountDisk /dev/disk2` to safely eject the card
1. Insert the microSD card to your Pi and power it up!

The first boot should land you [here](first-boot.md).