Skip to content

chayanforyou/QuickBall

Repository files navigation

QuickBall

GitHub stars GitHub forks GitHub license Platform Kotlin

QuickBall is a lightweight floating assistive ball for Android that provides quick access to essential system actions like volume control, brightness adjustment, and screen lock.

It stays visible above all apps, giving you instant system control from anywhere on your device.

If you find this project useful, please consider giving it a star!

Features

  • Quick Actions
    Instantly control volume, brightness, and lock screen.
  • Always Visible
    Floating ball appears above all apps when the device is unlocked.
  • Smart Position Memory
    Remembers the last position of the ball after screen unlock.
  • Auto-Hide on Lock Screen
    Automatically hides when the screen is locked.
  • Draggable & Movable
    Drag and place the ball anywhere on the screen.
  • Auto Edge Snap
    Snaps to the nearest screen edge when released.
  • Multi-Language Support
    Available in:
    • English
    • Hindi (हिंदी)
    • Chinese (中文)

Video Demo

sample.mov

How to Use

  1. Install the App: Build and install QuickBall on your Android device
  2. Enable Permissions:
    • Open QuickBall app
    • Grant accessibility service permission
    • Grant system settings permission
    • Grant device admin permission (for lock screen)
  3. Use the Ball:
    • Drag: Move the ball anywhere on screen
    • Tap: Open circular menu with quick actions
    • Auto-Hide: Ball automatically hides when screen locks
  4. Change Language:
    • Tap the language icon in the toolbar
    • Select from English, Hindi, or Chinese
    • App will restart with the new language

Security Note

QuickBall requires Accessibility and Device Admin permissions to perform system actions.

These permissions are only used for QuickBall functionality.

The app does not access, store, or monitor any personal data.