Skip to content

Android

This article describes how to use KlipperScreen from an android device

Warning

The experience may not be equal to run KlipperScreen natively. Depending on the device or the network you may encounter performance degradation or other issues.

Bug

Some users have found that using this method causes memory-leaks

  1. First installl KlipperScreen on the Pi
  2. Install XServer-XSDL on the android device
  3. Choose USB(ADB) or WIFI

ADB

Warning

Leaving the phone always connected it's not recommended, remove the battery to avoid issues.

  • Install ADB on the Pi 
    sudo apt-get install android-tools-adb
  • Put your Android phone/tablet in Debug mode.

Usually it involves enabling developer mode and "USB debugging" but this varies on different vendors and versions of the device search "how to enable android debugging on device-model-and-brand"

  • Copy the launcher script
cd ~/KlipperScreen/scripts
cp sample-android-adb.sh launch_KlipperScreen.sh
chmod +x launch_KlipperScreen.sh

WIFI

  • Create a launcher script
cd ~/KlipperScreen/scripts
touch launch_KlipperScreen.sh
chmod +x launch_KlipperScreen.sh
nano launch_KlipperScreen.sh
  • Paste this into the script (replace the example IP) 
    DISPLAY=192.168.150.122:0 $KS_XCLIENT

Important

It's recommended to use a static address, because if the address changes your connection will stop working.

Startup

Start Xserver-XSDL On the android device

On the splash-screen of the app go to: 

“CHANGE DEVICE CONFIGURATION”
└──Mouse Emulation Modde
    └──Desktop, No Emulation
if you missed it, restart the app.

on the Pi 

sudo service KlipperScreen stop
sudo service KlipperScreen start

Stop Screen Blanking in Xserver-XSDL

Even after enabling the "Stay Awake" option in the Developer/USB Debugging options of your Android device, the Xserver-XSDL may still go to a black screen but keep the backlight of your device on. To keep the screen always active, upon start up of Xserver-XSDL app, select the Change Device Configuration at the top of the splash screen and then select the Command line parameters, one argument per line option. Append the following argument (must be on seperate lines): 

-s
0
This will disable the screen-saver in Xserver and keep KlipperScreen always active.

Migration from other tutorials

KlipperScreen says error option "service" is not supported anymore.

Stop the other service and Remove it, for example if the service is KlippyScreenAndroid:

sudo service KlippyScreenAndroid stop
sudo rm /etc/systemd/system/KlippyScreenAndroid.service

Follow this guide on how to setup the new launcher script with USB(ADB) or WIFI and restart KS.

Help

The Discourse thread has old instructions but you may get some help if needed

#klipper-screen channel on Discord