Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: 3 months 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.

Awesome Lists containing this project

README 

        






  HEXAPTERYGON 
Unleashing the power of self destruction







    

      

    

    

      

	










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

- - 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](https://developer.android.com/studio/releases/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](https://developer.android.com/studio/releases/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)*



 



# 💗 Donate

- ***[PayPal Address](https://www.paypal.com/donate/?hosted_button_id=XLWAVDMHBYACY)***

- ***Monero Address:*** `83dxyGp3oemQvPBNKiBy61eFX9GZWruEjcNyNH2Dmgiu3HDaZ8REaoYVpGTb3AHR5ccitoKtH53wdQUN3tBJN8aMFMxhWAt`



# 🕳️ Outro

This is part 1/3 of a software series project called "beyond self destruction" which rises from within one's self. For those wondering: "Debloating Android Devices" = "Uninstalling\Deleting preinstalled unwanted data-collecting\spyware apps and etc." = "better performance" = "Unleashing the power of self destruction"



Just 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)