Skip to content

Getting started

Ricardo Fernández Serrata edited this page Apr 24, 2025 · 22 revisions
  • ℹ️ Read the FAQ!
  • 💾 Do a proper backup of your data! You can never be too careful!
  • Install ADB:
    • 🐧 Linux: Install Android Platform Tools (either android-tools or adb) with your package-manager of choice
    • 💻 MacOS
      1. Install Homebrew
      2. Run this command:
      brew install android-platform-tools
    • 🪟 Windows
      1. Install WinGet (alternatively, you can use Scoop or Choco, but the pack name is different)
      2. Run this command:
      winget install --id Google.PlatformTools
      1. Install USB drivers for your device
    • Manually. It'll never auto-update, and you won't get shell-completions. Steps:
      1. Download
      2. Make it available. You can either:
        • Add the installation-directory to your PATH environment-variable (convenient)
        • Move UAD-ng to the installation-folder (lazy)
  • Download UAD-ng here
  • ⚙️ From the Settings app (on your Android), you should disconnect/remove/log-out any OEM accounts (when you delete an OEM-account package, it could lock you out of your phone, because it can't associate your identity anymore)
  • Allow USB debug. UAD* already runs adb devices, so you can skip that. You can connect wirelessly by running some adb commands; click on the relevant Android version:

NOTES:

  • For Linux & Mac users, if UAD-ng doesn't run, ensure it has execution permission:
chmod +x uad-ng-*
  • Chinese phone users may need to use the AOSP list (instead of "OEM") to remove some stock apps, because those Chinese manufacturers (especially Xiaomi and Huawei) have been using the IDs of AOSP packages for their own (modified & closed-source) apps.
  • You might have to run this software whenever you install an OEM system-update to your phone, as some uninstalled apps could be reinstalled.
Clone this wiki locally