Skip to content
This repository has been archived by the owner on Apr 19, 2021. It is now read-only.

Commit

Permalink
finished version
Browse files Browse the repository at this point in the history
  • Loading branch information
basdegroot committed Mar 21, 2015
1 parent 1c4c412 commit d26cafc
Showing 1 changed file with 48 additions and 7 deletions.
55 changes: 48 additions & 7 deletions readme.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
#Create Raspberry Pi Kiosk on Raspbian Debian Wheezy#
## Install Raspbian Debian Wheezy ##
With this tutorial you can create a 'fullscreen kiosk' which shows a webpage. This webpage will run in chromium.
## Install Raspbian Debian Wheezy ##

The first step is to install Raspbian on the Raspberry Pi. There are 2 ways to do this.

Expand All @@ -11,14 +11,55 @@ At the end you need a fresh Raspbian Debian Wheezy installed on your Raspberry P

##Configure Raspbian Debian Wheezy##

When starting Raspbian for the first time you will see the Raspi Config tool. There are a few things you need to configure.
When starting Raspbian for the first time you will see the Raspi Config tool.
If it doesn't start automatically, you can do it manually with `sudo raspi-config`.
There are a few things you need to configure in raspi-config:

- Update the Raspi config tool (Advanced Options)
- Enable SSH when you want to proceed the configure process threw SSH (Advanced Options) This is optional.
- Disable overscan. This option tries to adjust the resolution for your Raspberry Pi. But it will only f**k things up :) (Advanced Options)
- Change your boot to desktop environment. This will start-up the GUI instead of the CLI and automatically will login to user 'pi'.

Now reboot your machine. Normally Raspi-config ask to reboot, but if it doesn't you can reboot with `sudo reboot`

After rebooting the GUI environment will automatically startup and you will see the LXDE desktop environment. Now start the terminal and update your system:

```
sudo apt-get update
sudo apt-get upgrade
```
Now we install the tools we need to perfectly show the webpage. The next command will install chromium (browser), x11 server utils and unclutter (to hide the cursor from the screen)

```
sudo apt-get install chromium x11-xserver-utils unclutter
```

The tools are installed. When the GUI starts up chromium needs to boot in kiosk-mode and open the webpage we filled in. In the next file we can add lines what needs to be executed at startup.

```
sudo nano /etc/xdg/lxsession/LXDE-pi/autostart
```
(this has changed in Debian Wheezy. In the old versions it was /etc/xdg/lxsession/LXDE/autostart)

The autostart files needs to look like this

- Update the Raspi config tool
- Enable SSH when you want to proceed the configure process threw SSH (Advanced Options)
- Disable overscan. This option tries to adjust the resolution for you Raspberry Pi. But it will only f**k things up :) (Advanced Options)
- Change your boot to desktop environment. This will start-up the GUI instead of the CLI and Automatically will login to user 'pi'.
```
@lxpanel --profile LXDE
@pcmanfm --desktop --profile LXDE
@xset s off
@xset -dpms
@xset s noblank
@sed -i 's/"exited_cleanly": false/"exited_cleanly": true/' ~/.config/chromium/Default/Preferences
@chromium --noerrdialogs --kiosk http://www.page-to.display --incognito
```

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.
The @sed line will prevent errors to be shown.
And finally Chromium will be startup in kiosk mode (with no error messages).
Change the url to the url you want it to show. Local files are also possibly.

Now Chromium will start after the raspberry pi is booted up and will show the webpage.

## good to know ##
## Good to know ##
- default Raspbian login: user: pi pass: raspberry
- the GPU of the Pi isn't that powerful. So animations in the browser don't really run smoothly.

0 comments on commit d26cafc

Please sign in to comment.