Skip to content

ayxse/MotionScroll

Repository files navigation

MotionScroll Logo

MotionScroll

Installation Guide

Scroll through your Android screen using simple head movements. Built with Jetpack Compose and ML Kit.

MotionScroll is an Android application that leverages the front camera and accessibility features to enable hands-free scrolling based on head tilt detection.

Important Note: To avoid unintended scrolling when navigating within the application settings or other parts of your device, it is critically important to use the shortcut overlay to disable camera-based head tracking before you start navigating. Head tracking remains active while the app is open, and attempting to navigate menus or settings with head tracking enabled and without the shortcut overlay to quickly disable it will likely result in unwanted scrolling. Always use the shortcut overlay to toggle tracking off when you need to use standard touch or navigation methods.

Screenshots

Here's a glimpse of MotionScroll in action:

Screenshot 1 Screenshot 2 Screenshot 3
Screenshot 4 Screenshot 5 Screenshot 6

Features

  • Head-Controlled Scrolling: Navigate content vertically using up/down head tilts.
  • System-Wide Control: Works in most scrollable apps via Android's Accessibility Service.
  • Multiple Scroll Modes:
    • Continuous: Smooth scrolling while head is tilted.
    • Skip: Jumps a set distance (adjustable) with a 1s cooldown.
    • Delay: Jumps a set distance (adjustable) with a custom cooldown (seconds).
  • Adjustable Skip Distance: Fine-tune scroll amount for Skip/Delay modes via a slider.
  • Camera Toggle: Easily enable/disable head tracking.
  • Theme Support: Adapts to system Light/Dark themes.
  • Privacy Focused: Face detection processing happens on-device.

Download

  • Version: 1.0.2
  • Updated at: 2025-04-27
  • Min. Android version: API 24 (Android 7.0 Nougat) or higher
  • Download: APK on GitHub Releases

Tech Stack

  • Language: Kotlin
  • User Interface: Jetpack Compose
  • Camera: CameraX
  • Machine Learning: Google ML Kit (Face Detection)
  • Core: Android Accessibility Service, Android SDK

Building

  1. Ensure you have the latest stable version of Android Studio installed.
  2. Clone the repository: git clone https://github.com/ayxse/MotionScroll.git
  3. Open the project in Android Studio.
  4. Let Gradle sync the project dependencies.
  5. Run the app configuration on an emulator or physical device.

License

Copyright 2025 Cristian

Licensed under the Apache License, Version 2.0. See the LICENSE file for the full license text.