/android-beacon-scanner

A simple android iBeacon, AltBeacon, Eddystone and RuuviTag beacon scanner

Primary LanguageKotlin

🌀 Android Beacon Scanner

A simple android beacon scanner that can recognize iBeacons, AltBeacons, Eddystone beacons (UID and URL, with or without TLM) and RuuviTags available on Google Play.

Available for android 5.0+ and smartphones with Bluetooth LE.

🔑 Features

This app will scan for beacons near you! ✌️

For all Beacons:

  • The type of beacon (iBeacon, AltBeacon, Eddystone or RuuviTag)
  • The approximation of the distance with the beacon (this is based on the RSSI value received and is NOT accurate)
  • The beacon address and manufacturer code
  • The RSSI and TX values
  • The last time the beacon has been seen

For iBeacons and AltBeacons:

  • UUID
  • Major
  • Minor

For Eddystone-UID beacons:

  • NamespaceID
  • InstanceID
  • TLM data sent if any

For Eddystone-URL and RuuviTag

  • Clickable URL
  • TLM data sent if any

For RuuviTag:

  • Air Pressure
  • Temperature
  • Humidity

It can display several frames emitted by a single beacon, allowing you to see if a beacon emits multiple frames types (for example radius network beacons can emit iBeacon and AltBeacon at the same time)!

  • You can also log the scans of the beacons to an endpoint via a HTTP POST request.

🔧 Installation setup

  1. This project uses Firebase Analytics and Firebase Crash reporting, therefore it needs a google-services.json files in the app directory. To get it you need to create a Firebase project in the Firebase console and go to the project settings and download the google-services.json file from there.
  2. You'll see there is a signingConfigs.release in the app/build.gradle that contains variable that you didn't declare beacon_scanner_key_password, beacon_scanner_store_file, beacon_scanner_store_password. Either you create those 3 keys in your ~/.gradle/gradle.properties files or you can simply remove this configuration if you're not interested in having a release signing configuration. Make sure to remove it in the release and preRelease buildTypes as well.
  3. That's it, the app should now compile!

📘 Main libraries used

  • AltBeacon
    • Scanning for beacons nearby
    • Making the difference between iBeacons, AltBeacons and Eddystone beacons
    • Easily getting data emitted by the beacons (UUID, major, minor, namespaceID...)
  • Room
    • Local database wrapper
  • Retrofit
    • Network calls for POSTing to an endpoint
  • RxJava (& RxAndroid)
    • Easy threading and network calls abstraction
  • Dagger 2
    • Dependency injections into activities
  • FlexBox Layout
    • Easily display a list of size-varying fields
  • TapTargetView
    • Material design discovery feature made easy
  • Timber
    • A logger with a small, extensible API which provides utility on top of Android's normal Log class
  • Material dialog
    • Dialog API in Kotlin

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

This software is available under the Apache License 2.0