Skip to content

Setup: Boot to Browser (OctoPi or Jessie Light)

Paul de Vries edited this page Jun 12, 2016 · 36 revisions

This is a guide for Jessie Light or OctoPi (0.13 and higher)

Follow this guide for Jessie Full.


  1. Make sure you've expanded your file system

  2. Make sure you've your touchscreen working by installing the required drivers.

  3. Make sure all packages are up-to-date:

    sudo apt-get update
    
  4. Install Chromium

  5. Install all required modules:

    sudo apt-get install --no-install-recommends xinit xserver-xorg xserver-xorg-video-fbdev x11-xserver-utils matchbox unclutter
    
  6. Register your touchscreen to X11 by creating a new config:

    sudo nano /usr/share/X11/xorg.conf.d/99-fbdev.conf
    
    • If your touchscreen is connected with HDMI, paste the following code:
      Use this if you're using the Official Pi Touchscreen

      Section "Device"
        Identifier "touchscreen"
        Driver "fbdev"
        Option "fbdev" "/dev/fb0"
      EndSection
      
    • Otherwise, paste the following code:

      Section "Device"
        Identifier "touchscreen"
        Driver "fbdev"
        Option "fbdev" "/dev/fb1"
      EndSection
      

    Save and exit (CTR-O, enter and CTR-X)

  7. Allow X11 to run as anybody by running the following command:

    sudo sed -i 's/allowed_users=console/allowed_users=anybody/' /etc/X11/Xwrapper.config
    
  8. Get the TouchUI boot files:

    wget -P /home/pi/ https://github.com/BillyBlaze/OctoPrint-TouchUI/archive/autostart.zip
    unzip -d /home/pi/ /home/pi/autostart.zip		
    
  9. Copy service file and register it as auto boot: 1. Copy service file and register it as auto boot:

    sudo cp ~/OctoPrint-TouchUI-autostart/touchui.init /etc/init.d/touchui
    sudo chmod +x /etc/init.d/touchui
    sudo cp ~/OctoPrint-TouchUI-autostart/touchui.default /etc/default/touchui
    sudo update-rc.d touchui defaults
    
  10. Reboot

  • You can also safely remove autostart.zip. Do not remove the directory ~/OctoPrint-TouchUI-autostart and if you change the path of this directory then edit the file /etc/default/touchui with the new path.

  • Don't forget to turn on Touchscreen mode in the TouchUI Setting dialog to enhance performance.

  • Troubleshooting: