AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Dev Tooling/
android-ad-cleaner
android-ad-cleaner logo

android-ad-cleaner

Active·★ 8.3k·MIT·Updated 2026-11-17

android-ad-cleaner is an open-source system tuning utility (developed under the MIT license) built to eliminate intrusive OEM system advertisements, trending search banners, information feed push notifications, and lock-screen promotions across major Chinese Android distributions—including Xiaomi (HyperOS), OPPO/OnePlus (ColorOS), vivo/iQOO (OriginOS), Honor (MagicOS), and Meizu (Flyme).

Its defining architectural principle is non-destructive safety. Unlike risky modifications that require unlocking bootloaders, gaining root privileges, or aggressively deleting system packages (`pm uninstall`), the tool operates strictly over ADB. It automates toggles already present within OEM setting pages and uses benign package suspension (`pm suspend`) for dedicated ad subsystems like `com.opos.ads` and `com.miui.systemAdSolution`. Essential system functions—including system updates, lockscreen weather alerts, package installer security, and courier tracking widgets—remain entirely intact, and all suspended packages can be instantly restored with a single command.

Available as signed desktop clients for macOS and Windows, as standalone shell recipes, or as prompts delegated to command-capable AI agents. Potential users should note that the tool requires enabling developer options and USB debugging over a wired connection. Furthermore, because OEM vendors frequently reshuffle deep setting menus across minor OS updates, models lacking verified dedicated recipes may require manual step verification or interactive AI navigation.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-12.

License
MIT
Latest release
v0.4.3 · 2026-11-11
Last commit
2026-11-11
Contributors
43
Forks
672
Open issues and PRs
248
First published
2026-10-24

Source: GitHub, npm and PyPI public APIs.

#adb#agent-framework#ai-agent#android#coloros#debloat#hyperos#magicos
↗ Visit site★ GitHub
01

Features

01Works over adb without root, and changes can be restored
02Desktop client for Mac and Windows needs neither Python nor AI tools
03Device-specific scripts read settings back to confirm each change
04Takes a snapshot before changes and offers a read-only check
02

Why choose it

+Completely non-destructive: requires no rooting, bootloader unlocking, or system package deletions.
+Targeted suspension disables ad engines while preserving core weather, courier, and updater services.
+Ships certified, notarized desktop clients for macOS and Windows alongside AI-assisted CLI workflows.
+Maintains extensive verified recipes covering HyperOS, ColorOS, OriginOS, MagicOS, and Flyme models.
03

Trade-offs

!Requires enabling USB debugging and tethering the phone to a desktop computer via a data cable.
!Frequent OEM minor OS updates can change deep navigation paths, breaking unverified recipe steps.
!Certain vendor protections (such as private settings on select vivo models) still require brief manual confirmation.
!Does not support pure HarmonyOS NEXT devices running the proprietary HDC bridge without Android ADB.
04

Maintenance check

ActiveChecked: 2026-11-12
Last commit
2026-11-11
Commits, last 90 days
100+
Releases, last 90 days
18
Latest release
v0.4.3 (2026-11-11)
Open issues
248
Recent issues with at least one comment
20/21
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 0, 0, 0, 0, 0, 0, 0, 0, 26, 172, 404, 194

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #287 [问题] 华为mate50,鸿蒙4.0失败11 comments · 2026-10-29
  • #64 [新机型] 华为mate40pro 鸿蒙系统4.2.0版本 没有去广告的脚本可用。11 comments · 2026-10-26
  • #193 [问题] HyperOS 4(CP2A.260605.016)参考脚本 xiaomi-M154FF 有 4/9 段失败,浏览器被应用锁挡住时被误报为启动失败10 comments · 2026-10-27
  • #912 [问题] Xiaomi 15 Pro(2410DPN6CC)浏览器段入口走不通:底栏无「菜单」,「我的」→ 设置打不开9 comments · 2026-11-09
  • #238 [问题] 荣耀 PTP-AN20 MagicOS 10 Android 16:应用市场直达DirectActivity崩溃、主题布局差异、音乐荣耀版无广告开关8 comments · 2026-10-28

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

Android
Via adb
Verified via docs
macOS
Desktop Client
Verified via docs
Windows
Desktop Client
Verified via docs
06

Use cases

↳Remove system ads from a new OPPO, vivo, Xiaomi or Honor phone
↳Silence marketing notification channels while keeping other notifications
↳Help family members clean up a phone with a few clicks on a computer
07

Alternatives

⚡Top VS:
VSai-agents-from-zero★6.0k→VSdsh-blender-plugin★2.2k→VSdsh-Go★26.0k→VScindy★10.3k→
ai-agents-from-zero logo
ai-agents-from-zero★ 6.0k
🚀 2026 最系统的 AI Agent 速成指南|智能体实战教程 · 完整学习路径 + 实战项目 + 面试题库 · 对标大模型应用开发工程师岗位 · 覆盖LangChain / LangGraph / Coze / Dify / MCP / skills / LLM / RAG / 提示词 · 企业级部署与微调 · 从0到企业级落地 + 从学习到上线项目 + 面试准备一体化
VSCompare→
dsh-blender-plugin logo
dsh-blender-plugin★ 2.2k
DSH × Blender 直连实时插件 v2.6.1:15 个模型工具让 AI 驱动 GUI Blender;支持 dsh-TUI(选中 chip / 页脚状态 / @ 提及 / /blender),活动状态置顶并可一键暂停 AI,原生选中/集合/子元素直送 DSH,随包建模 skill,支持 WSL / Windows / macOS。
VSCompare→
uniterm logo
uniterm★ 1.2k
All-in-one terminal covering 30+ protocols — SSH, RDP, SFTP, databases, Kubernetes and more. With a built-in AI Agent that runs multi-turn shell commands autonomously.
dsh-Go logo
dsh-Go★ 26.0k
dsh-go — DeepSeek Harness 装进口袋:手机本机运行,也能遥控你的电脑。
VSCompare→
cindy logo
cindy★ 10.3k
Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
VSCompare→
Mika logo
Mika★ 9.0k
Mika — 你手机上的私人 AI 助理,替你操作 App、上网、把事办成。An on-device AI agent for Android that operates apps and the web to get things done for you.
VSCompare→
adbfriend logo
adbfriend★ 77
Android ADB CLI tool including integrated MCP Server with common adb actions used during development
VSCompare→
grainulator logo
grainulator★ 86
Research that compiles.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Use cases07Alternatives
rddmwmddr /
android-ad-cleaner
↗

Safe ADB automation tool closing OEM system ads, tracking, and bloatware pushes without rooting

8.3k672MIT
Last commit1d ago
StatusActive
CategoryDev Tooling
Contributors43
Latest releasev0.4.3
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.