Advanced Features and Options
Clone this wiki locally
All variants of the Open GApps installer (except Aroma*) will look for and take extra configuation options from a gapps-config file. This file is completely optional; without it, the installers will function exactly as described in the Package Comparison chart.
The gapps-config file allows for these kinds of customizations and more:
- You can limit which GApps are installed.
(example use case: "I don't want Google Play Books to be installed.")
- You can limit which stock apps the installer removes.
(example use case: "I want to install Google Camera but I don't want the stock camera removed.")
- You can make the installer remove stock apps apps of your choice.
(example use case: "I want to remove the stock Spare Parts app.")
* The Aroma Package includes the Super package and a GUI that provides roughly the same set of customizations as the gapps-config file. It can load and save configurations, but it uses its own format and will not read the gapps-config file.
gapps-config file location
You can place the gapps-config file in
/sdcard/Open-GApps/gapps-config.txt, or in 11 other locations as follows.
The gapps-config file must be named one of the following:
The gapps-config file must be placed in one of the following folders:
- the folder containing the Open GApps installer (takes precedence)
You can have a device-specific gapps-config file. You will need your device name, which you can find in
open_apps_log.txt or in the name of your ROM download. The gapps-config file must be named one of the following:
Device-specific config files will take precedence over the non-device-specific ones.
Writing and testing the gapps-config file
The gapps-config file consists of one keyword per line. The available keywords are categorized in the sections below.
Comments and whitespace
You can add notes or comments to your gapps-config using a
#. Anything following a
# will be ignored until the end of that line. For example,
# Exclude Search would be completely ignored, while
Search # Exclude Search would process the first
Search keyword (since it appeared BEFORE the
Case, order, spaces, and empty lines are ignored in the gapps-config file.
To perform a test installation that will only simulate an install, add the keyword
Test to your gapps-config. The installer will perform all system space calculations and generate a detailed
open_apps_log.txt file (in the same folder as your gapps-config), but WILL NOT MAKE ANY CHANGES to your device. This should be helpful for trying to find just the right combination of apps that will work with your particular device.
By default, the installer will generate Debug Logs that can help the devs troubleshoot any problems you might experience with the install. The logs are compressed and stored in a file named
open_gapps_debug_logs.tar.gz in the same folder as the
open_apps_log.txt file. This file can be easily attached to any bugreport on GitHub or post on XDA, making it easy for you to provide the devs important information to help troubleshoot any issues you're having. You may disable this feature by adding the keyword
NoDebug to your gapps-config.
Configuring your installation
You can transform any GApps package into one of its "little brothers" by adding one of the following keywords to your gapps-config. This will transform ALL INSTALLER BEHAVIOR (including default removals AND applications available for install) -- effectively turning it into the smaller GApps package. Valid keyword options are:
Include or Exclude GApps
You can choose either the apps you WANT installed or the apps you DON'T WANT installed.
- "Include" install: To select ONLY the apps you WANT installed, add the keyword
Includeto your gapps-config file. The installer will now install ONLY THOSE APPS you have listed in your gapps-config.
- "Exclude" install: To select ONLY the apps you DON'T want installed, no keyword is necessary, because the default behavior is an Exclude install.
To use this feature, add the the keyword for each app you want to Include/Exclude inside your gapps-config file. The following is a sample "Include" gapps-config that contains all available app keywords -- using this gapps-config without modifications will install all apps the installer has available. You start with this file and comment out the apps you do not want installed:
Include # Pico+ DialerFramework # Install Dialer Framework CalSync # Install Google Calendar Sync (except if Google Calendar is being installed) GoogleTTS # Install Google Text-to-Speech (Micro+ on 5.0-, Pico+ on 6.0+) PackageInstallerGoogle # Install Google Package Installer # Nano+ FaceDetect # Install FaceUnlock FaceUnlock # Install FaceUnlock Search # Install Google Search (including includes Hotword, excluding excludes GoogleNow and PixelLauncher) Speech # Install Offline Speech Files Hotword # Install OK Google Hotword Enrollment # Micro+ Gmail # Install Gmail CalendarGoogle # Install Google Calendar ExchangeGoogle # Install Google Exchange Services GoogleNow # Install Google Now Launcher (requires Search) # GoogleTTS # Install Google Text-to-Speech (Micro+ on 5.0-, Pico+ on 6.0+) # Mini+ CalculatorGoogle # Install Google Calculator ClockGoogle # Install Google Clock Maps # Install Google Maps TagGoogle # Install Google NFC Tags Photos # Install Google Photos GooglePlus # Install Google+ Hangouts # Install Hangouts YouTube # Install YouTube # Full+ Chrome # Install Google Chrome Browser CloudPrint # Install Google Cloud Print Docs # Install Google Docs Drive # Install Google Drive Fitness # Install Google Fit Keep # Install Google Keep NewsWidget # Install Google News & Weather Books # Install Google Play Books PlayGames # Install Google Play Games Movies # Install Google Play Movies & TV Music # Install Google Play Music NewsStand # Install Google Play Newsstand Sheets # Install Google Sheets Slides # Install Google Slides Talkback # Install Google TalkBack # Stock+ CameraGoogle # Install Google Camera ContactsGoogle # Install Google Contacts DialerGoogle # Install Google Dialer KeyboardGoogle # Install Google Keyboard Messenger # Install Google Messenger (except on tablet devices) PixelIcons # Install Google Pixel Icons StorageManagerGoogle # Install Google Storage Manager VRService # Install Google VR Services WebViewGoogle # Install Google Webview PixelLauncher # Install Pixel Launcher (requires Search and Wallpapers) PrintServiceGoogle # Install Print Service Recommendation Service Wallpapers # Install Wallpapers # Super+ AndroidPay # Install Android Pay DMAgent # Install Google Apps Device Policy GCS # Install Google Connectivity Services (excluding also excludes ProjectFi) Earth # Install Google Earth Indic # Install Google Indic Keyboard Japanese # Install Google Japanese Input Korean # Install Google Korean Input Pinyin # Install Google Pinyin Input Street # Install Google Street View Translate # Install Google Translate Zhuyin # Install Google Zhuyin Input ProjectFi # Install Project Fi by Google
Prevent automatic Stock removals
When installing a Google app that can replace a stock app, the stock app is automatically removed. For example, if you are installing Hangouts or Messenger, then the Stock SMS app will automatically be removed.
To prevent the automatic removal of the stock apps when using the Open GApps Super/Stock package, type the keyword option preceded by a '+' as shown below:
+Browser # Don't remove Stock Browser, even if Google Chrome is being installed +CalendarStock # Don't remove Stock Calendar, even if Google Calendar is being installed +CameraStock # Don't remove Stock Camera, even if Google Camera is being installed +Email # Don't remove Stock Email, even if Gmail is being installed +ExchangeStock # Don't remove Stock Exchange services, even if Google Exchange Services is being installed +Gallery # Don't remove Stock Gallery, even if Google Photos is being installed +KeyboardStock # Don't remove Stock Keyboard, even if Google Keyboard is being installed +Launcher # Don't remove Stock Launchers, even if Google Now Launcher is being installed +MMS # Don't remove Stock SMS app, even if Hangouts or Messenger is being installed +PicoTTS # Don't remove PicoTTS, even if GoogleTTS is being installed
Remove Stock apps
You can specify built-in (stock) apps you want removed. Stock removals function the same regardless of whether you're doing an "Include" or "Exclude" install.
Here are the vendors we support. Since different vendors use different names for their stock apps, some apps might remain unremoved if you are using another vendor.
- FlymeOS (BrowserIntl, Browser, CustomizeCenter, EasyLauncher, FileManager, FlymeLauncherIntl, FlymeLauncher, MzMPay, MzPay, MzInput, MzSetupWizard, MzUpdate, SystemUpdate, SystemUpdateAssistant, Weather)
- Lenovo (packageinstaller)
- MoKee (Nox launcher, YuBrowser)
- Omni (Apollo, Omni Deskclock2, OmniSwitch)
- Paranoid Android
To use this feature, add the the keyword for each stock app you want removed, inside your gapps-config file. The following is a sample gapps-config that contains all available stock removal keywords -- using this gapps-config without modifications won't remove anything (that is not automatically removed, see below). You can start with this file and uncomment the apps you want removed:
# Remove apps (uncomment a line to remove the app) # BasicDreams # Remove Basic Dreams Wallpaper # CMAccount # Remove CM Account Application # CMAudioFX # Remove CM AudioFX # CMFileManager # Remove CM File Manager # CMMusic # Remove CM Music # CMScreenCast # Remove CM ScreenCast app # CMSetupWizard # Remove CM Setup Wizard (see Notes for CMSetupWizard) # CMUpdater # Remove CM Updater # CMWallpapers # Remove CM Wallpapers # CMWeatherProvider # Remove CM Weather Underground # DashClock # Remove DashClock Widget (found in certain ROMs) # Galaxy # Remove Galaxy (also known as BlackHole) Wallpaper # Hexo # Remove Hexo Libre Theme # HoloSpiral # Remove Holo Spiral Wallpaper # NoiseField # Remove Noise Field Wallpaper # OmniSwitch # Remove OmniSwitch recent apps switcher replacement # Phasebeam # Remove Phasebeam Wallpaper # PhotoPhase # Remove Photo Phase Wallpaper # PhotoTable # Remove Photo Table Wallpaper # Browser # Remove Stock Browser # CalculatorStock # Remove Stock Calculator (automatically removed when Google Calculator is installed) # CalendarStock # Remove Stock Calendar (automatically removed when Google Calendar is installed) # CameraStock # Remove Stock Camera # ClockStock # Remove Stock Desk Clock (automatically removed when Google Clock is installed) # Email # Remove Stock Email Client # ExchangeStock # Remove Stock Exchange Services (automatically removed when Google Exchange Services is installed) # MzFileManager # Remove Stock FlymeOS File Manager # MzPay # Remove Stock FlymeOS Pay system (because MzPay services works only in China) # MzSetupWizard # Remove Stock FlymeOS SetupWizard # MzUpdater # Remove Stock FlymeOS Updaters # MzWeather # Remove Stock FlymeOS Weather (because MzWeather service work only in China) # FMRadio # Remove Stock FM Radio (not found on all devices or ROMs) # Gallery # Remove Stock Gallery # KeyboardStock # Remove Stock Keyboard (automatically removed when Google Keyboard is installed) # Launcher # Remove Stock Launcher(s) # LiveWallpapers # Remove Stock Live Wallpapers # LockClock # Remove Stock Lockscreen Clock Widget # Studio # Remove Stock Movie Studio # TagStock # Remove Stock NFC Tags (automatically removed when Google NFC Tags is installed) # PicoTTS # Remove Stock PicoTTS # PrintServiceStock # Remove Stock Print Service Recommendation Service (automatically removed when Google Print Service Recommendation Service is installed) # SimToolKit # Remove Stock SimToolKit # MMS # Remove Stock SMS (automatically removed if Google Messenger and/or Hangouts is installed) # StorageManagerStock # Remove Stock Storage Manager (automatically removed when Google Storage Manager is installed) # Terminal # Remove Stock Terminal # Themes # Remove Stock Theme Engine (will break the Settings Entry and can cause unexpected reboots on some ROMs) # VisualizationWallpapers # Remove Stock Visualization Wallpapers # WhisperPush # Remove Stock WhisperPush support
In addition to the Stock Removals above, you can remove ANY system app on your device or ROM, with the EXCEPTION of (core) apps that are part of Open GApps itself. To use this feature, enclose the name of the apk in parentheses inside your gapps-config file.
For example, to remove the Spare Parts app found in many ROMs, simply add
(SpareParts) to your gapps-config. When using this feature, keep the following in mind:
- Adding the .apk extension is not required (but will work).
- Works for all apps in any system/app or system/priv-app subfolder.
- Removes the entire contents of the folder containing the apk (including subfolders).
- Removal is also added to the
addon.dbackup script so the removals will also be applied if you update your ROM.
- Gives you the ability to do some really bad things to your device, so DO A BACKUP before trying.
WARNING: Because this feature gives you the ability to remove files that may be important to the proper function of your device, it is only recommended for very experienced users who know what they are doing.
Force DPI Setting
Open GApps normally selects the correct DPI-optimized app that suits your device, based on the information that is supplied by recovery and otherwise found in default.prop or build.prop. Sometimes one might want to override this DPI setting, e.g. for testing, in those situations the keyword
forcedpiXXX can be used, where XXX is replaced with one of the valid default DPIs including: 160, 240, 320, 480, 560 or 640.
Force New Camera
Open GApps normally detects if the device is deemed compatible with the New Camera API based on fields specified in
build.prop and a whitelist. If not deemed compatible, the newest Google Camera (version 3 and higher) will not be installed but the older version 2 instead (
googlecameralegacy). To override this detection the
forcenewcamera keyword can be used. Note: Google Camera version 3 does not work correctly on most non-Nexus devices.
Skip Google's Swype Library Setting
The Stock keyboard does normally not support gesture typing. If Google Keyboard is not being installed, Open GApps installs by default Google's swype gesture libraries to the Stock keyboard. The libraries are installed in addition to the AOSP libraries. In some cases adding these libraries is unwanted behavior (there are few reports that recent these can conflict with certain ROMs). In those situations use the
skipswypelibs keyword to skip the installation of these libraries (or remove them if previously installed).
Substitute AOSP Library with Google's Swype Library Setting
The Stock keyboard does normally not support gesture typing. If Google Keyboard is not being installed, Open GApps installs by default Google's swype gesture libraries to the Stock keyboard. The libraries are installed in addition to the AOSP libraries. In some cases these gesture libraries only work if they are installed as a replacement of the AOSP libraries (there are few reports that this is necessary with certain ROMs). In those situations use the
substituteswypelibs keyword to replace the Stock libraries. (If you re-run the installation without the keyword, the AOSP libraries are restored to their original configuration).
Skip updating vendor libraries
Open GApps by default updates certain libraries that are depended on by certain GApps (especially Face Unlock) that are stored in
/system/vendor (or a
/vendor partition via a symlink). To prevent GApps from touching (removing, adding or replacing) these vendor files use the
Skip Smart Pre-ODEXing of APKs
On Marshmallow some ROMs are set to be extremely strict when verifying the APK. This can lead to de-odexed APKs to fail verification; because the included classes.dex is not present in the APK's MANIFEST. To avoid this potential issue, Open GApps by default pre-ODEXes these APKs on 6.0+. As positive side-effect this setting also improves the performance of these applications. A downside is that it occupies more disk-space on /system, because a copy of the classes.dex has to be kept for regenerating the ODEX when updating the ROM. To disable this feature use the keyword
NoPreODEX. THE PRE-ODEX FEATURE IS TEMPORARILY DISABLED BY DEFAULT; SEE BELOW HOW TO ENABLE
Enable Smart Pre-ODEXing of APKs
To enable Pre-ODEXing on ROMs the
PreODEX can be used.
Force Clean Install Setting
Open GApps normally detects if it's a clean install or an upgrade. This affects how installation of Google Camera is treated, it won't install those unless this is a clean install to avoid problems during upgrades. To ignore the detection and enforce clean install use
forceclean keyword. Note: this setting is untested widely and may cause problems.
Protection from stupidity
To prevent you from accidentally leaving yourself with no keyboard, Launcher, or MMS app when you start your device, the installer WILL NOT ALLOW you to remove the Stock Keyboard, Launcher, or MMS app if you are not also installing a Google version of these apps. You can, however, override this protection by adding the keyword
Override to your gapps-config. Be very careful when using this option and make certain you have a replacement app already installed on your device before using this option. This keyword can also be used to override the automatic selection of
Chrome is being installed.
Links to GApps on the Play Store
- Android Pay
- Google Apps Device Policy
- Google Calculator
- Google Calendar
- Google Camera
- Google Chrome
- Google Clock
- Google Cloud Print
- Google Connectivity Services
- Google Contacts
- Google Dialer
- Google Docs
- Google Drive
- Google Earth
- Google Fit
- Google Indic Keyboard
- Google Japanese Input
- Google Keep
- Google Keyboard
- Google Korean Input
- Google Maps
- Google Messenger
- Google News & Weather
- Google Now Launcher
- Google Photos
- Google Pinyin Input
- Google Play Books
- Google Play Games
- Google Play Movies & TV
- Google Play Music
- Google Play Newsstand
- Google Search
- Google Sheets
- Google Slides
- Google Street View
- Google TalkBack
- Google Text-to-Speech
- Google Translate
- Google Webview Stub
- Google Webview
- Google Zhuyin Input
- Pixel Launcher
- Project Fi by Google