Metadata-Version: 2.1
Name: PyAdbUninstall
Version: 0.1.0
Summary: Thinker GUI for uninstall Android bloatware Apps via 'adb' without root.
Home-page: https://github.com/jedie/PyAdbUninstall
Author: Jens Diemer
Author-email: pypi@jensdiemer.de
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5

--------------
PyAdbUninstall
--------------

Thinker GUI for uninstall Android bloatware Apps via "adb" without root.

* activate "devloper mode"

* install Android Debug Bridge (e.g.: ``sudo apt install adb``)

* connect device via USB

* start ``adb_uninstall``

See also:

* de: `https://www.kuketz-blog.de/android-system-apps-ohne-root-loeschen/ <https://www.kuketz-blog.de/android-system-apps-ohne-root-loeschen/>`_

* en: `https://forum.xda-developers.com/honor-6x/how-to/guide-list-bloat-software-emui-safe-to-t3700814 <https://forum.xda-developers.com/honor-6x/how-to/guide-list-bloat-software-emui-safe-to-t3700814>`_

created 2019 by Jens Diemer
GNU General Public License v3 or later (GPLv3+)

* `https://github.com/jedie/PyAdbUninstall/ <https://github.com/jedie/PyAdbUninstall/>`_

* `https://pypi.org/project/PyAdbUninstall/ <https://pypi.org/project/PyAdbUninstall/>`_

-----
notes
-----

You can't just install all listed apps. Some of them are essential system app and deinstall will brick or damages the OS!

There are two modes:

* ``uninstall apps`` - Will deinstall the package for the current user

* ``deactivate apps`` - Will only deactivate the package for the current user

It's safer to just deactivate the apps ;)

uninstall / locked apps
=======================

There is a list of apk package names that are "locked" in PyAdbUninstall

But this list is incomplete!

The list is ``LOCKED_APPS`` in:

* `adb_uninstall/constants.py <https://github.com/jedie/PyAdbUninstall/blob/master/adb_uninstall/constants.py>`_

Please help to complete this list by github pull request ;)

-------------------------------
package actions by hand via adb
-------------------------------

Check / init adb connection:

::

    # Just show version information:
    $ adb version
    Android Debug Bridge version 1.0.36
    Revision 1:7.0.0+r33-2

    # List of devices attached:
    $ adb devices -l

    # kill the adb server if it is running:
    $ adb kill-server

    # Kick current connection from host side and make it reconnect:
    $ adb reconnect

List all installed apk packages:

::

    $ adb shell pm list packages

Deactivate one apk package:

::

    $ adb shell pm disable-user <packagname>

Uninstall one apk package:

::

    $ pm uninstall -k --user 0 <packagname>

* ``-k`` - keep the data and cache directories

* ``--user 0`` - Deinstall only for current user

------------
dev. startup
------------

::

    # clone repository from github:
    ~$ git clone https://github.com/jedie/PyAdbUninstall.git

    # create virtualenv
    ~$ cd PyAdbUninstall
    ~/PyAdbUninstall$ ./create_env.sh

    # activate virtualenv
    ~/PyAdbUninstall$ source bin/activate

    # Start GUI:
    (.virtualenv) ~/PyAdbUninstall$ adb_uninstall

-----------
help wanted
-----------

* Fix tkinter GUI (scaling the app)

* Complete ``LOCKED_APPS`` list (see above)

Pull Requests are welcome ;)

