Support & Diagnostics

Input Leaf Troubleshooting: Connection, Input & Background Fixes

Fix common Input Leaf issues: connection refused, server discovery failure, mouse lag, stuck cursor, missing keyboard shortcuts, and OEM background app closing on Xiaomi, Samsung, and OnePlus.

7 min readUpdated 2026-09-05Apache 2.0 Open Source

Quick Diagnostic Checklist

Most issues fall into one of four categories: network visibility, Android permissions, screen naming, or OEM battery management.

Check 1

Network & Firewall

Port 24800 (TCP) open in your PC firewall, both devices on same local Wi-Fi.

Check 2

Screen Name Match

Screen name in PC grid must match the device name shown in Input Leaf exactly.

Check 3

Overlay & Injection

"Display over other apps" allowed, Shizuku or Accessibility enabled.

Check 4

Battery Unrestricted

Exempt Input Leaf from battery saver so Android doesn't kill the background link.

Common Issues & Visual Fixes

01
Overlay Permission

Virtual Mouse Cursor Missing or Invisible

Fix

Symptom: The connection status shows Connected, but no cursor appears on your Android screen when crossing the boundary.

Solution: Android requires explicit permission to draw on top of third-party applications:

  1. Open Android Settings → Apps → Special app access → Display over other apps.
  2. Find Input Leaf and toggle it to Allowed.
Overlay permission screen
Toggle 'Allow display over other apps' to ON in Android settings.
02
OEM Power Management

Connection Drops After Screen Locks

Fix

Symptom: Input Leaf disconnects whenever the phone sits idle for a few minutes.

Solution: Prevent aggressive OEM task killers from killing the background socket:

  • Samsung (One UI): Settings → Apps → Input Leaf → Battery → choose Unrestricted.
  • Xiaomi (HyperOS / MIUI): App Info → Battery saver → choose No restrictions, and toggle Autostart ON.
  • OnePlus / Oppo (ColorOS): App Info → Battery usage → enable Allow background activity.
Background battery activity setting
Set Battery usage to Unrestricted so Android maintains the Wi-Fi socket.

Network & Firewall Commands

If your PC server is not being discovered over Wi-Fi, verify that port 24800 (TCP) is open:

Firewall Rules
# Linux (UFW)
sudo ufw allow 24800/tcp comment 'Input Leap / Deskflow'

# Windows (Run as Administrator in PowerShell)
New-NetFirewallRule -DisplayName "Input Leap KVM" -Direction Inbound -LocalPort 24800 -Protocol TCP -Action Allow

Still Having Trouble?

If your issue isn't covered above, feel free to report it on our GitHub Issues tracker.

Common Questions

Troubleshooting FAQ

The server (Input Leap or Deskflow) checks whether the configured screen name matches your client device. If your phone's screen name in Input Leaf is 'android-phone' but your PC grid has it named 'Android', the server will not transfer cursor focus. Check the exact case-sensitive name in the Input Leaf app and re-check your PC server configuration.
Get Started Today

Control Android with your PC mouse & keyboard

Input Leaf is 100% free, open-source, and runs on your local Wi-Fi network without cloud servers or root access.