Home

Glide — HTPC Remote Control

Turn any phone into a polished remote for your home theatre PC. Scan a QR code that appears on screen, open it in any browser, and you're controlling your HTPC — no app install, no pairing codes.

---

Quick links

Topic	What's covered
Installation	.deb install, build from source, first-login setup
Connecting Your Phone	How to connect, popup behaviour, reconnecting
Controls Reference	Every gesture, button, and drawer tab explained
App Launcher	Configuring which apps appear and how they launch
Configuration	Idle timeout, env vars, service drop-ins
X11 and Wayland	Backend differences, text input, uinput setup
Troubleshooting	Popup not showing, phone can't connect, input not working
Architecture	How all the pieces fit together
Building from Source	Building the .deb yourself with Docker

---

At a glance

Your phone (any browser)
        │  WebSocket over LAN
        ▼
FastAPI server on HTPC  ──▶  pynput (X11) or evdev/uinput (Wayland)
        │
        ▼
GTK3 QR overlay (hides on connect, reappears after 2 h idle)

• No cloud. Everything stays on your local network.
• No app. Standard browser, any OS, any phone.
• Auto-detects X11 / Wayland at startup — no config needed.
• Runs as a systemd user service, starts on login automatically.

---

Getting started in 3 steps

1. Install — copy the .deb to your HTPC and sudo apt install ./htpc-remote_*.deb
2. Log out and back in — the QR popup appears on screen
3. Scan the code — your phone browser opens and you're in control

See Installation for the full walkthrough.