Setup: Boot to Browser (OctoPi or Jessie Light)

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

Follow this guide for Jessie Full.

---

Before starting with this guide, make sure you've installed OctoPrint and installed TouchUI from the 'Plugins Manager'.

---

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 all required packages:

   sudo apt-get install --no-install-recommends xinit xserver-xorg xserver-xorg-video-fbdev x11-xserver-utils matchbox unclutter chromium-browser
   

5. 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)

6. 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
   

7. Get the TouchUI boot files:

   git clone https://github.com/BillyBlaze/OctoPrint-TouchUI-autostart.git ~/TouchUI-autostart/		
   

8. Copy service file and register it as auto boot:

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

9. Test if your kernel can run Chromium by running the following command:

   chromium-browser
   

   • If you get the following error, you need to upgrade your kernel to the latest version, follow these extra steps.

     /usr/lib/chromium-browser/chromium-browser: symbol lookup error: /usr/lib/chromium-browser/chromium-browser: undefined symbol: mmal_vc_init_fd
     

   • If you get the following error, you can proceed to step 10:

     [..] Gtk: cannot open display:
     

10. Reboot

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

• Troubleshooting:

  • Calibration
  • Inverted Axis
  • Webcam image not working

---

Upgrading your kernel:

1. Run:

   sudo apt-get upgrade
   sudo apt-get install rpi-update
   

2. Run:

   sudo rpi-update
   

3. Reboot:

   sudo reboot