Devices

The most-used page in the console. Device list with filters and bulk actions, plus every button on the 10-tab device detail page.

Device list

Columns

Name — device name (auto-generated or set via policy branding.device_name_template)
Status — online (green) / offline (amber) / pending (blue) / unassigned (gray)
Group — click to filter to devices in same group
Policy — currently applied policy name and version
OS version — Android version string from heartbeat
Last seen — time since last heartbeat
Compliance — compliant / non-compliant / evaluating

Filters

Top bar: search by name / MAC / IP / tag, filter by status, group, OS version, compliance. All filters are URL params (?status=online) — you can bookmark filtered views.

Bulk actions

Select devices via checkbox → batch menu: Move to group, Apply policy, Reboot, Collect logs, Add tags, Export CSV.

Bulk commands use process_subcommands under the hood — one MQTT message per device, but one API call from the console.

Device detail — 10 tabs

1. Overview

Hero stats: CPU temp, RAM, storage, uptime, network. Last heartbeat timestamp. Quick actions: reboot, wipe, lock, screenshot.

2. Apps

Installed apps list with package name, version, versionCode. Per-app buttons: Launch, Force stop, Clear data, Block uninstall, Disable.

3. Policy

Current effective policy (merged tenant + group + device). Version history with diff viewer. "Change policy" button assigns a different policy at device level.

4. Certificates

Installed CA and client certs. Each cert shows subject, issuer, expiration, fingerprint. Download and Revoke actions per cert.

5. Network

Current network: interface, IP, MAC, gateway, signal strength. Run diagnostics button (ping / traceroute / DNS test with results panel).

6. Peripherals

USB devices (VID:PID, class, name). Bluetooth paired devices. Connected displays (resolution, refresh rate). Pi-specific: thermal zones, fan RPM, I2C devices, GPIO chips.

7. Logs

Collect logs button triggers collect_logs. Previously collected bundles listed with download links (1-hour presigned URLs).

8. Files

Files deployed to this device via File Bridge. Send file pushes a file to the device immediately.

9. Audit

Every admin action affecting this device — who did what, when, from what IP. 365-day retention.

10. History

Timeline of state transitions: enrolled → approved → online → offline events, policy changes, OTA installs, command executions.

Live View (floating panel)

Click the Live View button on any online device. Opens a slide-over with a real-time screenshot stream (2s refresh). In interactive mode, click anywhere in the screenshot to send an input_tap, type text to send input_text, press Back/Home/Enter for input_keyevent.

Live View quality and refresh rate are tunable via policy.agent.screenshot_quality and policy.agent.screenshot_interval_seconds.