About piscreen

piscreen is a small, Chromium based, Kiosk/Digital Signage solution for the Raspberry Pi.

The difference to other signage-software like Screeny OSE is that it supports just one static URL that it displays - but it provides nice error screens when your network/the internet is not reachable.

Installation

1. Preparing the SD card

Get the latest Rasbpian for your Raspberry Pi and write it to the SD card with dd (on Linux & Mac):
```
 dd bs=1M if=raspbian.img of=/dev/sdX
```

You can also write to the SD card with Win32DiskImager if you are using Windows.

Insert the SD in the Raspberry Pi and power it on

2. Basic (manual) Updating & Configuration

Log in as pi with the Password: raspberry. If the password doesn't work look in the Pi FAQ.
A basic auto-configuration tool should appear (if not, start raspi-config).

Set your keyboard-layout, timezone, overscan-settings (if you see black borders on your screen), overclock (tip: use Medium) and resize the root partition. A reboot should happen. After the resizing login again.

Update the System

 apt-get update
 apt-get -y dist-upgrade

If a conflict happens for any file press Y.

Reboot the Pi: reboot

3. Setup the automatic installation

Login again as pi.
Run the automatic installer: wget https://raw.githubusercontent.com/ZaneMiller/piscreen/master/install.sh && sudo bash ./install.sh [default url] NOTE: You must replace [default url] with the url the display should launch to.
After the installation is complete check to make sure there were no errors. If you wish to add a splash screen add the image to /etc/splash.png.
Assuming no errors occured you may restart the Pi.

4. Test and run

Insert the SD card back into the Raspberry Pi and power it on. It should now boot, open chrome in fullscreen with your desired URL.

To shutdown it nicely, press ALT+F4, rightclick, choose Terminal and enter sudo poweroff.

Todo

Read the hostname from piscreen.txt and set it on boot.
Support proxies
Add nicer shutdown button

Thanks

Screeny OSE and the Raspberry Pi forums for the inspiration.

hexxeh for the RPi Binaries of Chromium.

pcunning / piscreen