ScrollIt (Internal Samsung Auto-Scroll Tool)

ScrollIt is a Kotlin Android app for internal use on Samsung phones. It provides:

1. Main app screen for permission setup and advanced tuning.
2. Floating overlay for runtime control of downward auto-scroll in other apps.

What the app does

• Shows permission status (overlay + accessibility).
• Opens the exact Android settings screens needed to enable permissions.
• Starts a floating, draggable overlay above other apps.
• Performs repeated downward-page scrolling using AccessibilityService + dispatchGesture().
• Supports two behavior modes from the main app:
  • Stable (more conservative and reliable)
  • Smooth (smaller/faster gesture cycle)
• Uses 10 speed levels in overlay, controlled only by + / - buttons.
• Collapses into a small edge bubble and expands back on tap.

Required permissions

1. Draw over other apps (SYSTEM_ALERT_WINDOW)
2. Accessibility service (ScrollIt Accessibility)
3. Foreground service (overlay runs as foreground service)

Build APK

Note: this repository uses text-only launcher scripts (gradlew, gradlew.bat) that call a local Gradle installation.

Windows (recommended)

cd C:\Users\teply\Documents\scrollit
.\gradlew.bat testDebugUnitTest assembleDebug lintDebug

Linux/macOS

cd /workspace/scrollit
./gradlew testDebugUnitTest assembleDebug lintDebug

Expected APK path

• Relative: app/build/outputs/apk/debug/app-debug.apk
• Example absolute (Linux in this repo): /workspace/scrollit/app/build/outputs/apk/debug/app-debug.apk
• Example absolute (Windows): C:\Users\teply\Documents\scrollit\app\build\outputs\apk\debug\app-debug.apk

USB install via ADB

adb devices
adb install -r C:\Users\teply\Documents\scrollit\app\build\outputs\apk\debug\app-debug.apk

Samsung setup

Enable Developer options

1. Settings → About phone → Software information
2. Tap Build number 7 times

Enable USB debugging

1. Settings → Developer options
2. Enable USB debugging
3. Connect USB and confirm RSA key prompt

Enable overlay permission

1. Open ScrollIt
2. Tap Open overlay permission settings
3. Enable Appear on top for ScrollIt

Enable accessibility service

1. Open ScrollIt
2. Tap Open accessibility settings
3. Accessibility → Installed apps → ScrollIt Accessibility
4. Enable service and confirm warning dialogs

How to test all features

1. Open ScrollIt and check both status rows are Enabled.
2. In Advanced tuning, set:
   • mode (Stable / Smooth)
   • distance
   • interval
   • gesture duration
3. Tap Launch floating overlay.
4. Drag overlay to desired place.
5. Tap Start on long page (Samsung Internet / Chrome).
6. Verify page scrolls downward repeatedly.
7. Tap + and -:
   • speed number updates 1..10
   • change applies while scrolling is already running
8. Tap Stop and verify scrolling stops immediately.
9. Tap Hide and verify bubble appears on screen edge.
10. Tap bubble and verify overlay expands back.
11. Tap Exit and verify overlay closes and foreground notification disappears.
12. Disable accessibility and tap Start again:

• verify visible error message, not silent failure.

Known limitations

• Some apps/screens ignore injected accessibility gestures.
• Gesture behavior differs slightly across One UI versions.
• Exact smoothness depends on app rendering and refresh timing.
• connectedDebugAndroidTest needs emulator or physical device.

Project structure (key files)

app/src/main/java/cz/teply/scrollit/
  MainActivity.kt
  OverlayService.kt
  ScrollAccessibilityService.kt
  ScrollMode.kt
  ScrollSettings.kt
  ScrollSettingsStore.kt
  ScrollSpeed.kt

app/src/main/res/layout/
  activity_main.xml
  overlay_controls.xml
  overlay_bubble.xml

app/src/main/res/xml/
  scroll_accessibility_service.xml

License

MIT. See LICENSE.