└── readme.md


/readme.md:
--------------------------------------------------------------------------------
 1 | # Create Raspberry Pi Kiosk on Raspbian Debian Jessie #
 2 | With this tutorial you can create a 'fullscreen kiosk' which shows a webpage. This webpage will run in chromium. 
 3 |  
 4 | ## Install Raspbian Debian Wheezy ##
 5 | 
 6 | The first step is to install Raspbian on the Raspberry Pi. There are 2 ways to do this.
 7 | 
 8 | - via the Raspberry Pi NOOBS image. (https://www.raspberrypi.org/downloads/raspbian/ Install the NOOBS image and install Raspbian via the NOOBS install manager
 9 | 
10 | At the end you need a fresh Raspbian Debian Jessie installed on your Raspberry Pi.
11 | 
12 | ## Configure Raspbian Jessie ##
13 | 
14 | Raspbian will boot the GUI automatically. Next, boot up the terminal. We need to update the respositories:
15 | 
16 | ```
17 | sudo apt-get update
18 | sudo apt-get upgrade
19 | ```
20 | 
21 | Then we need to install unclutter, to hide the mouse;
22 | 
23 | ```
24 | sudo apt-get install unclutter
25 | ```
26 | 
27 | Then we will start the rasps-config tool by calling the command `sudo raspi-config`
28 | 
29 | - Update the Raspi config tool (Advanced Options)
30 | - Disable overscan. This option tries to adjust the resolution for your Raspberry Pi. But it will only f**k things up :) (Advanced Options)
31 | - Enable SSH when you want to proceed the configure process threw SSH (Advanced Options) This is optional.
32 | 
33 | When calling the update and upgrade commands chromium will also be installed. 
34 | 
35 | When booting the kiosk we want to automatically start the browser and show the kiosk page. We will do this by editing the autostart file.
36 | This file can be found at `~/.config/lxsession/LXDE-pi/autostart`
37 | 
38 | First we ill comment out the @xscreensaver line by  adding a hashtag (#) and the beginning of the line. Add the next lines to the file:
39 | 
40 | ```
41 | @xset s off
42 | @xset s noblank
43 | @xset -dpms
44 | 
45 | @chromium-browser --noerrdialogs --kiosk --incognito http://www.domain.com/to/kiosk/page
46 | or
47 | @chromium-browser --noerrdialogs --disable-session-crashed-bubble --disable-infobars --kiosk http://www.domain.com/to/kiosk/page
48 | 
49 | ```
50 | 
51 | 
52 | The @xset options will disable the energy-options from the X-server so the screen won't be shut down after a x amount of time.
53 | The @sed line will prevent errors to be shown.
54 | And finally Chromium will be startup in kiosk mode (with no error messages). 
55 | Change the url to the url you want it to show. Local files are also possibly.
56 | 
57 | Now Chromium will start after the raspberry pi is booted up and will show the webpage.
58 | 
59 | ## Good to know ##
60 | - default Raspbian login: user: pi pass: raspberry
61 | - the GPU of the Pi isn't that powerful. So animations in the browser don't really run smoothly. 
62 | 
63 | 
64 | ## Sources ##
65 | 
66 | - http://www.raspberrypi-spy.co.uk/2014/05/how-to-autostart-apps-in-rasbian-lxde-desktop/
67 | - http://www.danpurdy.co.uk/web-development/raspberry-pi-kiosk-screen-tutorial/
68 | - https://blog.reboost.net/kiosk-display-on-raspbian-jessie/
69 | - http://www.raspberrypi-spy.co.uk/2014/05/how-to-autostart-apps-in-rasbian-lxde-desktop/
70 | 


--------------------------------------------------------------------------------