🌀 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.
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:
For Eddystone-UID beacons:
- TLM data sent if any
For Eddystone-URL and RuuviTag
- Clickable URL
- TLM data sent if any
- Air Pressure
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
- This project uses Firebase Analytics and Firebase Crash reporting, therefore it needs a
google-services.jsonfiles in the
appdirectory. 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.jsonfile from there.
- You'll see there is a
app/build.gradlethat contains variable that you didn't declare
beacon_scanner_store_password. Either you create those 3 keys in your
~/.gradle/gradle.propertiesfiles 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
preReleasebuildTypes as well.
- That's it, the app should now compile!
📘 Main libraries used
- Scanning for beacons nearby
- Making the difference between iBeacons, AltBeacons and Eddystone beacons
- Easily getting data emitted by the beacons (UUID, major, minor, namespaceID...)
- Local database wrapper
- 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
- Material design discovery feature made easy
- A logger with a small, extensible API which provides utility on top of Android's normal Log class
- Material dialog
- Dialog API in Kotlin
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