Repolode
Submit
rddmwmddr

rddmwmddr/android-ad-cleaner

Turns off ads, hot search, news feeds and marketing push notifications on Chinese Android phones (HyperOS, ColorOS, OriginOS, MagicOS) over USB, without root.

View on GitHub
Stars
6,916
Forks
620
Open issues
18
Last commit
3 hours ago

What is it?

Android Ad Cleaner is a set of scripts and a desktop client that switch off advertising, hot-search boxes, news feeds and promotional notifications built into Chinese Android skins such as HyperOS, ColorOS, OriginOS and MagicOS. It works through adb over USB and uses only the settings toggles the system and vendor apps already expose, so the phone is not rooted, unlocked or reflashed, and system updates are unaffected.

The tool works in steps: a read-only check, a snapshot before any change, device-specific recipes that walk the settings pages, per-channel control of marketing notifications, and a command to suspend known ad component packages (which requires the owner's confirmation). Search, the lock-screen card feed, app store installs and updates, weather alerts and parcel tracking are kept. Changes can be reverted with single commands.

It can be driven by an AI coding agent, by a chat AI that guides manual steps, or through a macOS and Windows desktop app that detects the phone, lets you choose what to turn off and runs the job with a live log.

Key features

  • 01Turns off personalized ads, ad tracking (OAID) and smart recommendation services in system settings.
  • 02Disables hot-search lists, news feeds and browser info streams.
  • 03Switches off store banners, splash screens and sign-in promotions.
  • 04Lets you choose marketing notification channels per app, keeping order and delivery alerts.
  • 05Suspends known ad component packages with pm suspend, reversible with one command.
  • 06Ships a macOS and Windows desktop client with device detection and a live log.

Use cases

  • Cleaning up ads and promotional pushes on a newly bought Chinese Android phone.
  • Doing the same routine on several family phones from one computer.
  • Letting an AI coding agent carry out the settings changes over adb while you review each step.
  • Documenting per-model settings paths for a phone model the project does not yet cover.

Quick start

  1. 1

    Turn on developer mode and USB debugging on the phone (see the README tutorial)

  2. 2

    Install Python dependencies from the repo folder

    pip3 install -r requirements.txt
  3. 3

    List connected phones to get the serial number and model

    python3 tool/run.py devices
  4. 4

    Run a read-only check on the phone before changing anything

    python3 tool/run.py -s <序列号> check

Things to know

  • Only works with Chinese Android phones (HyperOS, ColorOS, OriginOS, MagicOS) and needs a USB connection.
  • Automated scripts exist only for a few tested models; other phones need manual steps or a new script.
  • Vendor settings change with system updates, so results may vary and a backup is recommended first.

In collections

Android ADB and debloat toolsOpen-source AI agent frameworks & appsPrivacy & local-first toolsAndroid apps & phone tools

Topics

#android#adb#debloat#privacy#ad-blocker#python#hyperos#coloros#ai-agent#magicos

FAQ

What is android-ad-cleaner?
Turns off ads, hot search, news feeds and marketing push notifications on Chinese Android phones (HyperOS, ColorOS, OriginOS, MagicOS) over USB, without root. Android Ad Cleaner is a set of scripts and a desktop client that switch off advertising, hot-search boxes, news feeds and promotional notifications built into Chinese Android skins such as HyperOS, ColorOS, OriginOS and MagicOS. It works through adb over USB and uses only the settings toggles the system and vendor apps already expose, so the phone is not rooted, unlocked or reflashed, and system updates are unaffected.
Is android-ad-cleaner free to use? What license does it have?
android-ad-cleaner is open source under the MIT license. Check the license terms before using it in commercial products.
Is android-ad-cleaner still maintained?
Actively maintained. The last commit to android-ad-cleaner was on Nov 7, 2026.
What can I use android-ad-cleaner for?
Cleaning up ads and promotional pushes on a newly bought Chinese Android phone. Doing the same routine on several family phones from one computer. Letting an AI coding agent carry out the settings changes over adb while you review each step. Documenting per-model settings paths for a phone model the project does not yet cover.
How do I install android-ad-cleaner?
Turn on developer mode and USB debugging on the phone (see the README tutorial) Install Python dependencies from the repo folder: pip3 install -r requirements.txt List connected phones to get the serial number and model: python3 tool/run.py devices Run a read-only check on the phone before changing anything: python3 tool/run.py -s <序列号> check
Where can I get android-ad-cleaner?
The source code and installation instructions are on GitHub: https://github.com/rddmwmddr/android-ad-cleaner

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects