Wireless • Low Latency • Tailscale VPN Support
LanPilot is an open-source tool that allows you to fully control your computer via your smartphone over a local network (Wi-Fi) or through Tailscale VPN.
Sometimes the best projects are born from necessity (or a bit of laziness). LanPilot started when I wanted to control my PC from the kitchen without walking back to my desk. Existing tools like TeamViewer were too heavy for such a simple task and required internet. So, I decided to build my own lightweight solution running entirely on the local network.
As demonstrated in the demo video, I tested it by picking a League of Legends champion. Yes, sometimes you develop software just so you don't miss your pick during the draft phase while grabbing a snack 😁
Developed to solve the need to control your PC when you are away from the keyboard (in the kitchen, balcony, or bed). Unlike TeamViewer/AnyDesk:
- No Internet Required (Local Mode): Works entirely on your local network.
- Global Access (Tailscale Mode): Control from anywhere using Tailscale VPN without port forwarding.
- No Installation: Just run the Python script.
- High Quality: 75% resolution scaling with high-quality streaming for clear visuals.
- Low Latency: Optimized for instant reactions, fast enough even for gaming menus.
The most exciting technical details that make this project special:
-
🖱️ Aspect Ratio Mapping: The most challenging part of the project. Mathematically calculates the aspect ratio difference between your phone and monitor to ensure pixel-perfect clicking accuracy. This ensures that when you tap on your phone screen, the click lands exactly where you intended on your PC screen, regardless of screen size differences.
-
⚡ Low Latency: Optimized for instant reactions, fast enough even for time-sensitive tasks like gaming champion selection. Uses
msslibrary for high-performance screen capture and MJPEG streaming. -
📱 PWA Support: Works like a native app on your phone. Add it to your home screen for quick access.
-
⌨️ Keyboard Support: Type text, press Enter, Backspace, and Alt-Tab for full control.
-
🛡️ Security & Privacy:
- PIN Login: Nothing is reachable without a PIN. A random 6-digit PIN is printed in the terminal on every start (or set your own with
LANPILOT_PIN). Wrong guesses are rate-limited and locked out. - Local Network Mode: Data never leaves your local network (Localhost/WiFi). Traffic is plain HTTP there, so use a network you trust.
- Tailscale VPN Mode: When using Tailscale, data travels through an encrypted private network. Only devices logged into your account can access.
- Restricted Input: Typed text is capped, and only a short list of keys can be pressed from the phone.
- See SECURITY.md for the full threat model and how to report a vulnerability.
- PIN Login: Nothing is reachable without a PIN. A random 6-digit PIN is printed in the terminal on every start (or set your own with
-
Clone the Repo:
git clone https://github.com/basaranbaran/lanpilot.git cd lanpilot -
Install Requirements:
pip install -r requirements.txt
-
Run:
python app.py
-
Connect: Open your phone's browser and go to
http://YOUR_PC_IP:5000(e.g.,192.168.1.20:5000), then enter the PIN printed in the terminal.💡 Tip: The app will automatically detect and display all available connection URLs when it starts, including Tailscale VPN IPs (if installed) and local network IPs.
Options:
| What | How |
|---|---|
| Keep the same PIN between runs | LANPILOT_PIN=my-secret-pin python app.py (6 to 128 characters) |
| Listen on one interface only | python app.py --host 100.x.y.z (e.g. your Tailscale IP) |
| Use another port | python app.py --port 8080 |
- Ensure your phone and PC are connected to the same WiFi router.
- Run
python app.py. - Enter the Network URL shown in the terminal into your phone's browser.
Controls your PC from anywhere (4G, Office, Vacation) without port forwarding.
Step-by-Step Setup:
- Install:
- PC: Download Tailscale for Windows.
- Phone: Download Tailscale from App Store / Google Play.
- Login: Open Tailscale on both devices and log in with the same Google/Microsoft account.
- Verify: You should see your computer's name in the "Machines" list on your phone.
- Run: Start LanPilot (
python app.py). - Connect: The app will automatically detect and display your secure Tailscale IP (starts with
100.x) with a 🔒 icon. Use that link on your phone to connect from anywhere in the world.
🔒 Security Note: Tailscale creates a private encrypted network. Only devices logged into your account can access this IP. Strangers cannot connect, and the PIN adds a second layer.
- Backend: Flask (Python) with MJPEG streaming
- Screen Capture:
msslibrary for high-performance screen grabbing - Input Control:
PyAutoGUIfor mouse and keyboard simulation - Frontend: Vanilla JavaScript with PWA support
- Network: Supports both local network (WiFi) and Tailscale VPN (100.x.x.x IP range)
Aspect Ratio Mapping:
The core challenge was ensuring pixel-perfect clicking accuracy when the phone and PC have different aspect ratios. The algorithm:
- Calculates the PC screen aspect ratio
- Calculates the phone screen/container aspect ratio
- Determines how the PC screen is rendered (letterboxed or pillarboxed)
- Maps touch coordinates to the correct relative position on the PC screen
- Converts relative coordinates to absolute pixel coordinates
This ensures that tapping anywhere on your phone screen results in an accurate click on the corresponding location on your PC screen.
The web layer talks to the desktop through a small Controller interface, so the tests use a fake one and never move your real mouse.
pip install -r requirements-dev.txt
python -m pytestCI runs the same tests on Python 3.9 and 3.12 for every push and pull request.
Special thanks to Mert Okuyaz for suggesting Tailscale VPN integration, which made this project accessible from anywhere in the world! 🌍
LanPilot, bilgisayarınızı yerel ağ (Wi-Fi) veya Tailscale VPN üzerinden akıllı telefonunuzla tam kontrollü bir şekilde yönetmenizi sağlayan açık kaynaklı bir araçtır.
Bazen en iyi projeler kendi ihtiyacımdan veya "tembelliğimizden" doğar derler. LanPilot tam da böyle başladı. 🚀
Bilgisayar başından kalkıp mutfağa gittiğimde, arka plandaki işlemleri kontrol etmek için tekrar odaya dönmek zor geliyordu. TeamViewer gibi uygulamalar hem internet gerektiriyor hem de bu basit ihtiyaç için hantal kalıyordu. Ben de "Neden kendi hafif (lightweight) çözümümü yazmıyorum?" dedim ve ortaya yerel ağ üzerinden çalışan bu aracı çıkardım.
Demo videoda göreceğiniz üzere sistemi League of Legends karakter seçim ekranında test ettim. Evet, bazen sırf şampiyon seçimini mutfaktan yapabilmek ve sırayı kaçırmamak için bile yazılım geliştirebiliyorsunuz 😁
Bilgisayar başında değilken (balkonda, mutfakta veya yatakta) bilgisayarınızı kontrol etme ihtiyacını çözmek için geliştirilmiştir. TeamViewer/AnyDesk gibi çözümlerin aksine:
- İnternet Gerektirmez (Yerel Mod): Tamamen yerel ağda çalışır.
- Küresel Erişim (Tailscale Modu): Port açma derdi olmadan, Tailscale VPN ile dünyanın her yerinden erişim.
- Kurulum Gerektirmez: Sadece Python scriptini çalıştırmanız yeterlidir.
- Yüksek Kalite: %75 çözünürlük ölçekleme ve yüksek kalite ile net görüntü.
- Düşük Gecikme (Low Latency): Anlık tepki gerektiren işleri bile telefondan yapabilecek kadar seri çalışıyor.
İşin mutfağında beni en çok heyecanlandıran detaylar:
-
🖱️ Aspect Ratio Mapping (En-Boy Oranı Eşleştirme): Projenin en zorlu kısmıydı. Telefon ve monitör arasındaki en-boy oranı farkını matematiksel olarak hesaplayıp piksel hassasiyetinde tıklama sağlıyor. Bu sayede telefon ekranınızda dokunduğunuz nokta, bilgisayar ekranında tam olarak istediğiniz yere denk geliyor.
-
⚡ Low Latency (Düşük Gecikme): Anlık tepki gerektiren işleri bile telefondan yapabilecek kadar seri çalışıyor.
msskütüphanesi ile yüksek performanslı ekran yakalama ve MJPEG streaming kullanılıyor. -
📱 Mobil Uyumlu Arayüz (PWA): Telefonunuzda doğal bir uygulama gibi çalışır. Ana ekrana ekleyerek hızlı erişim sağlayabilirsiniz.
-
⌨️ Klavye Desteği: Metin yazma, Enter, Backspace ve Alt-Tab ile tam kontrol.
-
🛡️ Güvenlik & Gizlilik:
- PIN ile Giriş: PIN olmadan hiçbir şeye erişilemez. Her başlangıçta terminalde rastgele 6 haneli bir PIN yazılır (kendi PIN'inizi
LANPILOT_PINile belirleyebilirsiniz). Yanlış denemeler sınırlandırılır ve kilitlenir. - Yerel Ağ Modu: Verileriniz dış internete çıkmaz, tamamen yerel ağda (Localhost/WiFi) döner. Bu modda trafik düz HTTP'dir, bu yüzden güvendiğiniz bir ağ kullanın.
- Tailscale VPN Modu: Tailscale kullanırken veriler şifreli özel ağ üzerinden iletilir. Sadece sizin hesabınızla giriş yapılmış cihazlar erişebilir.
- Kısıtlı Girdi: Yazılan metin sınırlıdır ve telefondan yalnızca kısa bir tuş listesine basılabilir.
- Tehdit modelinin tamamı ve açık bildirme yöntemi için SECURITY.md dosyasına bakın.
- PIN ile Giriş: PIN olmadan hiçbir şeye erişilemez. Her başlangıçta terminalde rastgele 6 haneli bir PIN yazılır (kendi PIN'inizi
-
Projeyi İndirin:
git clone https://github.com/basaranbaran/lanpilot.git cd lanpilot -
Gereksinimleri Yükleyin:
pip install -r requirements.txt
-
Uygulamayı Başlatın:
python app.py
-
Bağlanın: Telefonunuzun tarayıcısından
http://BILGISAYAR_IP_ADRESI:5000adresine gidin (Örn:192.168.1.20:5000) ve terminalde yazan PIN'i girin.İpucu: Uygulama başladığında kullanabileceğiniz tüm adresleri ekrana yazdırır.
Seçenekler:
| Ne | Nasıl |
|---|---|
| PIN'i her çalıştırmada aynı tutmak | LANPILOT_PIN=gizli-pin python app.py (6 ile 128 karakter arası) |
| Yalnızca tek bir arayüzü dinlemek | python app.py --host 100.x.y.z (örn. Tailscale IP'niz) |
| Başka bir port kullanmak | python app.py --port 8080 |
- Telefonunuzun ve bilgisayarınızın aynı modeme bağlı olduğundan emin olun.
python app.pykomutunu çalıştırın.- Uygulama ekranında çıkan Network adresini (örn:
192.168.1.25:5000) telefon tarayıcısına yazın.
Port açma derdi olmadan, marketten veya başka bir şehirden bilgisayarınızı yönetin.
Adım Adım Kurulum:
- İndir:
- PC: Windows için Tailscale indirin ve kurun.
- Telefon: App Store veya Play Store'dan Tailscale uygulamasını indirin.
- Giriş: Her iki cihazda da aynı Google/Microsoft hesabı ile giriş yapın.
- Kontrol: Telefonda "Machines" listesinde bilgisayarınızın adını (örn:
baran-pc) gördüğünüzden emin olun. - Başlat: LanPilot'u çalıştırın (
python app.py). - Bağlan: Uygulama güvenli Tailscale IP adresinizi (
100.xile başlar) 🔒 ikonu ile otomatik gösterir. Dünyanın her yerinden o adrese girerek bağlanabilirsiniz.
🔒 Güvenlik Notu: Tailscale size özel şifreli bir ağ kurar. Sadece sizin hesabınızla giriş yapılmış cihazlar bu IP'ye erişebilir. Başkası giremez, PIN ise ikinci bir katman ekler.
- Backend: Flask (Python) ile MJPEG streaming
- Ekran Yakalama: Yüksek performanslı ekran yakalama için
msskütüphanesi - Giriş Kontrolü: Fare ve klavye simülasyonu için
PyAutoGUI - Frontend: PWA desteği ile Vanilla JavaScript
- Ağ: Hem yerel ağ (WiFi) hem de Tailscale VPN (100.x.x.x IP aralığı) desteği
Aspect Ratio Mapping (En-Boy Oranı Eşleştirme):
Piksel hassasiyetinde tıklama doğruluğu sağlamak, telefon ve PC'nin farklı en-boy oranlarına sahip olması durumunda projenin en zorlu kısmıydı. Algoritma:
- PC ekran en-boy oranını hesaplar
- Telefon ekranı/kapsayıcı en-boy oranını hesaplar
- PC ekranının nasıl render edildiğini belirler (letterboxed veya pillarboxed)
- Dokunma koordinatlarını PC ekranındaki doğru göreceli konuma eşler
- Göreceli koordinatları mutlak piksel koordinatlarına dönüştürür
Bu sayede telefon ekranınızda herhangi bir yere dokunduğunuzda, PC ekranınızda karşılık gelen konuma doğru bir tıklama yapılır.
Web katmanı masaüstü ile küçük bir Controller arayüzü üzerinden konuşur. Testler sahte bir controller kullanır, gerçek farenizi hareket ettirmez.
pip install -r requirements-dev.txt
python -m pytestCI, her push ve pull request'te aynı testleri Python 3.9 ve 3.12 üzerinde çalıştırır.
Tailscale VPN entegrasyonunu önerdiği için Mert Okuyaz'a özel teşekkürler! Bu öneri sayesinde proje dünyanın her yerinden erişilebilir hale geldi! 🌍