🚀 sadb (Smart ADB)

sadb is a powerful wrapper for Android Debug Bridge (adb) that simplifies multi-device management and command automation.

✨ Key Features

• 📱 Smart Device Selection: Automatically prompts for device selection when multiple devices are connected. Supports fzf for fuzzy searching.
• ⚡ Batch Execution: Run a single command on ALL connected devices simultaneously.
• 🔗 Command Aliases: Define short aliases for complex adb commands (e.g., sadb alias log "logcat -v time").
• 🛠️ Custom Methods: Create powerful multi-line scripts combining adb and local shell commands with automatic device targeting.
• 🎯 Active Device Lock: Lock onto a specific device serial for the current session to skip selection prompts.
• 🎨 Modern UI: Beautifully formatted tables with status-based coloring and clear execution headers.

🚀 Installation

Manual Installation

1. Install the Script

Download the sadb script and set the execution permission:

# For system-wide install (requires sudo):
sudo curl -L https://raw.githubusercontent.com/UncleBrook/sadb/main/sadb -o /usr/local/bin/sadb
sudo chmod +x /usr/local/bin/sadb

# For user-only install (ensure ~/.local/bin is in your PATH):
mkdir -p ~/.local/bin
curl -L https://raw.githubusercontent.com/UncleBrook/sadb/main/sadb -o ~/.local/bin/sadb
chmod +x ~/.local/bin/sadb

2. Install Shell Completion

Download the completion script and load it in your shell configuration:

For Bash:

1. Download the script:

   mkdir -p ~/.config/sadb
   curl -L https://raw.githubusercontent.com/UncleBrook/sadb/main/sadb-completion.bash -o ~/.config/sadb/sadb-completion.bash
   

2. Add the following to your ~/.bashrc:

   [[ -f ~/.config/sadb/sadb-completion.bash ]] && source ~/.config/sadb/sadb-completion.bash
   

For Zsh:

1. Download the script:

   mkdir -p ~/.config/sadb
   curl -L https://raw.githubusercontent.com/UncleBrook/sadb/main/sadb-completion.bash -o ~/.config/sadb/sadb-completion.bash
   

2. Add the following to your ~/.zshrc:

   autoload -Uz bashcompinit && bashcompinit
   source ~/.config/sadb/sadb-completion.bash
   

3. Add Alias (Recommended)

Add an alias to your shell configuration (~/.bashrc or ~/.zshrc) to use sadb as a drop-in replacement for adb:

alias adb="sadb"

Quick Install (Automated)

If you prefer an automated setup, use the installation script which handles everything above for you:

curl -s https://raw.githubusercontent.com/UncleBrook/sadb/main/install.sh | bash

📖 Commands Reference

sadb supports all standard adb commands and adds several powerful management features.

🧩 Alias Management

The alias command allows you to manage short commands and complex methods.

| Command | Description | | :--- | :--- | | sadb alias -l -s [mode] | List and sort aliases/methods (a\|alpha, r\|reverse, l\|length) | | sadb alias -r <key> | Remove a specific alias or method | | sadb alias -h, --help | Display detailed help for the alias command | | sadb alias <key> <value> | Add or update a command alias | | sadb alias.<key> <value> | Shorthand to add a command alias | | sadb alias <key> | Show the definition of a specific alias |

🎯 Active Device Control

Set an active device for the current terminal session only. This avoids selection prompts without affecting other windows.

| Command | Description | | :--- | :--- | | sadb active | Trigger interactive selection (or auto-select if only one device is connected) | | sadb active <serial> | Lock the current session to a specific device serial | | sadb active -d | Unlock and return to interactive selection mode | | sadb active -h | Display detailed help for the active command |

📱 Beautified Device List

sadb provides a modern, color-coded table for listing devices. Active devices for the current session are highlighted in yellow.

| Command | Description | | :--- | :--- | | sadb devices | List connected devices in a beautified table and highlight the active device |

⚙️ Standard ADB Passthrough

Commands like start-server, kill-server, connect, pair, version, etc., are passed directly to the original adb binary.

💡 Usage Examples

Interactive Selection

If multiple devices are connected, simply run any adb command:

sadb shell

If fzf is installed, you can search and select your device instantly.

Active Device Management

sadb active          # Select a device to lock onto for this terminal session
sadb devices         # See the list with the active device highlighted
sadb active -d       # Unlock and return to interactive selection mode

Aliases

# Create an alias
sadb alias ws "wm size"

# Use it
sadb ws

Methods (Automation)

Define complex workflows in ~/.config/sadb/.alias:

# Example Method
my_workflow() {
    local scale=$1
    echo "Starting workflow..."
    adb shell settings put global window_animation_scale $scale
    adb shell settings put global transition_animation_scale $scale
    adb shell settings put global animator_duration_scale $scale
    echo "Workflow complete!"
}

sadb automatically injects ANDROID_SERIAL, so you don't need -s inside methods.

📋 Requirements

• Bash v4.0+ (Required for associative arrays)
• adb (Android SDK Platform-Tools)
• fzf (Optional, for better interactive experience)

🎥 Demo

📱 Smart Device Selection & Beautified List

🔗 Command Aliases & Methods

⚡ Interactive Usage & Execution

📄 License

This project is licensed under the Apache License 2.0.