# nisrulz/sensey

:zap: [Android Library] Play with sensor events & detect gestures in a breeze.

Repository: https://github.com/nisrulz/sensey
Canonical: https://ross.abutalabs.com/products/sensey
Language: Kotlin
License: Apache-2.0
License Family: permissive
Topics: android-library, detect-gestures, gesture-detection, sensor, shake-detection, handwave-detection, light-detection, android, movement-detection, chop-detection, wrist-twist-detection, proximity-sensor, wave-detection, libraries
Last push: 2026-06-08T00:54:15+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 86, release rhythm 8, longevity 100
- inputs: {"age_days": 3947, "days_push": 87, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2659, forks 267 (observed 2026-08-28T04:07:07.431525+00:00)

## What it is
Sensey is an Android library that simplifies sensor event handling and gesture detection, removing boilerplate for detecting gestures like shake, flip, proximity, and wave. It offers lifecycle-aware registration with callback and Kotlin coroutines/Flow APIs, including Compose integration.

## Use cases
- detect shake gestures in my android app
- detect when the device is flipped face down
- use the proximity sensor to trigger actions
- detect wrist twist or chop gestures
- collect sensor gesture events as kotlin flow
- detect raise to ear or pickup device gestures

## When to choose
- you need common device gesture detection on Android without writing sensor boilerplate
- you want lifecycle-aware or Compose-friendly sensor event streams
- you want a wide catalog of prebuilt gestures like shake, flip, tilt, and clap

## When to avoid
- you need custom raw sensor data processing beyond the provided gestures
- your app targets platforms other than Android
- you need gesture recognition from camera or touch-screen input rather than hardware sensors

## Facets
- artifact type: library
- maturity: active
- function: sdk, plugin-system
- domain: mobile-development, android-tools
- platform: -
- tags: gesture-detection, sensor-events, kotlin, coroutines-flow, jetpack-compose, lifecycle-aware, android

## Member repositories
- nisrulz/sensey (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:07.431525+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:18:25.014274+00:00, confidence not recorded.
  - readme: https://github.com/nisrulz/sensey (fetched 2026-08-28T04:07:07.431525+00:00, sha fcf048fc2e50)
- Data as of 2026-08-30T08:39:29.467469+00:00.