WaDeepDark 🌙

A minimalist, ultra-lightweight (~20KB) LSPosed module that forces a pure AMOLED Deep Dark Mode on the official WhatsApp client. No bloated features, no heavy UI injection—just true black pixels to save battery and reduce eye strain. Build Status License: MIT

✨ Features

  • Pure AMOLED Black: Replaces WhatsApp's default greenish-dark backgrounds (#111b21, #0b141a) with true pitch black (#000000).
  • Optimized Contrast: UI elements like the top app bar, bottom nav, and chat bubbles are mapped to a premium dark gray (#151515), preserving visual depth without blinding you.
  • Outgoing Bubble Neutralization: Automatically detects and darkens WhatsApp's dark teal outgoing chat bubbles.
  • Update-Proof Engine: Instead of parsing highly obfuscated WhatsApp UI classes, this module intercepts Android's lowest-level rendering engine (Canvas, Paint, and Activity creation). It survives almost all WhatsApp updates without needing a module update.
  • Anti-Ban Safe: Because it hooks the Android OS hardware-accelerated drawing framework rather than modifying WhatsApp's internal security or network logic, it operates entirely under the radar. You are using the untouched, official WhatsApp client.
  • Zero Battery Drain: Built entirely in pure Java. At roughly 20KB, it has zero background services or overhead.

⚙️ Requirements

  1. Rooted Device (Magisk, KernelSU, or APatch)
  2. LSPosed Framework installed and active
  3. Official WhatsApp (Targeting Android 9.0+)

🚀 Installation

  1. Go to the Releases page and download the latest WaDeepDark.apk.
  2. Install the APK on your device.
  3. Open the LSPosed Manager app.
  4. Go to Modules -> Enable WaDeepDark.
  5. Ensure WhatsApp (com.whatsapp) is checked in the module scope.
  6. Crucial Step: Open WhatsApp, go to Settings > Chats > Wallpaper > Change > Solid Colors and choose the first pure black color to clear the default doodle background.
  7. Force Stop WhatsApp from your Android App Settings, then reopen it to clear the UI cache.

🛠️ How it Works (For Developers)

Heavy WhatsApp mods often inject CSS, hook specific obfuscated View classes, or rely on Resources.getColor(). Those methods break constantly because modern WhatsApp uses Jetpack Compose, dynamic Material You theming, and heavily cached ColorStateLists. WaDeepDark takes a "God Mode", system-level approach. It hooks directly into android.graphics.Canvas, android.graphics.Paint, and android.app.Activity. Using targeted mathematical color formulas, the module monitors the exact hex codes WhatsApp attempts to push to the screen. Milliseconds before the greenish-gray pixels light up, the module intercepts the Paint object, preserves the original Alpha (transparency) channel, and injects pure #000000 or #151515 directly into the drawing pipeline.

🏗️ Building from Source

This project uses GitHub Actions for automated building. Every push to the main or dev branch compiles the APK automatically using a pure Java environment. If you want to build it locally:

  1. Clone the repository: git clone https://github.com/Dhangofa/WaDeepDark.git
  2. Open the project folder in terminal or Android Studio.
  3. Run the Gradle build command:
   gradle assembleRelease

Releases

5/22/2026, 3:47:21 PM

🌙 What's New in v1.0.0

Initial release of WaDeepDark!

This module forces pure AMOLED Black (#000000) on the official WhatsApp client by intercepting color rendering at the system level.

✨ Changes

  • AMOLED Deep Dark Mode: Replaced the default greenish-dark UI (#111b21) with pitch black.
  • Improved Contrast: UI elements mapped to dark gray (#0A0A0A) for better depth perception.
  • Lightweight Architecture: Built with pure Java (~20KB) for maximum performance and minimum footprint.

🚀 How to use

  1. Install the APK.
  2. Enable in LSPosed Manager.
  3. Select WhatsApp in the module scope.
  4. Force Stop WhatsApp to apply changes.

⚠️ Known Issues

  • If UI colors do not change immediately, ensure you have cleared WhatsApp's cache and performed a full Force Stop.
  • This module targets the standard rendering pipeline. Some cached assets may require a restart to fully transition to black.

Built with ❤️ for AMOLED displays.

Assets

1