{"id":13845392,"url":"https://github.com/quarkslab/AERoot","last_synced_at":"2025-07-12T02:31:06.708Z","repository":{"id":40431367,"uuid":"344366068","full_name":"quarkslab/AERoot","owner":"quarkslab","description":"AERoot is a command line tool that allows you to give root privileges on-the-fly to any process running on the Android emulator with Google Play flavors AVDs.","archived":false,"fork":false,"pushed_at":"2023-11-01T09:44:31.000Z","size":107,"stargazers_count":197,"open_issues_count":1,"forks_count":23,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-11-14T03:09:06.286Z","etag":null,"topics":["android-emulator","root-privileges"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quarkslab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-03-04T05:56:58.000Z","updated_at":"2024-11-10T03:51:19.000Z","dependencies_parsed_at":"2023-02-15T23:16:00.635Z","dependency_job_id":"34676e69-5d31-4782-8099-f1187c1b2301","html_url":"https://github.com/quarkslab/AERoot","commit_stats":{"total_commits":85,"total_committers":5,"mean_commits":17.0,"dds":"0.14117647058823535","last_synced_commit":"06a385e930053b23856cdc085211a047be3ce1b9"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkslab%2FAERoot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkslab%2FAERoot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkslab%2FAERoot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkslab%2FAERoot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quarkslab","download_url":"https://codeload.github.com/quarkslab/AERoot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225784463,"owners_count":17523652,"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-emulator","root-privileges"],"created_at":"2024-08-04T17:03:22.616Z","updated_at":"2024-11-21T18:31:31.023Z","avatar_url":"https://github.com/quarkslab.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"![Python version](https://img.shields.io/badge/Python-%E2%89%A53.7-brightgreen?style=flat-square\u0026logo=python \"Python 3\")\n![Linux](https://img.shields.io/badge/Linux-x86__64-brightgreen?style=flat-square\u0026logo=linux \"Linux\")\n![macOS](https://img.shields.io/badge/macOS-x86__64-brightgreen?style=flat-square\u0026logo=apple \"macOS\")\n[![Codestyle](https://img.shields.io/badge/codestyle-black-000000?style=flat-square)](https://github.com/psf/black)\n\n![AERoot](https://user-images.githubusercontent.com/56136693/121723563-f4021c80-cae6-11eb-84bb-ac6d6dc32665.png \"AERoot Logo\")\n\n**AERoot** is a command line tool that allows you to give the root privileges on-the-fly to any process running on the Android emulator with Google Play flavors AVDs.\n\u003e This project is a rewrite from scratch of the **android-emuroot** tool (https://github.com/airbus-seclab/android_emuroot).\n\u003e It comes with new features:\n\u003e * Recent AVDs support (Android API \u003e 27)\n\u003e * Execution time optimization\n\u003e * Selection of a process by its PID\n\n# Compatible Kernels\n\n| Kernel                                             | x86    | x86_64 | Android version              |\n|----------------------------------------------------|:------:|:------:|------------------------------|\n| 3.10.0+                                            | ✓      |        | 7.0 / 7.1                    |\n| 3.18.56+                                           | ✓      |        | 8.0                          |\n| 3.18.91+                                           | ✓      |        | 8.1                          |\n| 4.4.124+                                           | ✓      | ✓      | 9.0                          |\n| 4.14.112+                                          | ✓      | ✓      | 9.0 + 10.0 (TV / Automotive) |\n| 5.4.36-00815-g3b29042c17b1                         | ✓      | ✓      | 10.0                         |\n| 5.4.43-00621-g90087296b3b1                         | ✓      | ✓      | 10.0                         |\n| 5.4.47-01061-g22e35a1de440                         | ✓      | ✓      | 10.0                         |\n| 5.4.54-android11-0-00619-g476c942d9b3e-ab6722723   | ✓      | ✓      | 11.0                         |\n| 5.4.61-android11-0-00791-gbad091cc4bf3-ab6833933   | ✓      | ✓      | 11.0                         |\n| 5.4.61-android11-2-00064-g4271ad6e8ade-ab6991359   |        | ✓      | 11.0                         |\n| 5.4.86-android11-2-00006-gae78026f427c-ab7595864   |        | ✓      | 11.0 (Automotive)            |\n| 5.4.86-android11-2-00040-g29b2beadc627-ab7157994   | ✓      | ✓      | 11.0 (TV / Automotive)       |\n| 5.10.4-android12-0-03442-gf2684370d34d-ab7068937   |        | ✓      | 12.0                         |\n| 5.10.15-android12-0-01814-gfca78df78ef2-ab7137072  |        | ✓      | 12.0                         |\n| 5.10.21-android12-0-01012-gcc574f0d3698-ab7214561  |        | ✓      | 12.0                         |\n| 5.10.21-android12-0-01145-ge82381ad9a3f-ab7230153  |        | ✓      | 12.0                         |\n| 5.10.35-android12-4-00865-gd9d0c09e0a3b-ab7349034  |        | ✓      | 12.0                         |\n| 5.10.43-android12-6-00231-g54e7412d4ff9-ab7460289  |        | ✓      | 12.0                         |\n| 5.10.43-android12-9-00001-ga30f38980440-ab7882141  |        | ✓      | 12.0                         |\n| 5.10.66-android12-9-00022-g2d6a43c0364d-ab7992900  | ✓      |        | 12.0 (TV)                    |\n| 5.10.66-android12-9-00041-gfa9c9074531e-ab7914766  |        | ✓      | 12.0                         |\n| 5.10.102-android13-0-00549-g255b30f804ac-ab8238117 | ✓      | ✓      | 13.0 + 13.0 (TV)             |\n| 5.10.107-android13-2-00451-g7ba447d0399b-ab8409457 |        | ✓      | 13.0                         |\n| 5.15.32-android13-3-00067-g7b5e736d7c63-ab8474665  |        | ✓      | 13.0                         |\n| 5.15.41-android13-6-02245-g158384f20d1e-ab8610100  |        | ✓      | 13.0                         |\n| 5.15.41-android13-8-00205-gf1bf82c3dacd-ab8747247  |        | ✓      | 13.0                         |\n| 5.15.41-android13-8-00055-g4f5025129fe8-ab8949913  |        | ✓      | 13.0                         |\n| 5.15.83-android14-5-00138-g5e28b848962c-ab9412825  |        | ✓      | 14.0                         |\n| 6.1.12-android14-0-00356-g116e1532b95d-ab9618665   |        | ✓      | 14.0                         |\n| 6.1.21-android14-3-01811-g9e35a21ec03f-ab9850788   |        | ✓      | 14.0                         |\n| 6.1.23-android14-4-00257-g7e35917775b8-ab9964412   |        | ✓      | 14.0                         |\n\n# Requirements\n\nAERoot requires [gdb](https://www.gnu.org/software/gdb/) (with Python support enabled) to run properly.\n\n# Installation\n\n## Last Release\n\n```console\npip install aeroot\n```\n\n## Current version\n\n```console\ngit clone https://github.com/quarkslab/AERoot.git\n```\n\n```console\npython3 setup.py install --user\n```\n\n## Docker\n\nA Docker image of *AERoot* is available on [dockerhub](https://hub.docker.com/r/ha0ris/aeroot).\n\nAlso, you can build an image by yourself:\n```console\ndocker build -t aeroot https://github.com/quarkslab/AERoot.git\n```\n\n### Linux\n\n#### Usage\n\n```console\ndocker run --rm \\\n           -v $HOME/.emulator_console_auth_token:$HOME/.emulator_console_auth_token \\\n           --network host \\\n           ha0ris/aeroot [aeroot options]\n```\n\n#### Example\n\n```console\ndocker run --rm \\\n           -v $HOME/.emulator_console_auth_token:$HOME/.emulator_console_auth_token \\\n           --network host \\\n           ha0ris/aeroot daemon\n```\n\n### macOS\n\n#### Usage\n\n```console\ndocker run --rm \\\n           -v $HOME/.emulator_console_auth_token:$HOME/.emulator_console_auth_token \\\n           ha0ris/aeroot --host host.docker.internal [aeroot options]\n```\n\n#### Example\n\n```console\ndocker run --rm \\\n           -v $HOME/.emulator_console_auth_token:$HOME/.emulator_console_auth_token \\\n           ha0ris/aeroot --host host.docker.internal daemon\n```\n\n# Quick-start\n\nFirst of all, you must launch the Android emulator with the gdb qemu option (`-qemu -s`).\n```console\nemulator @Your_AVD -qemu -s\n```\n\nThen run **aeroot** by choosing the mode among:\n* **pid**: give the root privileges to a process selected by its *PID*.\n* **name**: give the root privileges to a process selected by its *name*.\n* **daemon**: give the root privileges to the ADB daemon, so shells created with adb shell will automaticaly have root rigths.\n\n## Usage\n\n```console\naeroot [-h] [--verbose | --quiet] [--device DEVICE] [--host HOST] [--port PORT] {name,pid,daemon} ...\n```\n\n## Examples\n\n### *pid* mode example\n\n```console\naeroot pid 1337\n```\n\n\u003e Gives the root privileges to the process with pid 1337\n\n### *name* mode example\n\n```console\naeroot name my_process\n```\n\n\u003e Gives the root privileges to the process named \"my_process\"\n\n### *daemon* mode example\n\n```console\naeroot daemon\n```\n\n\u003e Gives the root privileges to the ADB daemon\n\n## Additional options\n\nYou can find additional options by checking the help of the tool: `aeroot -h`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquarkslab%2FAERoot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquarkslab%2FAERoot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquarkslab%2FAERoot/lists"}