Giter VIP home page Giter VIP logo

chilipie-kiosk's Introduction

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 while the browser is starting up
  • Lightweight window manager - uses 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

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!)
  • Components bought separately (let us know of others!)
    • Raspberry Pi 2 or 3 (verkkokauppa.com)
    • Compatible 8+ GB microSD card (verkkokauppa.com)
    • 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) - if you're worried about looks and/or gathering dust
      • USB WiFi-dongle (verkkokauppa.com) - if you can't get ethernet, which will usually be more reliable

Software

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

  1. Download and unzip the latest image
  2. Insert your microSD card
  3. $ diskutil list to check the correct device
  4. $ diskutil unmountDisk /dev/disk2 to prepare it for imaging
  5. $ sudo dd bs=1m if=chilipie-kiosk-v1.2.1.img of=/dev/rdisk2 to flash the card
  6. Grab a coffee, this will take a while
  7. $ diskutil unmountDisk /dev/disk2 to safely eject the card
  8. Insert the microSD card to your Pi and power it up!

The first boot should land you here.

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, 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.
  • 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.

chilipie-kiosk's People

Contributors

jareware avatar thibmaek avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.