BagTrack is a lightweight iOS app written entirely in Swift. It allows users to track bags, suitcases and other belongings using Bluetooth iBeacons.

This application can be installed on any device running iOS 11+ and uses native iOS location tracking services for iBeacon tracking. When tracked items move out of range, BagTrack sends out a push notification informing the user that they may be about to leave their belongings behind.

BagTrack is distributed under the terms and conditions outlined in the MIT License. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

iBeacons are small, portable devices that send out Bluetooth Low Energy (Bluetooth LE) signals at regular intervals. They are mostly used for providing indoor location services, but their small form factor makes them very suitable for bag and luggage tracking.

Although iBeacons come in various shapes and sizes, with various power options (batteries, AC power, solar, etc.), it is best to use a battery-powered device with a small footprint for tracking your belongings. You can use any iBeacon device with BagTrack, as long as it conforms to Apple's iBeacon specs. For more information, visit Apple's iBeacon site.

In order to use BagTrack, you need the following:

• An iBeacon device
• A physical device running iOS 11.0 or later (the app will not properly run in Xcode Simulator due to its use of Bluetooth)
• Xcode 9.0 or later (only if you want to compile it yourself or update the source code)

The latest shipping release of BagTrack is available on the iOS App Store for easy installation and use. View BagTrack on the App Store

1. Clone this repository. git clone https://github.com/robin24/bagtrack.git
2. Open BagTrack.xcodeproj in Xcode 9.0 or later
3. Compile and run BagTrack

1. Follow the instructions presented when opening the app
2. Add a new bag by tapping the "Add" button on the main screen
3. Provide a name, your iBeacon's UUID, major and minor values as well as its identifier, then tap "Save".
4. Keep your iBeacon in your bag or other luggage, BagTrack will indicate the approximate distance between you and your belongings while it is open, or send you a push notification when you get too far away while the app is in the background.
5. Enjoy!

In most cases, this will be indicated in the product name or description, or on the vendor's website. If you want to be 100% certain, contact the vendor before purchasing.

Please check your device's manual or the manufacturer's website. In many cases, the manufacturer will have provided some method in which you can adjust those values to your own preferences, such as a corresponding app.

Unfortunately, this is due to a limitation in Apple's frameworks. While the CoreBluetooth framework technically allows us to search for nearby Bluetooth devices, the device's UUID must be known before starting the auto-discovery process. Since iBeacon devices come with different, arbitrary UUIDs, it is therefore not possible to search for iBeacons automatically. For more information, take a look at this Stack Overflow question.

Have questions? Post to our Groups.io group