Home

Awesome

chilipie-kiosk

Easy-to-use Raspberry Pi image for booting directly into full-screen Chrome, with built-in convenience features for unattended operation. Perfect for dashboards and build monitors.

Features

Screenshots

▲ Customizable, full screen        ▲ Boots directly into a simple     ▲ WiFi & other system config
      startup graphics                  getting started -guide          is just one keypress away

Getting started

  1. Check that you have compatible hardware.
  2. Download the latest image.
  3. Decompress it.
  4. Flash the image onto your SD card. We recommend Etcher for this: it's delightfully easy to use, cross platform, and will verify the result automatically. If you know what you're doing, you can of course also just sudo dd bs=1m if=chilipie-kiosk-vX.Y.Z.img of=/dev/rdisk2.
  5. Optional: Set URL before boot
  6. Optional: Setup automatic WiFi
  7. Insert the SD card to your Pi and power it up.
  8. You should land in the first-boot document, for further instructions & ideas.

Set URL before boot

  1. After flashing remount your SD card.
  2. Create a chilipie_url.txt in your SD cards boot folder or /home/pi.
  3. Write URL in first line of file.

Note: You can user ${SERIAL} to get Pi's serial number into URL.

Automatic WiFi setup

  1. After flashing remount your SD card.
  2. Create a wpa_supplicant.conf in your SD cards boot folder
  3. Copy the sample wpa_supplicant.conf file into the boot folder on the SD card.
  4. Replace WiFi-SSID and WiFi-PASSWORD with your WiFi configuration.
  5. Optional: Set the country code to your country code e.g. DE.

Sample wpa_supplicant.conf

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=US

network={
  ssid="WiFi-SSID"
  psk="WiFi-PASSWORD"
  key_mgmt=WPA-PSK
}

Hardware

Works with all Raspberry Pi versions. Versions 3 and 4 are recommended, though, since the smaller ones can be a bit underpowered for rendering complex dashboards. The 3 and 4 also come with built-in WiFi, which is convenient (though both official and off-the-shelf USB WiFi dongles can work equally well).

Make sure you have a compatible 4+ GB SD card. In general, any Class 10 card will work, as they're fast enough and of high enough quality.

The Pi needs a 2.5 Amp power source. Most modern USB chargers you'll have laying around will work, but an older/cheaper one may not.

Common issues

Acknowledgements

This project is a grateful recipient of Futurice Open Source sponsorship. Thank you. 🙇