45 lines
2.7 KiB
Markdown
45 lines
2.7 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
|
|
|
|
## Hardware
|
|
|
|
Not all hardware works perfectly with the Pi, so you'll want to do some digging. The product links are a configuration that's known to work, though:
|
|
|
|
* Raspberry Pi 2 or 3 ([verkkokauppa.com](https://www.verkkokauppa.com/fi/product/4657/fjxtn/Raspberry-Pi-2-model-B-yhden-piirilevyn-tietokone))
|
|
* 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.1/chilipie-kiosk-v1.1.img.zip`
|
|
1. `$ unzip chilipie-kiosk-v1.1.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.1.img of=/dev/disk2` to flash the card
|
|
1. Grab a coffee, this will take a while (e.g. 60 minutes on a MBP and a Class 10 card)
|
|
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).
|