Giter VIP home page Giter VIP logo

giorgosxou / hexapterygon Goto Github PK

View Code? Open in Web Editor NEW
9.0 2.0 0.0 1.81 MB

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.

License: GNU General Public License v3.0

Python 100.00%
android debloater debloating installer module phone software tool uninstaller utility

hexapterygon's Introduction

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 compatible component, module and uitility) software for orchestrating and debloating your Android devices from unwanted pre-installed crap.

πŸ“¦ Features

  • Current:
    • 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

βš™οΈ 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 installed
  • Enabled developer mode & USB debugging (under settings)
  • Enabled Security settings & Install via USB (optionally, [usually necessary])
  • Disabled services under setting > ... > Device admin apps (optionally)

click here for more informations

πŸ’₯ 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:

$ hexapterygon username/my_repository
$ hexapterygon ./my_debloating_list.txt
$ hexapterygon ./folder_full_of_lists_named_by_type_identifier_txt

πŸ“ (Lists should be in this form) | πŸ“± Demonstration of results

🫴 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})
  • 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

πŸ’­ 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)

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)

πŸ’— Donate

  • PayPal Address
  • 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):

hexapterygon's People

Contributors

giorgosxou avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

hexapterygon's Issues

Features and ideas

  • Add independent comments into debloating lists
  • last update to displayed repos
  • Execute multiple repo-lists for one device like choices 1,2,3,... or generally lists (one for google one for xiaomi one for...)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.