Home

Aaahh Ahh edited this page Jul 17, 2016 · 7 revisions

microg logo GmsCore

Overview

microG GmsCore is a free and open implementation of the Google Play Services Framework. It allows applications calling proprietary Google APIs to run on AOSP-based ROMs like Replicant and CyanogenMod. Acting as a replacement for the closed-source Google Apps (GAPPS), it is a powerful tool to reclaim your privacy while enjoying Android core features.

Features

  • Opt-in to Google Services and extend application support
  • On-/Offline location service
  • Easy on battery, memory and CPU
  • No bloatware
  • Works on real devices, test emulators and virtual mobile infrastructure
  • Free and open source (Apache 2.0 licensed)

System Requirements

Your Android system needs to support signature spoofing so GmsCore can pretend the existence of the official Play Services to applications calling Google APIs. OmniROM 5, 6, and MarshRom provide out-of-the-box support.

Modules

GmsCore includes the Unified Network Location Provider module (UnifiedNlp) which handles application calls to Google's network location provider. It relies on location and address lookup backends which must be installed separately. For more information on UnifiedNlp and its backends, please refer to the module's wiki.

For a full-working microG setup, you may consider to install a PlayStore replacement application as well as the Services Framework Proxy (GsfProxy) module to provide Google's push messaging service. See also Installation.

Project status

This is alpha-grade software and not yet ready for production use. Do not use if you don't know what you're doing.

The current status of implemented APIs is documented on this wiki page.

Contributions welcome!

Please report bugs and include logs, screenshots, version numbers and device information depending on what issue you observed. Also, do not bother to contact the author of third-party apps when it might be related to microG services. If you created a logcat, but fear or know it contains sensitive data, you can send a private message. If the problem is related to geolocation, please file an issue in the UnifiedNlp project, even if you're using it through GmsCore.

Thanks for continously supporting this project with feedback, pull requests and donations!