{"id":13448467,"url":"https://github.com/Nanolx/NanoDroid","last_synced_at":"2025-03-22T09:31:30.007Z","repository":{"id":48214891,"uuid":"75559096","full_name":"Nanolx/NanoDroid","owner":"Nanolx","description":"[MIRROR] See https://gitlab.com/Nanolx/NanoDroid for main repository","archived":false,"fork":false,"pushed_at":"2022-12-11T20:43:53.000Z","size":93705,"stargazers_count":522,"open_issues_count":4,"forks_count":60,"subscribers_count":32,"default_branch":"master","last_synced_at":"2024-10-28T14:27:44.455Z","etag":null,"topics":["android","fdroid","magisk","microg","rom"],"latest_commit_sha":null,"homepage":"http://nanolx.org/nanolx/nanodroid","language":"Shell","has_issues":false,"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/Nanolx.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-04T19:28:33.000Z","updated_at":"2024-10-27T19:02:03.000Z","dependencies_parsed_at":"2023-01-27T06:45:55.523Z","dependency_job_id":null,"html_url":"https://github.com/Nanolx/NanoDroid","commit_stats":null,"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nanolx%2FNanoDroid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nanolx%2FNanoDroid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nanolx%2FNanoDroid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nanolx%2FNanoDroid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nanolx","download_url":"https://codeload.github.com/Nanolx/NanoDroid/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244937751,"owners_count":20535124,"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","fdroid","magisk","microg","rom"],"created_at":"2024-07-31T05:01:46.413Z","updated_at":"2025-03-22T09:31:24.986Z","avatar_url":"https://github.com/Nanolx.png","language":"Shell","funding_links":[],"categories":["Shell","android"],"sub_categories":[],"readme":"Table of Contents\n=================\n\n   * [NanoDroid](#nanodroid)\n   * [Table of Contents](#table-of-contents)\n      * [Current Release](#current-release)\n      * [Downloads](#downloads)\n         * [Primary Mirror](#primary-mirror)\n         * [SHA256 Checksum and GPG Signature](#sha256-checksum-and-gpg-signature)\n         * [Snapshots](#snapshots)\n      * [Custom builds](#custom-builds)\n      * [Supported Android Versions](#supported-android-versions)\n      * [Recommended Thirdparty Projects](#recommended-thirdparty-projects)\n      * [Support](#support)\n      * [ChangeLog](#changelog)\n      * [Summary](#summary)\n      * [Packages](#packages)\n         * [F-Droid Repository](#f-droid-repository)\n      * [Details](#details)\n      * [Installation](#installation)\n      * [microG Setup](#microg-setup)\n      * [Issues](#issues)\n      * [License \u0026amp; Credits](#license--credits)\n      * [TODO](#todo)\n      * [FAQ](#faq)\n\nCreated by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)\n\n# NanoDroid\n\nNanoDroid is an installer for various OpenSource projects, most noticably [microG](https://microg.org/) and [F-Droid](https://f-droid.org/). It supports all Android 4.4+ phones and all partition layouts (System-as-root, A/B) and can be installed as a Magisk module. NanoDroid also includes several tools (eg. GNU Bash, tools from util-linux/bsdmainutils and more) and additional features (system debloating, init scripts, automatic logcat creation), aswell as a companion F-Droid Repository.\n\nFurthermore it allows the user to do fine-graded installations using configuration files to choose what to install, or if several alternatives are available, which of them. See [Installation](#installation) below.\n\nThe full microG experience NanoDroid contains a modified Play Store allowing (in-)app-purchases with microG, which would normally not be possible. It also tries to remove all previously installed GApps on its own. For ROMs without builtin signature spoofing support, NanoDroid includes an on-device Patcher which tries to patch your ROM from either TWRP or Magisk Manager.\n\n**NanoDroid** was previously called **NanoMod** (before version 16.0).\n\n## Current Release\n\n* Stable: 23.1.2.20210117 \"BusyCompat\"\n* Beta: ---\n\n## Downloads\n\n### Primary Mirror\n\nOnly the latest stable and beta releases are maintained and are available on Nanolx:\n\n* Stable Downloads [\u003e Nanolx](https://downloads.nanolx.org/NanoDroid/Stable)\n* Beta Downloads [\u003e Nanolx](https://downloads.nanolx.org/NanoDroid/Beta)\n\n### SHA256 Checksum and GPG Signature\n\nSince version 18.3.1 all releases hosted on *nanolx.org* contain a SHA256 checksum and GPG signature to check their validity. AFH does provide the SHA256 checksum on the downloads summary page, but does not allow to upload a GPG signature.\n\nYou can verify the checksum with the public GPG key:\n\n* download the public key from [photonic.asc](https://downloads.nanolx.org/NanoDroid/Stable/photonic.asc)\n  * import it using `gpg --import photonic.asc`\n* download and import using `gpg` from pgp.mit.edu:\n  * `gpg --keyserver pgp.mit.edu --recv B0ABCE622A077B584B81339E340FD70EFFC52B26`\n\n\n```bash\ngpg --verify NanoDroid-19.0.20181027.zip.sha256.sig\nsha256sum -c NanoDroid-19.0.20181027.zip.sha256\n```\n\nAdditionally, you may want to ensure the signing date is close to the release date.\n\n### Snapshots\n\nYou can create snapshots from this repository using the `build-package` script.\n\nSee the [build-package documentation](doc/BuildPackage.md) for more information.\n\n## Custom builds\n\nThe following applications are custom builds (see [F-Droid Repository](#f-droid-repository) below):\n\n* Play Store (reason: re-signed and modified to support (in-)app-purchases with microG GmsCore)\n* MPV (reason: infrequent updates)\n\nThe git repository as central place/navigational point for all custom builds from NanoDroid is located here:\n\n* https://gitlab.com/Nanolx/nanodroid-patches\n\n## Supported Android Versions\n\nNanoDroid officially supports the following Android versions:\n\n* 4.4 / SDK 19 (KitKat)\n  * System Mode only (Magisk does not support KitKat)\n* 5.0 / SDK 21 (Lollipop)\n* 5.1 / SDK 22 (Lollipop)\n* 6.0 / SDK 23 (Marshmallow)\n* 7.0 / SDK 24 (Nougat)\n* 7.1 / SDK 25 (Nougat)\n* 8.0 / SDK 26 (Oreo)\n* 8.1 / SDK 27 (Oreo)\n* 9.0 / SDK 28 (Pie)\n  * Patcher works if your ROM's services.jar already contains classes.dex\n     * [\u003e Deodex Instructions](doc/DeodexServices.md)\n* 10.0 / SDK 29 (Q)\n  * Patcher works if your ROM's services.jar already contains classes.dex\n     * [\u003e Deodex Instructions](doc/DeodexServices.md)\n* 11.0 / SDK 30 (R)\n  * Patcher does not work from TWRP\n  * Patcher works from Magisk if your ROM's services.jar already contains classes.dex\n     * [\u003e Deodex Instructions](doc/DeodexServices.md)\n\nEarlier versions will never officially be supported (you may still report bugs, though). Future versions will be officially supported, eventually.\n\n## Recommended Thirdparty Projects\n\n* [Busybox](https://forum.xda-developers.com/showthread.php?t=2239421) by Osm0sis (highly recommended for all NanoDroid scripts properly working)\n* [GNU Nano editor](https://forum.xda-developers.com/showthread.php?t=2239421) by Osm0sis (simple, powerful commandline editor)\n\n## Support\n\n[\u003e XDA](https://forum.xda-developers.com/apps/magisk/module-nanodroid-5-0-20170405-microg-t3584928) Support Thread\n\n## ChangeLog\n\nFull, user-readible [\u003e ChangeLog](ChangeLog.md)\n\n## Summary\n\n**NanoDroid** can be installed as a Magisk Module or directly to `/system`, most of the functionalities are available, in System Mode too.\n\nMore information about Magisk [\u003e XDA](https://forum.xda-developers.com/apps/magisk)\n\nNanoDroid includes\n\n* microG and its companions\n  * GApps are auto-removed during installation\n     * using [\u003e NanoDroid-Overlay](doc/NanoDroidOverlay.md)\n     * the Uninstaller will restore them in System Mode (or re-flash the ROM)\n     * see the [\u003e GApps Removal List](doc/GAppsRemoval.md)\n  * location packages conflicting with unified Nlp will be auto-removed during installation\n     * using [\u003e NanoDroid-Overlay](doc/NanoDroidOverlay.md)\n     * the Uninstaller will restore them (or re-flash the ROM)\n     * see the [\u003e GApps Removal List](doc/GAppsRemoval.md#list-of-removed-location-providers)\n* [\u003e F-Droid](https://f-droid.org) and it's privileged extension\n  * alternatively you can install [\u003e Aurora Droid](https://f-droid.org/en/packages/com.aurora.adroid) and it's services extension\n* modified Play Store to allow (in-)app-purchases with microG\n  * this required the Play Store to be modified, see the [\u003e patch](https://gitlab.com/Nanolx/microg-phonesky-iap-support)\n  * alternatively [\u003e Aurora Store](https://f-droid.org/en/packages/com.aurora.store) and it's services extension can be installed instead\n* custom init scripts\n* pseudo-debloat feature (Magisk Mode)\n  * disables applications systemless-ly\n  * pre-configured [\u003e default settings](doc/NanoDroidOverlay.md)\n* force-debloat feature (Sytem Mode)\n  * moves applications out of the way to /data/media/0/nanodroid_backup/\n  * pre-configured [\u003e default settings](doc/NanoDroidOverlay.md)\n* several Open Source applications\n  * include replacements for the pseudo-debloated applications\n  * full list of [\u003e included applications](doc/Applications.md)\n* on-device framework-patcher for microG support (signature spoofing)\n  * with automatic de-odexing up to Android 8.1\n* additional components\n  * GNU Bash shell (with Less pager)\n  * Addon.d support for System Mode installation\n     * restores NanoDroid after ROM update\n     * re-debloates GApps, if required\n\n## Packages\n\nSee the [Packages](doc/Packages.md) summary for information about the available packages.\n\n### F-Droid Repository\n\nIn order to ease updating NanoDroid's custom application builds, you can use its companion [F-Droid Repository](https://www.nanolx.org/fdroid/repo).\n\n## Details\n\nSee the [\u003e Detail information](doc/Details.md) for full details on microG, F-Droid, features and utilities included with NanoDroid.\n\n## Installation\n\nSee the [Installation](doc/Installation.md) docs for instructions.\n\n## microG Setup\n\nSee the [microG setup](doc/microGsetup.md) documentation.\n\n## Issues\n\nSee [the list of known issues](doc/Issues.md) and their respective fixes or workarounds.\n\n## License \u0026 Credits\n\nMy own work (NanoDroid itself) is licensed under the GNU General Public License version 3 or newer [\u003e GNU](https://www.gnu.org/licenses/gpl-3.0.txt).\n\nFor more details (including authors and license) on every provided application or Software press the link next to it.\n\nAdditional credits go to\n\n* Mar-V-In for microG\n  * https://github.com/microg\n* topjohnwu for Magisk\n  * https://github.com/topjohnwu/Magisk\n* Lanchon for dexpatcher and haystack\n  * https://github.com/dexpatcher\n* osm0sis for GNU Nano and Busybox\n  * https://forum.xda-developers.com/showthread.php?t=2239421\n* shadow53 for automatic apk grabbing base code\n  * https://shadow53.com/android/no-gapps/\n* ale5000 for GApps Removal list and native signature spoofing detection\n  * https://github.com/micro5k\n* anestisb for vdexExtractor\n  * https://github.com/anestisb/vdexExtractor\n* JesusFreke for smali/baksmali\n  * https://github.com/JesusFreke/smali\n* Zackptg5 for zstd binaries\n  * https://github.com/Zackptg5/Cross-Compiled-Binaries-Android\n\nSpecial Thanks to the contributors (starting with most recent contribution)\n\n* TanyaEleventhGoddess\n  * various improvements and fixed for `build-package`\n* Gia90\n  * Android 6.0 support for Patcher\n  * fixes for x86_64 support\n* Vavun\n  * OsmAnd package\n  * several contributions to NanoDroid (and its former microG GmsCore fork)\n\nSpecial Thanks to the beta testers\n\n* xenithorb\n* ShapeShifter499\n\n## TODO\n\n## FAQ\n\n```\nQ: Will there be a GApps version, instead of microG?\nA: No. But you can choose not to populate microG.\n\nQ: What devices is this tested on?\nA: OnePlus 5T, OnePlus 3T, Nexus 6\n\nQ: What ROMs was this tested on?\nA: AICP, OmniROM, NitrogenOS. It should work on any LineageOS / AOSP based ROM and on most Stock ROMs.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNanolx%2FNanoDroid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNanolx%2FNanoDroid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNanolx%2FNanoDroid/lists"}