https://github.com/giorgosxou/hexapterygon
A user-friendly all-in-one cross-platform, (uni-curses compatible component, module and uitility) software for orchestrating and debloating your Android devices from unwanted pre-installed crap.
https://github.com/giorgosxou/hexapterygon
android debloater debloating hexapterygon installer module phone software tool unicurses uninstaller utility
Last synced: about 1 year ago
JSON representation
A user-friendly all-in-one cross-platform, (uni-curses compatible component, module and uitility) software for orchestrating and debloating your Android devices from unwanted pre-installed crap.
- Host: GitHub
- URL: https://github.com/giorgosxou/hexapterygon
- Owner: GiorgosXou
- License: gpl-3.0
- Created: 2023-04-26T16:31:39.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-30T18:35:21.000Z (over 1 year ago)
- Last Synced: 2025-04-30T16:04:56.492Z (about 1 year ago)
- Topics: android, debloater, debloating, hexapterygon, installer, module, phone, software, tool, unicurses, uninstaller, utility
- Language: Python
- Homepage:
- Size: 1.81 MB
- Stars: 12
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Less bloatware, less spyware, improved privacy and performance from within the experience of your stock ROM. **A user-friendly** all-in-one cross-platform, *([uni-curses](https://github.com/unicurses/unicurses) compatible component, module and uitility)* software for orchestrating and debloating your Android devices from unwanted pre-installed crap.
# 📦 Features
- ***Current:***
- - [Uni-curses](https://github.com/unicurses/unicurses) compatible component
- - Auto removes-installs-executes
- - User-friendly \ easy-to-use
- - [Fixed-version pkg control](#-questions)
- - Can be used as a module
- - Cross-platform
- ***Future:***
- - Rooting
- - Restoring
- - Better Security
- - Better User-Interface
- - [More auto-debloating lists](https://github.com/GiorgosXou/hexapterygon/tree/main/device_repo_lists)
# ⚙️ Configure
Before begining the process of debloating, make sure you:
- Backed-up your personal data *(Advised)*
- `pip install hexapterygon --upgrade`
- Have [Android SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) installed
- Enabled `developer mode` & `USB debugging` *(under settings)*
- Enabled [Security settings](## 'Allow granting permissions and simulating input via USB (if possible)') & [Install via USB](## '[INSTALL] installing won\'t work if it is not enabled') *(optionally, [usually necessary])*
- Disabled services under `setting > ... > Device admin apps` *(optionally)*
*[click here for more informations](#-questions)*
# 💥 Debloat
To begin the proccess of debloating you either just run `hexapterygon` in your terminal *(while your device is connected and configured)* or `hexapterygon` and the path-*(file\folder)* or repository to you debloating list(s) like:
```terminal
$ hexapterygon username/my_repository
```
```terminal
$ hexapterygon ./my_debloating_list.txt
```
```terminal
$ hexapterygon ./folder_full_of_lists_named_by_type_identifier_txt
```
[📝 *(Lists should be in this form)*](https://github.com/GiorgosXou/Our-Xiaomi-Redmi-5A-riva-debloating-list/blob/main/devices/Xiaomi%20Redmi%205A%20riva.txt) | 📱 [Demonstration of results](https://odysee.com/hexapterygon:9)
# 🫴 Contribute
### 📜 Debloating lists
Your lists is what makes this tool actually powerfull and user-friendly, without your list-contributions this tool can't work standalone. To contribute a list you just need to:
- ***Create a new repository with a folder called `devices` where you:***
- - Create your debloating-list(s) in the form of `{type_identifier}.txt`
- - - (use: `hexapterygon --getid` to get the `{type_identifier}`)
- - - [(Take this list as an example)](https://github.com/GiorgosXou/Our-Xiaomi-Redmi-5A-riva-debloating-list/blob/main/devices/Xiaomi%20Redmi%205A%20riva.txt)
- ***Make a pull-request or open an issue and:***
- - ask to add your repo (see `device_repo_lists`)
And you are done
### 💻 To the code
Propose whatever you want, just don't mess up with my weird indentation :P
# 🗺️ Documentation
The only documentation that you need is the code itself. JK, it is under construction 🛠️🏗️
# 🔍 Research
My research can be found under my personal debloating list [here](https://github.com/GiorgosXou/Our-Xiaomi-Redmi-5A-riva-debloating-list/#research)
# 💭 Questions
How do I install Android SDK Platform Tools?
> You either manually download the tools from the link above and install them or use your package manager to install them like for example: `sudo pacman -S android-tools` *(following this [video for windows](https://www.youtube.com/watch?v=26GI3z6tI3E))*
How do I make sure Android SDK Platform Tools and `adb` are installed?
> Just run `hexapterygon` or the command `adb shell` while the phone is connected *(with `USB debugging` already enabled)*, a pop-up message on you phone should show-up, to allow the computer to connect to it
Where are `Device admin apps` and what do I disable?
> Somewhere under settings, depends on the device.
Why do I get a `github.GithubException.RateLimitExceededException` and what can I do?
> Most probably because you exceeded the github's limit for requests without a token. To solve this, you can either restart your rooter or provide a classic github-token *(without any special permissions checked)*
How do I get the {type_identifier}?
> Just run the command `hexapterygon --getid` *(while your authorized device is connected)*
How do I use version control for a package?
> Simply do `my.package.name|v` where v is the version-number
# 💗 Donate
- ***[PayPal Address](https://www.paypal.com/donate/?hosted_button_id=XLWAVDMHBYACY)***
- ***Monero Address:*** `83dxyGp3oemQvPBNKiBy61eFX9GZWruEjcNyNH2Dmgiu3HDaZ8REaoYVpGTb3AHR5ccitoKtH53wdQUN3tBJN8aMFMxhWAt`
# 🕳️ Outro
For those wondering: "Debloating Android Devices" = "Uninstalling\Deleting preinstalled unwanted data-collecting\spyware apps and etc." = "better performance" = "Unleashing the power of self destruction"
Here's some reminders *(related to phone companies)*:
- [Greek wiretapping case 2004–05](https://en.wikipedia.org/wiki/Greek_wiretapping_case_2004%E2%80%9305)
- [Huawei Security Scandal](https://www.forbes.com/sites/kateoflahertyuk/2019/02/26/huawei-security-scandal-everything-you-need-to-know/?sh=4a1946e473a5)
- [(Apple's) Batterygate](https://en.wikipedia.org/wiki/Batterygate)
