MCPcopy Index your code
hub / github.com/0x192/universal-android-debloater

github.com/0x192/universal-android-debloater @0.5.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release 0.5.1 ↗ · + Follow
136 symbols 221 edges 16 files 2 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Universal Android Debloater GUI

DISCLAIMER: Use at your own risk. I am not responsible for anything that could happen to your phone.

uad_screenshot

This software is still in an early stage of development. Check out the issues, and feel free to contribute!

Summary

This is a complete rewrite in Rust of the UAD project, which aims to improve privacy and battery performance by removing unnecessary and obscure system apps. This can also contribute to improve security by reducing the attack surface.

Packages are as well documented as possible in order to provide a better understanding of what you can delete or not. The worst thing which could happen is removing an essential system package needed during boot causing then an unfortunate bootloop. After about 5 failed system boots, the phone will automatically reboot in recovery mode and you'll have to perform a FACTORY RESET. So make a backup first!

In any case, you can NOT brick your device with this software! That's the main thing, right?

Features

  • [X] Uninstall/Disable and Restore/Enable system packages
  • [X] Multi-user support (e.g apps in work profiles)
  • [X] Export/Import your selection in uad_exported_selection.txt
  • [X] Multi-device support: you can connect multiple phones at the same time
  • [X] All your actions are logged so you never forget what you've done

NB : System apps cannot really be uninstalled without root (see the FAQ)

Universal debloat lists

  • [X] GFAM (Google/Facebook/Amazon/Microsoft)
  • [X] AOSP
  • [X] Manufacturers (OEM)
  • [X] Mobile carriers
  • [X] Qualcomm / Mediatek / Miscellaneous

Manufacturers debloat lists

  • [ ] Archos
  • [X] Asus
  • [ ] Blackberry
  • [ ] Gionee
  • [X] LG
  • [X] Google
  • [X] Fairphone
  • [ ] HTC
  • [X] Huawei
  • [X] Motorola
  • [X] Nokia
  • [X] OnePlus
  • [X] Oppo
  • [X] Samsung
  • [X] Sony
  • [X] Tecno
  • [ ] TCL
  • [ ] Wiko
  • [X] Xiaomi
  • [ ] ZTE

Mobile carriers debloat lists

Country Carriers
France Orange, SFR, Free, Bouygues
USA T-Mobile, Verizon, Sprint, AT&T
Germany Telekom
UK EE

How to use it

  • Read the FAQ!
  • Do a proper backup of your data! You can never be too careful!
  • Enable Developer Options on your smartphone.
  • Turn on USB Debugging from the developer panel.
  • From the settings, disconnect from any OEM accounts (when you delete an OEM account package it could lock you on the lockscreen because the phone can't associate your identity anymore)
  • Install ADB:

LINUX

  • Install Android platform tools on your PC :

Debian Base: bash $ sudo apt install android-sdk-platform-tools Arch-Linux Base: bash $ sudo pacman -S android-tools Red Hat Base: bash $ sudo yum install android-tools OpenSUSE Base: bash $ sudo zypper install android-tools

MAC OS

  • Install Homebrew
  • Install Android platform tools bash $ brew install android-platform-tools

WINDOWS

NOTE: Chinese phones users may need to use the AOSP list for removing some stock apps because those Chinese manufacturers (especially Xiaomi and Huawei) have been using the name of AOSP packages for their own (modified & closed-source) apps.

IMPORTANT NOTE: You will have to run this software whenever your OEM pushes an update to your phone as some uninstalled system apps could be reinstalled.

How to contribute

Hey-hey-hey! Don't go away so fast! This is a community project. That means I need you! I'm sure you want to make this project better anyway.

==> How to contribute

Special thanks

  • @mawilms for his LotRO plugin manager (Lembas) which helped me a lot to understand how to use the Iced GUI library.
  • @casperstorm for the UI/UX inspiration.

Extension points exported contracts — how you extend this code

Opposite (Interface)
(no doc) [1 implementers]
src/core/uad_lists.rs

Core symbols most depended-on inside this repo

style
called by 43
src/gui/style.rs
hex_to_color
called by 30
src/core/theme.rs
active
called by 16
src/gui/style.rs
adb_shell_command
called by 7
src/core/sync.rs
update_selection_count
called by 5
src/core/utils.rs
perform_commands
called by 5
src/core/utils.rs
waiting_view
called by 4
src/gui/views/list.rs
request_builder
called by 3
src/core/utils.rs

Shape

Method 52
Function 35
Class 30
Enum 18
Interface 1

Languages

Rust100%

Modules by API surface

src/gui/style.rs26 symbols
src/core/theme.rs14 symbols
src/gui/views/list.rs13 symbols
src/gui/mod.rs13 symbols
src/core/update.rs13 symbols
src/core/sync.rs13 symbols
src/core/utils.rs12 symbols
src/core/uad_lists.rs11 symbols
src/gui/views/settings.rs6 symbols
src/gui/widgets/package_row.rs5 symbols
src/gui/views/about.rs4 symbols
src/core/config.rs4 symbols

For agents

$ claude mcp add universal-android-debloater \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page