Scroll Time is an Android application that helps you control the time spent watching short videos (YouTube Shorts, TikTok, Instagram Reels). The application works through the accessibility service and does not require root permissions.
| Component | Purpose |
|---|---|
LogTrackingService |
Accessibility service for screen analysis and time tracking |
TimeManager |
Time management, storage in SharedPreferences, reset to a new day |
PermissionHelper |
Checking and requesting permissions |
MainActivity |
Main screen with status and navigation |
SettingsActivity |
Setting limits for each application |
SplashActivity |
Loading screen at startup |
| Application | Method of determination |
|---|---|
| YouTube Shorts | Text "Shorts", ID elements with "shorts", vertical buttons |
| TikTok Reels | ID of elements with "video", "reel", "short" |
| Instagram Reels | Text contains "reel" |
| Key | Description |
|---|---|
last_reset_date |
Last reset date |
total_time_{package} |
Total time in the app |
shorts_time_{package} |
Time for short videos |
{package}:daily_limit |
Total limit |
{package}:shorts_limit |
The limit of short |
| Event | Action |
|---|---|
| Opening of Shorts/Reels | Timer start, countdown |
| View Shorts/Reels | Adding 1 second every second |
| Exceeding the short limit | Blocking (swipe down), notification |
| Exiting Shorts/Reels | Timer stop, time saving |
| Switching to normal video | Timer stop, continuation of total time |
| Exceeding the total limit | Blocking the entire application |
| New Day (00:00) | Reset all counters |
| Permission | Purpose |
|---|---|
POST_NOTIFICATIONS |
Limit Exceedance Notifications (Android 13+) |
SYSTEM_ALERT_WINDOW |
Displaying on top of other windows |
BIND_ACCESSIBILITY_SERVICE |
Accessibility service for screen analysis |
FOREGROUND_SERVICE |
Background operation of the service |