microg/gmscore

★ 13,249JavaAudience · developerComplexity · 4/5LicenseSetup · hard

Mindmap

mindmap
  root((microg))
    What it replaces
      Google Play Services
      Push notifications
      Account sign-in
      Location services
    Why it matters
      Works without Google
      Privacy-focused devices
      Custom Android ROMs
    License
      Apache 2.0
      Open source
    Setup
      Wiki-based install
      Not on Play Store
      Custom ROM required

mindmap root((microg)) What it replaces Google Play Services Push notifications Account sign-in Location services Why it matters Works without Google Privacy-focused devices Custom Android ROMs License Apache 2.0 Open source Setup Wiki-based install Not on Play Store Custom ROM required

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Run Google-dependent Android apps on a privacy-focused phone that doesn't ship with Google Play Services installed

USE CASE 2

Add push notification support to a custom Android build that normally lacks Google Cloud Messaging

USE CASE 3

Use microG to enable Google account sign-in on a de-Googled Android device like GrapheneOS or CalyxOS

USE CASE 4

Study how Google's proprietary location, messaging, and authentication APIs can be reimplemented as open-source

Tech stack

JavaAndroid

Getting it running

Difficulty · hard Time to first run · 1day+

Installation requires a custom Android ROM and following the project wiki, not installable as a standard app from an app store.

Apache License 2.0: use, modify, and distribute freely for any purpose including commercial, as long as you include the original copyright notice and license.

In plain English

microG Services is a free and open-source software project that recreates Google Play Services, the background system that many Android apps rely on. According to the README, it is a framework that lets applications built for Google Play Services run on devices or systems where Play Services is not available. To understand why this matters: many Android phones come with Google's own software preinstalled, and a lot of apps quietly depend on it for things like notifications, sign-in, and location. On devices that do not ship with Google's services, such as certain privacy-focused Android builds, those apps can break. microG aims to fill that gap by providing its own compatible version of the same framework, so the apps keep working. The README itself is short. It does not list specific features or walk through installation. Instead it points readers to the project wiki for downloads and setup instructions, and to a separate translation page for people who want to help translate the software into other languages. The repository's own description and topic tags mention areas such as authentication, cloud messaging, Firebase, and geolocation, which hint at the kinds of Google services it tries to replace, but the README does not explain these in detail. The code is released under the Apache License 2.0, a permissive open-source license, with copyright held by the microG Project Team for the years 2013 to 2025. Because the README is mainly a pointer to external documentation, anyone wanting to actually install or use microG will need to follow the linked wiki rather than this page.

Copy-paste prompts

Prompt 1

Explain how microG replaces Google Play Services on a de-Googled Android phone and which apps are most likely to break without it

Prompt 2

Help me understand which parts of microG handle push notifications versus location versus sign-in so I know what to enable for my use case

Prompt 3

Walk me through the microG wiki setup steps for installing it on a custom Android ROM that doesn't include Google apps

Prompt 4

Show me how microG implements the Firebase Cloud Messaging API so I can understand whether my app's notifications will work

Open on GitHub → Explain another repo

← microg on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.