Skip to content

feat: add ADB debloat script for Xiaomi/Redmi/HyperOS phones - #110

Draft
Stensel8 wants to merge 2 commits into
mainfrom
claude/adb-debloat-redmi-9ggrgg
Draft

feat: add ADB debloat script for Xiaomi/Redmi/HyperOS phones#110
Stensel8 wants to merge 2 commits into
mainfrom
claude/adb-debloat-redmi-9ggrgg

Conversation

@Stensel8

@Stensel8 Stensel8 commented Sep 6, 2026

Copy link
Copy Markdown
Member

Summary

Adds a non-root ADB debloat script for Xiaomi/Redmi/POCO phones running HyperOS (tested against a Redmi Note 15 5G on HyperOS 3), plus a README with prep steps, usage, and sources.

Type of change

  • feat — new script/feature
  • fix
  • content
  • docs
  • chore
  • refactor
  • style
  • revert

What's included

  • android/redmi_debloat.shpm uninstall -k --user 0 based debloater (no root needed, reversible until factory reset):
    • info / list — inspect known bloat packages and what's actually installed, without changing anything
    • remove [--dry-run] [--include-miui] [-y] — removes a curated, tiered package list; always writes a removed-packages-<timestamp>.txt restore file
    • restore <package> / restore-all <file> — reinstalls for the current user
    • Follows this repo's existing bash conventions (shared Write-Log/Stop-Script helpers, Verb-Noun function names, set -euo pipefail)
  • android/README.md — prep steps (enabling USB debugging, platform-tools install), usage, and an explanation of the three package tiers:
    • Tier 1 (safe): ordinary third-party bloat (Facebook, Amazon, Netflix, Office suites, bundled games, etc.) — on by default
    • Tier 2 (opt-in via --include-miui): Xiaomi/HyperOS-branded bundled apps
    • Tier 3 (documented only, never touched): packages where sources conflict or real breakage has been reported (e.g. com.miui.daemon, com.android.stk, com.xiaomi.xmsf)

Package lists and risk notes were compiled from several community debloat lists, linked in android/README.md.

Checklist

  • PR title follows the commit convention
  • Tested: bash -n + shellcheck -S warning pass clean; exercised list/remove --dry-run/remove -y/restore-all against a stubbed adb to verify parsing and control flow
  • No broken internal links

🤖 Generated with Claude Code

https://claude.ai/code/session_019Uo91Mmg5jG3o7DsTjzVk5


Generated by Claude Code

Non-root pm uninstall --user 0 based debloater with a curated,
tiered package list (safe third-party bloat vs. opt-in Xiaomi/HyperOS
apps vs. documented do-not-touch), a dry-run mode, and restore/restore-all
to reverse any removal.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019Uo91Mmg5jG3o7DsTjzVk5
Copilot AI lite review requested due to automatic review settings September 6, 2026 23:07

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@Stensel8
Stensel8 marked this pull request as draft September 6, 2026 23:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants