51 lines
3.9 KiB
Markdown
51 lines
3.9 KiB
Markdown
# 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).
|
|
|
|
## 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` won't be able to tell you. Double-check that you're using [a blessed SD card](http://elinux.org/RPi_SD_cards), and try flashing the image again.
|
|
* **I see a "rainbow square" in the top right corner of the screen, and the device seems unstable.** This usually means the Pi isn't getting enough voltage 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. |