<div align="center">
<img src="/img/logo_color.png" height="128" />
</div>
<h1 align="center">Sensey <a href="https://twitter.com/intent/tweet?text=Sensey%3A%20Android%20library%20which%20makes%20playing%20with%20sensor%20events%20%26%20detecting%20gestures%20a%20breeze%F0%9F%98%8E&url=https://github.com/nisrulz/sensey&via=nisrulz&hashtags=AndroidDev">
<img src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social"/>
</a></h1>
<div align="center">
<strong>Android library which makes playing with sensor events & detecting gestures a breeze.</strong>
<p>The library is built for simplicity and ease of use. It eliminates most boilerplate code for dealing with setting up sensor based event and gesture detection on Android.</p>
</div>
<br/>
<div align="center">
<!-- Bintray -->
<a href="https://bintray.com/nisrulz/maven/com.github.nisrulz%3Asensey/_latestVersion">
<img src="https://api.bintray.com/packages/nisrulz/maven/com.github.nisrulz%3Asensey/images/download.svg"/>
</a>
<!-- API -->
<a href="https://android-arsenal.com/api?level=14">
<img src="https://img.shields.io/badge/API-14%2B-orange.svg?style=flat"/>
</a>
<!-- Android Arsenal -->
<a href="https://android-arsenal.com/details/1/3550">
<img src="https://img.shields.io/badge/Android%20Arsenal-Sensey-green.svg?style=true"/>
</a>
<!-- Android Sweets -->
<a href="https://androidsweets.ongoodbits.com/2016/05/26/issue-20">
<img src="https://img.shields.io/badge/AndroidSweets-%2320-ff69b4.svg"/>
</a>
<!-- Android Dev Digest -->
<a href="https://www.androiddevdigest.com/digest-100/">
<img src="https://img.shields.io/badge/AndroidDev%20Digest-%23100-blue.svg"/>
</a>
<!-- Android Dev Digest -->
<a href="https://www.androiddevdigest.com/digest-131/">
<img src="https://img.shields.io/badge/AndroidDev%20Digest-%23131-blue.svg"/>
</a>
<!-- Android Weekly -->
<a href="http://androidweekly.net/issues/issue-209">
<img src="https://img.shields.io/badge/Android%20Weekly-%23209-blue.svg"/>
</a>
<!-- Android Weekly -->
<a href="http://androidweekly.net/issues/issue-245">
<img src="https://img.shields.io/badge/Android%20Weekly-%23245-blue.svg"/>
</a>
<!-- Number of Android apps (AppBrain) -->
<a href="https://www.appbrain.com/stats/libraries/details/sensey/sensey">
<img src="https://www.appbrain.com/stats/libraries/shield/sensey.svg">
</a>
<!-- Awesome Android -->
<a href="https://snowdream.github.io/awesome-android/Other.html#Gesture">
<img src="https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg"/>
</a>
<!-- GitHub stars -->
<a href="https://github.com/nisrulz/sensey">
<img src="https://img.shields.io/github/stars/nisrulz/sensey.svg?style=social&label=Star"/>
</a>
<!-- GitHub forks -->
<a href="https://github.com/nisrulz/sensey/fork">
<img src="hhttps://img.shields.io/github/forks/nisrulz/sensey.svg?style=social&label=Fork"/>
</a>
<!-- GitHub watchers -->
<a href="https://github.com/nisrulz/sensey">
<img src="https://img.shields.io/github/watchers/nisrulz/sensey.svg?style=social&label=Watch"/>
</a>
<!-- Say Thanks! -->
<a href="https://saythanks.io/to/nisrulz">
<img src="https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg"/>
</a>
<a href="https://www.paypal.me/nisrulz/5usd">
<img src="https://img.shields.io/badge/$-donate-ff69b4.svg?maxAge=2592000&style=flat">
</a>
<br/>
<!-- GitHub followers -->
<a href="https://github.com/nisrulz/sensey">
<img src="https://img.shields.io/github/followers/nisrulz.svg?style=social&label=Follow%20@nisrulz"/>
</a>
<!-- Twitter Follow -->
<a href="https://twitter.com/nisrulz">
<img src="https://img.shields.io/twitter/follow/nisrulz.svg?style=social"/>
</a>
</div>
<div align="center">
Also featured in [Awesome Android Newsletter
<a href="https://android.libhunt.com/newsletter/5">
#Issue 5
</a>,
<a href="https://android.libhunt.com/newsletter/21">
#Issue 21
</a>],
<a href="https://github.com/codepath/android_guides/wiki/Must-Have-libraries#convenience">
Codepath's Must Have Libraries
</a>,
<a href="https://medium.cobeisfresh.com/cobes-top-5-android-libraries-september-2016-883757e61bf0#.oe2lzaxyn">
COBE’s Top 5 Android Libraries — September 2016
</a>,
<a href="https://cloudrail.com/best-android-libraries-for-developers/">
Best Android Libraries for Developers
</a>,
<a href="https://dzone.com/articles/this-week-in-mobile-may-15">
DZone
</a>,
<a href="http://email.changelog.com/t/t-310383437622D164">
Changelog Weekly Issue #115
</a>
</div>
<div align="center">
Blog Post:
<a href="https://android.jlelse.eu/i-could-not-find-a-simple-gesture-detection-android-library-so-i-built-one-334c0a307c16#.1us4zgise">
I could not find a simple Gesture Detection android library, so I built one
</a>
</div>
<div align="center">
<sub>Built with ❤︎ by
<a href="https://twitter.com/nisrulz">Nishant Srivastava</a> and
<a href="https://github.com/nisrulz/sensey/graphs/contributors">
contributors
</a>
</div>
<br/>
<br/>
### Screenshot of sample app
![sc1](img/sc1.png) ![sc2](img/sc2.png)
# Supported gestures/events
| Gesture | Methods | Usage |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| Flip | onFaceUp<br/>onFaceDown | [Link](https://github.com/nisrulz/sensey/wiki/Usage#flip) |
| Light | onDark<br/>onLight | [Link](https://github.com/nisrulz/sensey/wiki/Usage#light) |
| Orientation | onTopSideUp<br/>onBottomSideUp<br/>onLeftSideUp<br/>onRightSideUp | [Link](https://github.com/nisrulz/sensey/wiki/Usage#orientation) |
| PinchScale | onScale<br/>onScaleStart<br/>onScaleEnd | [Link](https://github.com/nisrulz/sensey/wiki/Usage#pinchscale) |
| Proximity | onNear<br/>onFar | [Link](https://github.com/nisrulz/sensey/wiki/Usage#proximity) |
| Shake | onShakeDetected<br/>onShakeStopped | [Link](https://github.com/nisrulz/sensey/wiki/Usage#shake) |
| Wave | onWave | [Link](https://github.com/nisrulz/sensey/wiki/Usage#wave) |
| Chop | onChop