Using the UAD Command-Line Interface

The UAD command-line interface (CLI) provides the same core debloating functionality as the graphical application in a form suited to terminals, scripts, and remote sessions.

Important

Back up your data and read the FAQ before changing system packages. Removing an essential package can make a device unbootable and require a factory reset.

Features

Requirements

Run adb devices to confirm that the device is connected and authorized.

Installation

The CLI currently needs to be built from source. Follow the build instructions, then build only the CLI package:

cargo build --release -p uad-cli

The binary is written to target/release/uad. The Cargo package is named uad-cli, but the installed binary is named uad.

Usage

List connected devices

uad devices

List packages

List all packages on the first connected device:

uad list
# Short alias
uad ls

Filter packages by state:

uad list --state enabled
uad list --state disabled
uad list --state uninstalled

Filter by removal level:

uad list --removal recommended
uad list --removal advanced
uad list --removal expert
uad list --removal unsafe

See removal definitions before acting on packages in the Advanced, Expert, or Unsafe categories.

Filter by debloat list:

uad list --list google
uad list --list oem
uad list --list aosp

Search for packages:

uad list --search "facebook"
uad list -q "chrome"

Filters can be combined:

uad list --state enabled --removal recommended --search "google"

Show package information

uad info com.android.chrome
uad info com.facebook.katana --device SERIAL123

Uninstall packages

Uninstall one or more packages:

uad uninstall com.facebook.katana
uad rm com.facebook.katana com.facebook.services

Use a dry run to preview an operation:

uad uninstall com.facebook.katana --dry-run

Select a device and Android user:

uad uninstall com.facebook.katana --device SERIAL123 --user 0

Enable or restore packages

uad enable com.android.chrome
uad restore com.google.android.gms

Disable packages

uad disable com.facebook.katana

Update package lists

Update the locally cached UAD lists:

uad update

Interactive shell

Start an interactive session for faster repeated operations:

uad repl
# Alias
uad shell

Commands in the interactive shell use the same syntax:

uad> help
uad> list --state enabled
uad> info com.facebook.katana
uad> uninstall com.facebook.katana
uad> enable com.android.chrome
uad> device
uad> exit

The interactive shell:

Shell completion

Generate a completion script for your shell:

# Bash
uad completions bash > /usr/share/bash-completion/completions/uad

# Zsh
uad completions zsh > /usr/local/share/zsh/site-functions/_uad

# Fish
uad completions fish > ~/.config/fish/completions/uad.fish

# PowerShell
uad completions powershell > uad.ps1

Command reference

Command Alias Description
devices — List connected Android devices
list ls List packages with optional filters
info — Show detailed package information
uninstall rm Uninstall one or more packages
enable restore Enable or restore packages
disable — Disable packages while keeping their data
update — Update UAD package lists
completions — Generate shell completions
repl shell Start the interactive shell

Run uad --help or uad <command> --help for the options supported by the installed version.

Examples

Remove Facebook packages

uad list --search facebook
uad uninstall com.facebook.katana com.facebook.services --dry-run
# If the preview is correct:
uad uninstall com.facebook.katana com.facebook.services

Work with a specific device

uad devices
uad list --device SERIAL123
uad uninstall com.facebook.katana --device SERIAL123

Safety

Note

Without root access, system applications are not physically removed from the system partition. See the FAQ for details.

Troubleshooting

No devices found

Package not found

Permission denied

Some system packages cannot be changed without root access, and device vendors may impose additional restrictions.

Contributing and license

See the project's contribution guidelines. UAD-ng is licensed under GPL-3.0.