Skip to content

hxreborn/gboard-material-expressive-black

Repository files navigation

Gboard Material Expressive Black

LSPosed module that restores pitch black backgrounds to Gboard on Android 16, bypassing Material 3 Expressive enforcement while preserving dynamic theme colors.

GitHub Release GitHub Downloads Xposed repo downloads Android API Kotlin APK Size

Why This Module?

Starting with Android 16 and Material 3 Expressive, Gboard enforces tinted grey surface colors instead of pitch black. This design change breaks AMOLED power savings and prevents pure black themes.

This module intercepts Material You color lookups at the system level using LSPosed hooks, replacing surface container colors with pitch black while preserving wallpaper-derived dynamic theme colors.

Visual Comparison

Module off

Stock without borders

Module on

Module without borders

With key borders on

Module off

Stock with borders

Module on

Module with borders

Requirements

  • Android 12+ (Android 16+ recommended for grey background fix)
  • An LSPosed Manager version with API 101 support (required for now)

Tested on Pixel 9 Pro, Android 16 (BP3A.251105.015), LSPosed, KernelSU Next. Functionality on other configurations untested.

Installation

  1. Install LSPosed with API 101 support
  2. Download latest APK from releases
  3. Install APK and enable module in LSPosed Manager
  4. Add Gboard to module scope
  5. Force stop Gboard
  6. Open any text field to trigger Gboard

Building from source

git clone https://github.com/hxreborn/gboard-material-expressive-black.git
cd gboard-material-expressive-black
./gradlew assembleDebug

Build requirements: JDK 21, Gradle 8.7+

License

License: MIT

This project is licensed under the MIT License - see the LICENSE file for details.