Example 47 — Android Nexus 7 as a urirun node

Control a Nexus 7 tablet (or any Android device) from urirun using:

• ADB connector (adb://) for immediate KVM-style control
• Termux node to run urirun natively on the device

Prerequisites

• Android platform-tools (adb) on PATH
• ADB debugging enabled on the tablet

Quick start (ADB over WiFi)

# 1. Connect USB cable, enable USB debugging, then switch to WiFi ADB:
adb tcpip 5555
adb connect TABLET_IP:5555

# 2. Install the ADB connector:
pip install -e ../../urirun-connector-adb/

# 3. Capture screen (--entry-points loads the installed connector, --execute runs it,
#    --allow is the security boundary, --payload passes route inputs as JSON):
ADB_SERIAL=TABLET_IP:5555 urirun run "adb://host/screen/query/capture" \
    --entry-points --execute --allow 'adb://*' --payload '{"output":"nexus7.png"}'

# 4. Tap (e.g. center of a 1280x800 Nexus 7 screen):
ADB_SERIAL=TABLET_IP:5555 urirun run "adb://host/input/command/tap" \
    --entry-points --execute --allow 'adb://*' --payload '{"x":640,"y":400}'

# 5. Press HOME:
ADB_SERIAL=TABLET_IP:5555 urirun run "adb://host/input/command/key" \
    --entry-points --execute --allow 'adb://*' --payload '{"keycode":"HOME"}'

# 6. List files:
ADB_SERIAL=TABLET_IP:5555 urirun run "adb://host/fs/query/list" \
    --entry-points --execute --allow 'adb://*' --payload '{"path":"/sdcard/"}'

> Note: the connector's own routes are adb://host/... (the host segment is the > urirun authoring placeholder). The adb://nexus7/... aliases below come from the > compiled node-nexus7.bindings.json, which pins the same handlers to a nexus7 > device label.

Start the setup service (QR code distribution)

pip install -e ../../urirun-service-android-node/
urirun-android-node serve
# Open http://LAN_IP:8195/ on the tablet

Add as Termux node

On the tablet in Termux:

curl -fsSL http://HOST_IP:8195/bootstrap.sh | bash

Then on the computer:

urirun host add-node nexus7 http://TABLET_IP:8765

Use compiled bindings

# Validate and compile the Nexus 7 bindings:
urirun validate node-nexus7.bindings.json
urirun compile node-nexus7.bindings.json --out node-nexus7.registry.json

# Run a route from the registry:
ADB_SERIAL=TABLET_IP:5555 urirun run "adb://nexus7/sys/query/info" \
    --registry node-nexus7.registry.json --execute --allow 'adb://*'

Files

View on GitHub →