About

Stims lets you select apps that should prevent your screen from turning off. When a "stimmed" app is active in the foreground, the screen stays on . When you switch to a different app, the screen resumes normal sleep behavior.

Why use over alternatives

Stims is designed to handle aggressive power managers like samsung's one UI , alternatives like caffeine won't work on these devices. If you encounter a problem please open a New Issue

---

Permissions

Usage Access (required)

Required to detect which app is in the foreground. On first launch the app will redirect you to the system settings screen.

1. Go to Settings → Apps → Special app access → Usage access
2. Find Stims and toggle it on
3. Return to the app

Without this permission the background service cannot detect foreground apps and the screen will not be kept awake.

Display over other apps (required on Samsung / OneUI)

Samsung's One UI disables the standard wake lock mechanism, so Stims uses a transparent overlay window instead to keep the screen on. The overlay is invisible and non-interactive.

1. Go to Settings → Apps → Stims → Display over other apps
2. Toggle it on
3. Return to the app — the warning banner will disappear

On stock Android and most other devices this permission is not needed and the app will work without it. It can also be enabled manually via the in-app settings for any device.

---

Building from source

Requirements

• Android Studio or the Android SDK command-line tools
• JDK 11+

Steps

git clone https://github.com/acidburnmonkey/stims.git
cd stims
./gradlew assembleDebug

The APK will be output to:

app/build/outputs/apk/debug/app-debug.apk

For a release bundle (AAB):

./gradlew bundleRelease
# output: app/build/outputs/bundle/release/app-release.aab

---

Compatibility

• Minimum: Android 7.0 (Nougat, API 24)
• Target: Android 15 (API 35)