adbtvremote

Android TV Remote 📺

A lightweight Python remote control for Android TV using ADB over network.
Works on desktop and mobile (Pydroid3).

✨ Features

• 📡 ADB over WiFi (no USB required)
• 🎮 Full D-Pad control (navigation + OK)
• 🔊 Volume & Power controls
• 🏠 System buttons (Home, Back, Menu)
• ⌨️ Send text input to the device
• 🧵 Async ADB calls (non-blocking UI)
• 📱 Responsive UI (auto scaling)
• ⌨️ Keyboard shortcuts support
• 📝 Logging system (remote.log)

📦 Requirements

• Python 3.8+
• ADB installed and accessible in PATH (PC only)

⚡ Quick Start

Option 1: Install with pipx (Recommended)

pipx install adbtvremote
adbtvremote

Why pipx? Keeps the app isolated in its own virtual environment, avoiding dependency conflicts with other Python projects.

Option 2: Install with pip

pip install adbtvremote
adbtvremote

Option 3: Run from source

git clone https://github.com/DanVerseDev/android-tv-remote.git
cd android-tv-remote
pip install -r requirements.txt
python main.py

Pydroid3 (Android)

Note: On Pydroid3, this app uses a pure Python ADB implementation (adb-shell), so no ADB binary is required.

1. Install the package via pip in Pydroid3:

pip install adbtvremote

2. Create a new Python script (e.g., run.py) with the following content:

from adbtvremote.app import main
import tkinter
main()

3. Run the script in Pydroid3.

Note: Make sure customtkinter is installed and the ADB binary is available on your Android device (manual setup may be required).

⚙️ Setup (ADB over Network)

1. Enable developer options on your Android TV

2. Enable:

   • USB debugging
   • Wireless debugging (if available)

3. Connect once via USB (optional but recommended):

adb tcpip 5555

4. Get device IP and connect:

adb connect 192.168.x.x:5555

🚀 Usage

After installation, simply run:

adbtvremote

Or if running from source:

python main.py

Connect

• Enter IP: 192.168.x.x:####
• Click Connect

Controls

• UI buttons for navigation and system actions
• Keyboard:
  • Arrow keys → Navigation
  • Enter → OK
  • Backspace → Back
  • Escape → Home

Send Text

• Click Send Text
• Input text and send directly to device

🧠 How it works

• Uses adb shell input keyevent for buttons
• Uses adb shell input text for text input
• Runs ADB commands in background threads
• Logs all activity for debugging to remote.log

📁 Project Structure

.
├── main.py
├── remote.log (generated)
└── README.md

🔁 Smart Backend

The app automatically selects the best ADB method:

• 💻 PC → Uses system adb binary (fast, full compatibility)
• 📱 Pydroid3 → Uses pure Python adb-shell (no ADB required)

No configuration needed.

⚠️ Notes

• Device and host must be on the same network
• Some TVs may require pairing for wireless ADB
• Text input replaces spaces with %s (ADB limitation)

🐞 Logging

All ADB calls and errors are logged in remote.log

📄 License

MIT License - Copyright (c) 2026 Daniel Martí

---

Built with ❤️ by Daniel Martí aka DanVerse