{"id":15687058,"url":"https://github.com/giorgosxou/hexapterygon","last_synced_at":"2025-04-30T16:07:30.255Z","repository":{"id":156533379,"uuid":"633034696","full_name":"GiorgosXou/hexapterygon","owner":"GiorgosXou","description":"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.","archived":false,"fork":false,"pushed_at":"2025-01-30T18:35:21.000Z","size":1894,"stargazers_count":12,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-30T16:04:56.492Z","etag":null,"topics":["android","debloater","debloating","hexapterygon","installer","module","phone","software","tool","unicurses","uninstaller","utility"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GiorgosXou.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-04-26T16:31:39.000Z","updated_at":"2025-03-21T07:23:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"52083302-dc7c-4188-bfa4-8c8bce6f7b02","html_url":"https://github.com/GiorgosXou/hexapterygon","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GiorgosXou%2Fhexapterygon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GiorgosXou%2Fhexapterygon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GiorgosXou%2Fhexapterygon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GiorgosXou%2Fhexapterygon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GiorgosXou","download_url":"https://codeload.github.com/GiorgosXou/hexapterygon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251739654,"owners_count":21635892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","debloater","debloating","hexapterygon","installer","module","phone","software","tool","unicurses","uninstaller","utility"],"created_at":"2024-10-03T17:42:49.013Z","updated_at":"2025-04-30T16:07:30.165Z","avatar_url":"https://github.com/GiorgosXou.png","language":"Python","funding_links":["https://www.paypal.com/donate/?hosted_button_id=XLWAVDMHBYACY)*"],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n\u003ch3\u003e\n  \u003ca href=\"\"\u003eHEXAPTERYGON\u003c/a\u003e \u003ch5\u003eUnleashing the power of self destruction\u003c/h5\u003e\n\u003c/h1\u003e\n\u003cp\u003e\n    \u003ca href=\"https://github.com/GiorgosXou/hexapterygon/pulse\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/last-commit/GiorgosXou/hexapterygon?color=%4dc71f\u0026label=Last%20Commit\u0026logo=github\u0026style=flat-square\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/GiorgosXou/hexapterygon/blob/master/LICENSE\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/GiorgosXou/hexapterygon?label=License\u0026logo=GNU\u0026style=flat-square\"/\u003e\n\t\u003c/a\u003e\n\n\u003c/p\u003e\n\u003ch1\u003e\u003c/h1\u003e\n\u003c/div\u003e\n\nLess 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.\n\n\n# 📦 Features\n- ***Current:***\n- - [Uni-curses](https://github.com/unicurses/unicurses) compatible component\n- - Auto removes-installs-executes\n- - User-friendly \\ easy-to-use\n- - [Fixed-version pkg control](#-questions)\n- - Can be used as a module\n- - Cross-platform\n- ***Future:***\n- - Rooting\n- - Restoring \n- - Better Security\n- - Better User-Interface\n- - [More auto-debloating lists](https://github.com/GiorgosXou/hexapterygon/tree/main/device_repo_lists)\n\n\n# ⚙️ Configure\n\nBefore begining the process of debloating, make sure you:\n\n- Backed-up your personal data *(Advised)*\n- `pip install hexapterygon --upgrade`\n- Have [Android SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) installed \n- Enabled `developer mode` \u0026 `USB debugging` *(under settings)*\n- Enabled [Security settings](## 'Allow granting permissions and simulating input via USB (if possible)') \u0026 [Install via USB](## '[INSTALL] installing won\\'t work if it is not enabled') *(optionally, [usually necessary])*\n- Disabled services under `setting \u003e ... \u003e Device admin apps` *(optionally)*\n\n*\u003csup\u003e[click here for more informations](#-questions)\u003c/sup\u003e*\n\n# 💥 Debloat\nTo 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:\n\n```terminal\n$ hexapterygon username/my_repository\n```\n```terminal\n$ hexapterygon ./my_debloating_list.txt\n```\n```terminal\n$ hexapterygon ./folder_full_of_lists_named_by_type_identifier_txt\n```\n[📝 *(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)\n\n\u003cimg style=\"center\" src=\"./imgs/Peek.gif\"\u003e\n\n# 🫴 Contribute\n### 📜 Debloating lists\nYour 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:\n\n- ***Create a new repository with a folder called `devices` where you:***\n- - Create your debloating-list(s) in the form of `{type_identifier}.txt` \n- - - (use: `hexapterygon --getid` to get the `{type_identifier}`)\n- - - [(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)\n- ***Make a pull-request or open an issue and:*** \n- - ask to add your repo (see `device_repo_lists`)\n\nAnd you are done\n\n### 💻 To the code\nPropose whatever you want, just don't mess up with my weird indentation :P\n\n# 🗺️ Documentation\nThe only documentation that you need is the code itself. JK, it is under construction 🛠️🏗️\n\n# 🔍 Research\nMy research can be found under my personal debloating list [here](https://github.com/GiorgosXou/Our-Xiaomi-Redmi-5A-riva-debloating-list/#research) \n\n# 💭 Questions\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ci\u003eHow do I install \u003ca href=\"https://developer.android.com/studio/releases/platform-tools\" target=\"_blank\"\u003eAndroid SDK Platform Tools\u003c/a\u003e?\u003c/i\u003e\u003c/summary\u003e\n\n\u003e 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))*\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\u003ci\u003eHow do I make sure \u003ca href=\"https://developer.android.com/studio/releases/platform-tools\" target=\"_blank\"\u003eAndroid SDK Platform Tools\u003c/a\u003e and `adb` are installed?\u003c/i\u003e\u003c/summary\u003e\n\n\u003e 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\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\u003ci\u003eWhere are `Device admin apps` and what do I disable?\u003c/i\u003e\u003c/summary\u003e\n\n\u003e Somewhere under settings, depends on the device. \n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\u003ci\u003eWhy do I get a `github.GithubException.RateLimitExceededException` and what can I do?\u003c/i\u003e\u003c/summary\u003e\n\n\u003e 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)*\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\u003ci\u003eHow do I get the {type_identifier}?\u003c/i\u003e\u003c/summary\u003e\n\n\u003e Just run the command `hexapterygon --getid` *(while your authorized device is connected)*\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e\u003ci\u003eHow do I use version control for a package?\u003c/i\u003e\u003c/summary\u003e\n\n\u003e Simply do `my.package.name|v` where v is the version-number\n\n\u003c/details\u003e\n\n\n\n\n\n\n\n\n\u003c!-- # 🔍 Research :P no! i have done way more reasearch --\u003e \n\u003c!-- - ***ADB Related:*** --\u003e\n\u003c!-- - - ***Python Libraries:*** --\u003e\n\u003c!-- - - - [pure-python-adb *(Currently using)*](https://github.com/Swind/pure-python-adb) --\u003e\n\u003c!-- - - - [adbutils](https://github.com/openatx/adbutils) --\u003e\n\u003c!-- - - - [adb_shell](https://github.com/JeffLIrion/adb_shell) --\u003e\n\u003c!-- - - - [python-adb](https://github.com/google/python-adb) --\u003e\n\u003c!-- - - ***Questions:*** --\u003e\n\u003c!-- - - - [Get application version name using adb](https://stackoverflow.com/questions/11942762/get-application-version-name-using-adb) --\u003e\n\u003c!-- - ***XDA:*** --\u003e\n\u003c!-- - - ***Random:*** --\u003e\n\u003c!-- - - - [Packages which are safe to remove and a few problems.](https://forum.xda-developers.com/t/packages-which-are-safe-to-remove-and-a-few-problems.4006171/) --\u003e\n\u003c!-- - - - [Uninstall bloatwares No root](https://forum.xda-developers.com/t/uninstall-bloatwares-no-root.4321387/) --\u003e\n\u003c!-- - - - [Question Debloating Mi 11](https://forum.xda-developers.com/t/debloating-mi-11.4242883/) --\u003e\n\u003c!-- - - - [Other](https://forum.xda-developers.com/t/delete-this.4203903/page-2) --\u003e\n\u003c!----\u003e\n\n# 💗 Donate\n- ***[PayPal Address](https://www.paypal.com/donate/?hosted_button_id=XLWAVDMHBYACY)***\n- ***Monero Address:*** `83dxyGp3oemQvPBNKiBy61eFX9GZWruEjcNyNH2Dmgiu3HDaZ8REaoYVpGTb3AHR5ccitoKtH53wdQUN3tBJN8aMFMxhWAt`\n\n# 🕳️ Outro\nFor those wondering: \"Debloating Android Devices\" = \"Uninstalling\\Deleting preinstalled unwanted data-collecting\\spyware apps and etc.\" = \"better performance\" = \"Unleashing the power of self destruction\"\n\nHere's some reminders *(related to phone companies)*:\n- [Greek wiretapping case 2004–05](https://en.wikipedia.org/wiki/Greek_wiretapping_case_2004%E2%80%9305)\n- [Huawei Security Scandal](https://www.forbes.com/sites/kateoflahertyuk/2019/02/26/huawei-security-scandal-everything-you-need-to-know/?sh=4a1946e473a5)\n- [(Apple's) Batterygate](https://en.wikipedia.org/wiki/Batterygate)\n\n\u003c!-- Disable all permissions for as many apps as possibly you can. --\u003e\n\u003c!-- https://www.instagram.com/p/Cq0V-twIIej/ --\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiorgosxou%2Fhexapterygon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiorgosxou%2Fhexapterygon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiorgosxou%2Fhexapterygon/lists"}