NikGapps

A short description of your project


License
MIT
Install
pip install NikGapps==3.20

Documentation

Introduction

NikGapps provides custom GApps packages tailored to individual needs, offering full configurability to install exactly the set of Google apps you want. Available in six variants, NikGapps is a unique GApps solution built from scratch to meet the needs of Android users.

Features

  • Android Go Support: Ideal for low-end devices, ensuring smooth performance.
  • Custom Architecture: Installs GApps in /product and /system_ext partitions, with fallback to /system if space is limited.
  • Full Control: Use nikgapps.config for installation preferences and debloater.config to remove unwanted components.
  • Compatibility: Dirty flash support, and can be installed over ROMs with GApps (excluding Pixel-flavored ROMs).
  • Addons: Includes useful addon packages, so you don't have to flash the entire GApps package for a single app.
  • Addon.d Support: Custom addon.d script allows selective backup and restore of apps during dirty flashes.
  • Battery Optimization: Optimize Google Play Services by turning off "Find My Device" (requires ROM support).
  • Privileged Permissions: Ensures privileged apps get necessary permissions without disabling Privileged Permission Whitelisting.

Build NikGapps Yourself

Prerequisites

Ensure you have the following tools installed:

  • Linux/MacOS: sudo apt-get install -y --no-install-recommends python3 python3-pip aapt git git-lfs apktool
  • Windows: Python3, Git, and AAPT.

Steps

  1. Configure git user name and email to make Git LFS to work

    git config --global user.name "Example"
    git config --global user.email "example@example.com"
    
  2. Set Up the Environment:

    mkdir nikgapps
    cd nikgapps
    
  3. Create a virtual environment

    Use python on Linux/MacOS and python3 on Windows (you can figure out which command works for you by running python --version or python3 --version in cmd line)

    • On Linux/MacOS:
      python3 -m venv myvenv
      source myvenv\Scripts\activate
      
    • On Windows:
      python -m venv myvenv
      myvenv\Scripts\activate
      
  4. Install builder from pip

    python3 -m pip install NikGapps
    
  5. You can now build given gapps variant

    nikgapps --androidVersion (Android Version) --packageList (gapps variant)

    Example:

    nikgapps --androidVersion 13 --packageList basic
    

Your gapps package will be in Releases directory above nikgapps directory

Total Downloads

Static Badge
SourceForge
SourceForge