Skip to content

Instantly share code, notes, and snippets.

What would you like to do?

Raspberry Pi Kiosk

Instructions to go from zero to a Raspberry Pi Kiosk displaying a webpage with auto-refresh.

  • OS: Raspbian (Debian Wheezy) 2015-02-16
  • Browser: IceWeasel

Copy Raspbian to a SD Card (on OSX)

Instructions for other OSes.

$ diskutil list
$ diskutil unmountDisk /dev/disk#
$ sudo dd bs=1m if=<raspbian-image-file> of=/dev/rdisk#

Note: The 'r' in /dev/rdisk# is not a typo. This is the raw path to the disk, which is faster than the buffered /dev/disk devices.

Power it up

  • Hook up your Pi: Plug in the mouse, keyboard, monitor, ethernet, sd card, and power.
  • First boot will take you to the raspi-config utility:
    • Expand the filesystem
    • Change the user password from the default (user: pi, pass: raspberry)
    • Enable boot to graphical desktop
    • I18n options -> Change keyboard layout -> Select your keyboard
    • Finish and reboot

Install xscreensaver and Disable the Screen Saver

sudo apt-get update
sudo apt-get install xscreensaver

Menu -> Preferences -> Screensaver -> Display Mode -> Disable Screen Saver

Launch IceWeasel on Startup

$ sudo apt-get update
$ sudo apt-get install iceweasel
$ sudo nano /etc/xdg/lxsession/LXDE-pi/autostart

Install IceWeasel Add-ons

Configure the Browser

  • Right-click on page -> ReloadEvery -> Auto Enable New Tab
  • Set your homepage in the Preferences
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.