AWT - ADB Wireless TUI

A modern Terminal User Interface (TUI) for wireless Android Debug Bridge (ADB) pairing and connection on Linux.

Built with Bash, ADB, and Gum.

---

Features

• Modern terminal UI
• Wireless ADB pairing support
• Wireless ADB connection support
• Interactive prompts
• Pairing walkthrough/tutorial
• Error handling & troubleshooting
• Connection result output
• Remembers previous IPs and ports
• Lightweight and fast
• Works with:
  • adb shell
  • Android Studio
  • Wireless debugging workflows

---

Preview

AWT - ADB Wireless TUI v1.0

Linux Support
Wireless Pairing & Connection Utility

Github: Palccod
Instagram: Palccod

---

Requirements

• Linux
• Bash
• ADB (Android Platform Tools)
• Gum

---

Install Dependencies

Arch Linux

sudo pacman -S android-tools gum

---

Ubuntu / Debian

Install ADB

sudo apt update
sudo apt install adb

Install Gum

sudo mkdir -p /etc/apt/keyrings

curl -fsSL https://repo.charm.sh/apt/gpg.key | \
sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg

echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | \
sudo tee /etc/apt/sources.list.d/charm.list

sudo apt update
sudo apt install gum

---

Fedora

Install ADB

sudo dnf install android-tools

Install Gum

sudo mkdir -p /etc/yum.repos.d/

echo '[charm]
name=Charm
baseurl=https://repo.charm.sh/yum/
enabled=1
gpgcheck=0' | sudo tee /etc/yum.repos.d/charm.repo

sudo dnf install gum

---

OpenSUSE

sudo zypper install android-tools

Install Gum manually:

https://github.com/charmbracelet/gum/releases

---

Other Linux Distributions

ADB

Install Android Platform Tools using your package manager.

Gum

Official installation methods:

https://github.com/charmbracelet/gum

---

Installation

Clone the repository:

git clone https://github.com/Palccod/awt.git

Enter the directory:

cd awt

Make executable:

chmod +x awt.sh

Run:

./awt.sh

---

Android Setup

On your Android phone:

Enable Developer Options

Go to:

Settings → About Phone

Tap:

Build Number

multiple times until Developer Options are enabled.

---

Enable Wireless Debugging

Go to:

Settings → Developer Options

Enable:

Wireless Debugging

---

Pair Device

Tap:

Pair device with pairing code

You will receive:

• Pairing IP
• Pairing Port
• Pairing Code

Enter them into AWT.

---

Connect Device

After successful pairing:

Android will display:

• Connection IP
• Connection Port

Enter them into AWT.

---

Usage Flow

Pairing Flow

Device already paired?
        ↓
      No
        ↓
Enter Pairing IP
Enter Pairing Port
Enter Pairing Code
        ↓
adb pair

---

Connection Flow

Enter Connection IP
Enter Connection Port
        ↓
adb connect

---

Troubleshooting

Pairing Failed

Ensure:

• Wireless Debugging is enabled
• Pairing code is correct
• Pairing IP and port are correct
• Devices are on same Wi-Fi
• Pairing code has not expired

---

Connection Failed

Ensure:

• Pairing was successful first
• Correct connection IP/port used
• Wireless Debugging still enabled
• Same Wi-Fi network is used

---

Notes

Tested on:

• Arch Linux
• Hyprland
• Wayland

Should also work on:

• X11
• KDE Plasma
• GNOME
• Other Linux desktop environments

---

Thank You

Thank you for using AWT.

Enjoy wireless Android debugging on Linux.

---

Author

Github: https://github.com/Palccod

Instagram: https://instagram.com/Palccod

---