mal0/stims
1
0
Fork 0
Code Pull Requests Actions Releases Activity

modified: README.md

Browse Source
This commit is contained in:
Acid
2026-03-25 22:12:45 -04:00
parent 1ad37bd6b7
commit b1be1b5e43
1 changed files with 17 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+17 -7
View File
@@ -1,25 +1,35 @@
# stims
# About
An Android app that keeps your screen awake while specific apps are in the foreground.
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.
## What it does
### Why use over alternatives
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 at full brightness. When you switch to a different app, the screen resumes normal sleep behavior.
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
Stims requires **Usage Access** permission to detect which app is in the foreground so it can keep the phone awake.
### Usage Access (required)
On first launch the app will redirect you to the system settings screen. To enable it:
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** in the list and toggle it on
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 / One UI)
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