adbt is a modern, keyboard-driven Terminal User Interface (TUI) for interacting with Android devices using the Android Debug Bridge (ADB). It provides a structured and interactive alternative to raw adb commands while remaining fast, predictable, and safe for daily use.

Built in Go using Charm’s Bubble Tea framework, adbt focuses on clarity, correctness, and real-time device interaction entirely from the terminal.

Screenshots reflect the current codebase and actual UI.

Dashboard	Device Info

• Automatic detection of connected Android devices
• Device selection with connection state and Android version
• Automatic selection when exactly one device is connected
• Wireless ADB pairing using IP address, port, and PIN

• Central hub displaying current device status
• Keyboard shortcuts for all major features
• Device-aware actions disabled when no device is selected

• Displays device model, serial number, Android version, and state

• Supported actions:

  • Start scrcpy
  • Toggle Wi-Fi
  • Toggle screen power
  • Reboot device
  • Reboot to recovery
  • Reboot to bootloader

• Mandatory confirmation prompts for destructive actions

• Real-time streaming of adb logcat
• Pause and resume logging
• Clear log buffer
• Retains the last 1000 log lines for performance

• Lists installed applications on the device
• Distinguishes between system apps and user apps
• Reloads the application list on demand

• Browse the device file system starting at /sdcard
• Navigate directories
• Delete files and directories with confirmation
• Refresh directory contents
• Scrollable viewport for large directories

The project follows Bubble Tea’s Elm-style architecture, separating UI, state, and ADB logic.

• cmd/adbt/main.go Initializes the Bubble Tea program and starts the UI loop.

All direct interaction with the adb binary is handled here.

• client.go — Command execution helpers and output parsing
• devices.go — Device discovery and wireless pairing
• device_info.go — Device control actions (reboot, Wi-Fi, screen, scrcpy)
• logcat.go — Streaming logcat implementation
• files.go — File system operations
• app_manager.go — Installed applications listing

• app.go — Holds selected device, device list, and terminal dimensions

Responsible for all TUI rendering and interaction.

• app.go — Root Bubble Tea model and screen router

Each screen is an isolated Bubble Tea model.

• dashboard.go — Main dashboard and quick actions
• devices.go — Device selection and wireless pairing
• device_info.go — Device details and controls
• logcat.go — Live logcat viewer
• files.go — File browser
• app_manager.go — App manager
• actions.go — Action-to-screen resolution
• messages.go — Screen-switching messages

Reusable UI building blocks.

• layout.go — Layout and viewport handling
• header.go — Header rendering
• list.go — Device list rendering
• file_list.go — File list rendering
• keyvalue.go — Key-value table rendering
• confirm.go — Confirmation modal
• form.go — Input form modal
• toast.go — Toast notifications
• styles.go — Lip Gloss styling definitions

• .github/workflows/release.yml — Multi-OS build and GitHub release workflow

• Go 1.21 or newer
• Android SDK Platform Tools (adb available in PATH)
• Android device or emulator with USB debugging enabled
• Optional: scrcpy for screen mirroring

Prebuilt binaries for Linux, macOS, and Windows are available on the GitHub Releases page.

chmod +x adbt
./adbt

git clone https://github.com/<your-username>/adbt
cd adbt
go build -o adbt ./cmd/adbt
./adbt

Optional global install:

sudo mv adbt /usr/local/bin

Contributions are welcome. Fork the repository, create a feature branch, and submit a pull request for review.

MIT License