Skip to content

Commit 9ed7f34

Browse files
PixelCode01PixelCode01
authored
Merge pull request #3 from PixelCode01/copilot/fix-2
Add Shizuku-compatible shell scripts for all brands (no PC required)
2 parents 8b2a0c8 + 69783fa commit 9ed7f34

File tree

14 files changed

+3597
-1
lines changed

14 files changed

+3597
-1
lines changed

‎Honor/SHIZUKU_USAGE.md‎

Lines changed: 167 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,167 @@
1+
# Honor Bloatware Remover - Shizuku Version
2+
3+
This shell script version is specifically designed for Honor device users who want to remove bloatware using **Shizuku** without needing a PC.
4+
5+
## What is Shizuku?
6+
7+
Shizuku is an Android app that allows you to run ADB commands directly on your device without connecting to a computer. It's perfect for removing bloatware when you don't have access to a PC.
8+
9+
## Prerequisites
10+
11+
1. **Honor device** running Magic UI (any version)
12+
2. **Shizuku app** installed and activated
13+
3. **Terminal app** that supports Shizuku (like Termux or Shizuku's built-in terminal)
14+
15+
## Installation Steps
16+
17+
### Step 1: Install and Setup Shizuku
18+
19+
1. Download **Shizuku** from:
20+
- [GitHub Releases](https://github.com/RikkaApps/Shizuku/releases)
21+
- [Google Play Store](https://play.google.com/store/apps/details?id=moe.shizuku.privileged.api)
22+
23+
2. **Enable Developer Options** on your Honor device:
24+
- Go to Settings → About Phone
25+
- Tap "Build Number" 7 times
26+
- Go back to Settings → System & Updates → Developer Options
27+
- Enable "USB Debugging"
28+
29+
3. **Activate Shizuku**:
30+
- Connect your device to a PC once (just for Shizuku setup)
31+
- Enable USB Debugging and authorize the computer
32+
- Open Shizuku app and follow the setup instructions
33+
- Once activated, you can disconnect from PC
34+
35+
### Step 2: Download the Script
36+
37+
1. Download the `honor_remover.sh` script to your device
38+
2. Save it to `/sdcard/` or any accessible location
39+
40+
### Step 3: Run the Script
41+
42+
1. Open your terminal app (with Shizuku support)
43+
2. Grant Shizuku permissions to the terminal app
44+
3. Navigate to where you saved the script:
45+
```bash
46+
cd /sdcard/
47+
```
48+
4. Make sure the script is executable:
49+
```bash
50+
chmod +x honor_remover.sh
51+
```
52+
5. Run the script:
53+
```bash
54+
./honor_remover.sh
55+
```
56+
57+
## Usage Options
58+
59+
The script provides several modes:
60+
61+
### 1. Interactive Removal (Recommended)
62+
- Shows only installed bloatware packages
63+
- Categorizes by risk level (SAFE, CAUTION, DANGEROUS)
64+
- Lets you select specific packages to remove
65+
66+
### 2. Batch Removal
67+
- Removes all SAFE packages automatically
68+
- Creates backup before removal
69+
- Fastest method for maximum bloatware removal
70+
71+
### 3. List All Packages
72+
- Shows every installed package on your device
73+
- Useful for identifying unknown bloatware
74+
75+
### 4. Create Backup Only
76+
- Creates a backup of installed packages
77+
- Recommended before any removal
78+
79+
## Safety Features
80+
81+
- **Automatic Backup**: Creates package list backup before removal
82+
- **Risk Levels**:
83+
- 🟢 **SAFE**: No impact on core functionality
84+
- 🟡 **CAUTION**: May affect some features
85+
- 🔴 **DANGEROUS**: Critical system components
86+
- **Confirmation Prompts**: Prevents accidental removal
87+
- **Detailed Logging**: Shows exactly what was removed
88+
89+
## Package Categories
90+
91+
### SAFE Packages (Recommended for Removal)
92+
- Honor AppGallery
93+
- Honor Browser
94+
- Honor Music/Video
95+
- Game Center
96+
- Various Honor utilities
97+
- Pre-installed social media apps
98+
99+
### CAUTION Packages (Remove with Care)
100+
- Honor Launcher (install alternative first)
101+
- Default Phone/Messages apps
102+
- Gallery app
103+
- Assistant services
104+
105+
### DANGEROUS Packages (DO NOT REMOVE)
106+
- Honor Mobile Services
107+
- System Server
108+
- Core Honor ID services
109+
110+
## Troubleshooting
111+
112+
### Script Won't Run
113+
- Ensure Shizuku is active and has proper permissions
114+
- Check that your terminal app has Shizuku access
115+
- Verify the script file permissions (`chmod +x honor_remover.sh`)
116+
117+
### Packages Won't Remove
118+
- Some system packages may only be disabled, not fully removed
119+
- This is normal behavior for certain core apps
120+
- Check if Shizuku is still active
121+
122+
### Device Issues After Removal
123+
- Restart your device first
124+
- If problems persist, you can reinstall packages from Honor AppGallery
125+
- In extreme cases, factory reset will restore everything
126+
127+
## Recommended Terminal Apps
128+
129+
1. **Termux** (with Shizuku add-on)
130+
2. **Material Terminal** (Shizuku compatible)
131+
3. **Terminal Emulator** (various Shizuku-compatible versions)
132+
133+
## Important Notes
134+
135+
- ⚠️ **Always backup** your device before removing packages
136+
- 🔄 Some apps may return after Magic UI updates
137+
- 📱 Test on a secondary device first if possible
138+
- 🏭 Factory reset will restore all removed applications
139+
- 🔧 This script is specifically for Honor devices with Magic UI
140+
141+
## What Gets Removed
142+
143+
This script targets common Honor bloatware including:
144+
- Pre-installed social media apps (Facebook, Instagram, etc.)
145+
- Honor's duplicate apps (when you have alternatives)
146+
- Unnecessary system utilities
147+
- Regional bloatware apps
148+
- Marketing and data collection services
149+
150+
## Support
151+
152+
If you encounter issues:
153+
1. Check that your Honor device is supported
154+
2. Ensure Shizuku is properly activated
155+
3. Verify you have the necessary permissions
156+
4. Try running individual commands manually first
157+
158+
## Alternative Method (Without Shizuku)
159+
160+
If you have access to a PC with ADB:
161+
1. Use the Python version from the main repository
162+
2. Follow the standard ADB setup instructions
163+
3. Run the interactive Python script
164+
165+
---
166+
167+
**Remember**: Removing system apps can affect device functionality. Always understand what you're removing and create backups first.

‎Honor/honor-bloatware-list.md‎

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,12 @@
22

33
This document contains a comprehensive list of bloatware packages found on Honor devices running Magic UI. Each package is categorized by risk level to help you make informed removal decisions.
44

5+
## Available Tools
6+
7+
- **Python Script**: `honor_remover.py` - For use with PC and ADB
8+
- **Shell Script**: `honor_remover.sh` - For use with Shizuku (no PC required)
9+
- **Shizuku Guide**: See [SHIZUKU_USAGE.md](SHIZUKU_USAGE.md) for setup instructions
10+
511
## Risk Levels
612
- **SAFE**: Can be removed without affecting core functionality
713
- **CAUTION**: May affect some features, remove with care
@@ -122,4 +128,18 @@ This document contains a comprehensive list of bloatware packages found on Honor
122128
- Factory reset will restore all removed applications
123129
- Use the interactive removal mode for safer operation
124130
- Honor devices may have different packages depending on region
125-
- Magic UI updates may restore some removed apps
131+
- Magic UI updates may restore some removed apps
132+
133+
## Using the Tools
134+
135+
### Python Script (PC Required)
136+
```bash
137+
python honor_remover.py
138+
```
139+
140+
### Shell Script (Shizuku - No PC Required)
141+
```bash
142+
./honor_remover.sh
143+
```
144+
145+
For detailed Shizuku setup instructions, see [SHIZUKU_USAGE.md](SHIZUKU_USAGE.md).

0 commit comments

Comments
 (0)