Replicates detecting and broadcasting iBeacons in the background
An iOS library that replicates iBeacon functionality using CoreBluetooth for full background broadcasting and detection.
What is Replicates detecting and broadcasting iBeacons in the background?
Vicinity is an iOS library that replicates iBeacon functionality by using the CoreBluetooth framework instead of CoreLocation. It solves the problem of limited background operation support in CoreLocation by enabling full background broadcasting and detection of low-energy Bluetooth devices through RSSI analysis.
iOS developers building applications that require reliable background Bluetooth proximity detection, such as location-based services, asset tracking, or indoor navigation systems.
Developers choose Vicinity because it overcomes CoreLocation's background limitations, provides greater control over Bluetooth operations, and offers a more flexible approach to iBeacon-like proximity detection with built-in signal smoothing.
Overview
Replicates detecting and broadcasting iBeacons in the background
Use Cases
Best For
- Building iOS apps that need background Bluetooth beacon broadcasting
- Implementing reliable proximity detection without CoreLocation restrictions
- Creating indoor navigation or location-based services on iOS
- Developing asset tracking applications with Bluetooth beacons
- Experimenting with custom Bluetooth signal analysis and RSSI interpretation
- Replacing iBeacon functionality with greater background operation control
Not Ideal For
- Projects requiring cross-platform Bluetooth beacon support (e.g., Android or web compatibility)
- Applications where CoreLocation's built-in iBeacon APIs suffice and offer better Apple ecosystem integration
- Scenarios needing precise, meter-level distance measurements instead of fuzzy proximity zones
- Teams seeking plug-and-play solutions with extensive documentation and community support
Pros & Cons
Pros
Uses CoreBluetooth to fully support broadcasting and detection in the background, overcoming CoreLocation's limitations as highlighted in the README.
Applies easing functions to filter sensor noise and signal spikes, ensuring more stable RSSI interpretation for proximity detection.
Converts RSSI values into fuzzy categories like Far, Near, and Immediate, replicating iBeacon behavior without CoreLocation restrictions.
Built on CBPeripheralManager and CBCentralManager, offering greater flexibility and lower-level access to Bluetooth operations.
Cons
Only available for iOS, as it relies on CoreBluetooth, making it unsuitable for cross-platform or non-iOS projects.
RSSI to distance conversion is based on trial and error and may not be consistent across all Bluetooth devices, leading to potential accuracy issues.
Focuses on basic iBeacon replication without advanced features like calibration tools or support for other beacon standards beyond the README's scope.
Frequently Asked Questions
Related Projects
BeaconEmitterTurn your Mac as an iBeacon
OWUProximityManageriBeacons + CoreBluetooth
Generic iBeacon Management and Utilities by KinveyLabsGeneric iBeacon Management and Utilities
JMCiBeaconManageriBeacon Manager
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.