• Stars
    star
    1,284
  • Rank 36,642 (Top 0.8 %)
  • Language
    HTML
  • License
    MIT License
  • Created almost 9 years ago
  • Updated over 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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.

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
  • 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 - accidental unpowering won't result in "Chrome did not shut down correctly :("
  • Custom startup graphics - displays customizable graphics instead of console messages during startup
  • Lightweight window manager - uses Matchbox for minimal clutter and memory footprint
  • HDMI output control - ready-made scripts for turning off the display outside of office hours, for example
  • Cursor hiding - if you leave a mouse plugged in, the cursor is hidden after a brief period of inactivity
  • Automatic reboots - reboots the Pi nightly, when nobody's watching, to keep it running smoothly
  • Based on a recent Debian - if you want to add your own tweaks, all the expected packages are one apt-get away
  • Batteries included - the most common how-to's and ProTips have been collected to the first-boot document

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

  • I get a kernel panic on boot, or the image keeps crashing. The Raspberry Pi is somewhat picky about about its SD cards. It's also possible the SD card has a bad sector in a critical place, and dd wasn't be able to tell you. Double-check that you're using a blessed SD card, and try flashing the image again.
  • I see a "rainbow square" or "yellow lightning" in the top right corner of the screen, and the device seems unstable. This usually means the Pi isn't getting enough amps from your power supply. This is sometimes the case in more exotic setups (e.g. using the USB port of your display to power the Pi) or with cheap power supplies. Try another one.
  • The display control scripts don't turn off the display device. Normal PC displays will usually power down when you cut off the signal, but this is not the case for many TV's. Please check if your TV has an option in its settings for enabling this, as some do. If not, you can try your luck with HDMI CEC signals, but the TV implementations of the spec are notoriously spotty.
  • The MicroSD card isn't flashing correctly, I don't see the boot partition. This commonly happens on Windows computers and can be fixed by extracting the chilipie*.img file from the tar.gz. You will need to use an extraction tool that supports both gzip and tar archive formats, such as 7zip. Extract the contents of the img.tar.gz file, then extract the contents of the resulting img.tar file again. You should be left with an .img file, which you can then use with Etcher to flash your SD card.

Acknowledgements

This project is a grateful recipient of Futurice Open Source sponsorship. Thank you. ๐Ÿ™‡

More Repositories

1

css-architecture

8 simple rules for a robust, scalable CSS architecture
2,487
star
2

docker-volume-backup

Utility container for periodically backing up Docker volumes
Shell
550
star
3

css-ns

Dead-simple CSS namespaces
JavaScript
116
star
4

flotate

A portmanteau of flow and annotate, allows using the Flow type checker with standard JavaScript syntax, through inline annotation comments.
JavaScript
108
star
5

viewports

_viewports.scss is a SASS microlibrary that makes it easier to manage media queries in responsive layouts. There's a live demo at:
CSS
54
star
6

howto

Documenting useful things, lest I forget, and sharing is caring
38
star
7

pointing-fingers

Simple tool for tracking changes to an upstream API as part of your test suite
JavaScript
34
star
8

xpath2rss

A simple web scraper for querying HTML documents with XPath and turning the results into an RSS feed.
PHP
19
star
9

terraform-utils

HCL
14
star
10

backbone-touchbind

JavaScript
12
star
11

fuzzing-redux-prese

Using fuzzing/property based testing to find bugs in a React/Redux application
TypeScript
8
star
12

el-js

Utility function for generating HTML/XML DOM trees in the browser.
JavaScript
7
star
13

JSON-DTO

A simple JSON-DTO-binding module for the Play! Framework
Java
5
star
14

ffmpeg

Docker-wrapper for ffmpeg from the Ubuntu Multimedia packages
4
star
15

lambda-multicast-proxy

Use AWS Lambda to proxy requests to one or more upstream endpoints
TypeScript
4
star
16

postcss-demo

JavaScript
3
star
17

gdoc-tex-utils

Collection of small utils for wrangling Google Docs (text) documents into LaTeX ones
JavaScript
3
star
18

JSONCache

HTML5's localStorage caching layer for fetching JSON data with jQuery.
JavaScript
2
star
19

dockerized-demoapp

JavaScript
1
star
20

lightening

The lightening! It's happening!
TypeScript
1
star
21

weightwatcher

Super simple app for tracking & plotting software project source metrics
JavaScript
1
star
22

futuhours-ui-next

JavaScript
1
star