Grayscaler

C10udburst

1.0 · GitHub

Download APK

Display management Android 7.0+ 1 year ago GPL-3.0

61 ShizuStore

9.1k GitHub

164 Stars

5 MB Size

More about this app

Keep your phone mostly monochrome, but allow apps like camera to be in color

Grayscaler

Grayscaler is an Android app designed to help users stay focused by keeping their phone mostly monochrome. However, it allows specific apps, like the Camera or Gallery, to remain in full color when needed. This can help reduce distractions, encourage mindful phone usage, and promote digital well-being.

Features

Whitelist Mode: Select apps that should remain in color while the rest of the phone stays grayscale.
Blacklist Mode: Choose specific apps to be grayscale while keeping the rest in color.
Accessibility Service: Detects the currently open app and adjusts the screen colors accordingly.
Shizuku Integration: Uses Shizuku to grant required permissions for editing system settings.

Why Use Grayscaler?

Reduce distractions and improve focus.
Enhance digital well-being by minimizing excessive screen time.
Maintain color in essential apps like Camera and Gallery while keeping others monochrome.

Requirements

Android device with Shizuku installed and set up.
Accessibility permissions enabled for Grayscaler.

Installation

Install Shizuku and start the service.
Download and install Grayscaler.
Grant Accessibility permissions when prompted.
Select your preferred mode (Whitelist or Blacklist) and configure your app list.

Usage

Ensure Shizuku is running in the background. (Required first time only)
Open Grayscaler and select your mode.
Add apps to the whitelist or blacklist as needed.

Usage without Shizuku

You can use Grayscaler without Shizuku by manually granting the required permissions using ADB.

adb shell pm grant io.github.cloudburst.grayscaler android.permission.WRITE_SECURE_SETTINGS
adb shell pm grant io.github.cloudburst.grayscaler android.permission.PACKAGE_USAGE_STATS
adb shell pm grant io.github.cloudburst.grayscaler android.permission.QUERY_ALL_PACKAGES

License

This app is licensed under GPL-3.0 license

Feel free to contribute or provide feedback to improve Grayscaler!

How Shizuku is used

Can keep phone monochrome per app selection via `pm grant` shell commands through Shizuku.

This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.

How this app uses Shizuku

Shizuku is used to give the app the system permissions it needs for automatic per app monochrome control.

Grant system permissions: The app runs fixed pm grant shell commands through Shizuku to obtain WRITE_SECURE_SETTINGS, PACKAGE_USAGE_STATS and QUERY_ALL_PACKAGES on supported Android versions.
Keep display monochrome per app: With those permissions the app watches the foreground app and turns system monochrome mode on or off, so the phone stays mostly grayscale while selected apps stay in color in whitelist mode, or the reverse in blacklist mode.