Skip to content

Degoogling Magisk modules for stock Android (powered by microG)

License

Notifications You must be signed in to change notification settings

SelfRef/noogle-magisk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

noogle-magisk

Magisk modules for removing/replacing Google applications on stock Android 11-15.

Modules

Name Description
Noogle microG Installs microG Services in place of Google Services (if present)
Noogle Debloat [WIP] Removes other Google system apps from Android (still can be installed from store)

Install

It requires Magisk to be installed obviously as it's a Magisk module. If you don't have it yet, consult the official installation instructions.

Tip

It's a good idea to enable ADB debugging as well before installing in case of any issues.

  1. Download latest version from releases
    • Or build it yourself
  2. Install through Magisk app
  3. Reboot
  4. In Magisk click "Action" button next to module to grant permissions
    • Or open microG app and grant them through Self-Check
  5. Ensure all permission boxes are checked in Self-Check
    • If not, tap them to set the correct option
  6. Check signature spoofing status at the top
  7. If you have issues with microG crashing, install microG as user apps: check troubleshooting
    • You can do it quickly using scripts/install-user-apks.sh

Build

  1. Use Linux, Mac or WSL on Windows
  2. Install zip, curl, jq if not present
  3. Download APKs manually and place in apk/
    • Or run scripts/pull-latest-microg.sh (not reliable)
  4. Run scripts/build-noogle-microg.sh
    • Check -h flag for help with build options
    • Module will be created in dist/
  5. Or run scripts/install-noogle.sh to build and install through ADB

Tested

Configurations

Module/Type Notes
LSPosed + FakeGapps Both official and from JingMatrix
Play Integrity Fix Requires installing user updates
User updates Installing microG updates from F-Droid repo

Devices

The module was tested on:

Device OS Android Version
Nothing Phone (1) NothingOS 3.0 15
Lenovo Yoga Tab 13 Stock 13
Samsung Galaxy Tab S LineageOS 17.1 10

More to come...

Troubleshooting

Signatures are not correct

In order for microG apps to have the correct signatures visible by Android, your ROM must allow for signature spoofing. If it does not (like any stock Android), this is the way I recommend:

  1. Enable Zygisk in Magisk's settings
  2. Download and install LSPosed through Magisk
  3. Download and install FakeGApps APK
  4. Reboot
  5. Open LSPosed from notifications and enable FakeGapps module
    • Leave default System Framework selected only
  6. Reboot
  7. Check in microG Self-Check if signatures are correct now

microG crashing

If you want to use other modules interacting with microG, like Play Integrity Fix on top of this module, it's necessary to install both microG Services and microG Companion (same APKs as in this module, from official site) on top, as user updates. Then Play Integrity Fix will work properly. In the future this workaround may be not necessary.

Bootloop

In this case if you have ADB debugging enabled just connect your phone to PC and run scripts/disable-noogle.sh in terminal. It will disable Noogle microG module and reboot your device.

More nuclear option is to run adb shell magisk --remove-modules. It will remove all modules from Magisk and reboot.

If you don't have ADB enabled, you may try to restart the device a few times (holding Power + Vol-) while keeping Vol- for a while until animalted boot animation will start. This will trigger Magisk safe mode and modules will be disabled. More about this in official documentation.

QA

  • Q: What is the difference between this and other microG installers?
  • A: This module aims for stock Android support with Google apps preinstalled and doesn't require debloating Google apps first. Should work on AOSP-based as well.