Difference between revisions of "Trigger: Bluetooth Beacon (experimental)"

Revision as of 21:45, 5 January 2026

The Bluetooth Beacon trigger fires when your device comes within range of or moves out of range of a specified Bluetooth beacon. Bluetooth beacons are small wireless transmitters that broadcast signals, commonly used for indoor positioning and location-based automation.

Options

In Range - Trigger fires when the device comes within range of the specified beacon
Out of Range - Trigger fires when the device moves out of range of the specified beacon

Configuration

When configuring this trigger, MacroDroid will scan for nearby Bluetooth beacons. You can:

Select a beacon from the list of detected beacons
Choose a previously configured beacon from the cached list
Manually add a beacon by entering its UUID
Assign a friendly name to beacons for easier identification

The beacon selection dialog shows:

Currently detected beacons at the top
Previously used beacons below
Option to manually add a beacon by entering its UUID

Examples

Example 1: Welcome Home Automation

Triggers

Bluetooth Beacon - In Range (Home Beacon)

Actions

Set Volume: Ring to 100%
Disable Silent Mode

Constraints

Time of Day: 5:00 PM - 11:00 PM

Example 2: Leave Work Reminder

Triggers

Bluetooth Beacon - Out of Range (Office Beacon)

Actions

Notification: Don't forget to clock out!

Constraints

Day of Week: Mon-Fri

Notes

The trigger uses the AltBeacon library for beacon detection
Beacons are identified by their UUID (Universally Unique Identifier)
Previously used beacons are cached for easy access even when not currently in range
The beacon scan may take a few seconds to complete
Location services must be enabled for beacon detection to work
The trigger monitors specific beacon UUIDs using region-based monitoring for efficiency

Permissions Required

Location Permission - Required for Bluetooth beacon scanning (ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION)
Bluetooth Scan Permission - Required on Android 12+ (BLUETOOTH_SCAN)
Bluetooth Connect Permission - Required on Android 12+ (BLUETOOTH_CONNECT)
Location services must be enabled on the device

See Also

@@ Line 1: / Line 1: @@
-<pre class="header-style">
+<pre class="header-style">The Bluetooth Beacon trigger fires when your device comes within range of or moves out of range of a specified Bluetooth beacon. Bluetooth beacons are small wireless transmitters that broadcast signals, commonly used for indoor positioning and location-based automation.</pre>
-This trigger can be configured to fire when you come in range of, or go out of range of a Bluetooth beacon.
-When selecting this trigger, a scan will be performed for any Bluetooth beacons that are in range and you will be able to select from any beacons found. You can also enter a beacon is manually if you know the details.
+''' Options '''
-This trigger is experimental, so may not work reliably in all cases and with all beacon types.
+* '''In Range''' - Trigger fires when the device comes within range of the specified beacon
-</pre>
+* '''Out of Range''' - Trigger fires when the device moves out of range of the specified beacon
+''' Configuration '''
+When configuring this trigger, MacroDroid will scan for nearby Bluetooth beacons. You can:
+* Select a beacon from the list of detected beacons
+* Choose a previously configured beacon from the cached list
+* Manually add a beacon by entering its UUID
+* Assign a friendly name to beacons for easier identification
+The beacon selection dialog shows:
+* Currently detected beacons at the top
+* Previously used beacons below
+* Option to manually add a beacon by entering its UUID
+''' Examples '''
+''Example 1: Welcome Home Automation''
+  <pre class="trigger-style">Triggers
+Bluetooth Beacon - In Range (Home Beacon)</pre>
+  <pre class="action-style">Actions
+Set Volume: Ring to 100%
+Disable Silent Mode</pre>
+  <pre class="constraint-style">Constraints
+Time of Day: 5:00 PM - 11:00 PM</pre>
+''Example 2: Leave Work Reminder''
+  <pre class="trigger-style">Triggers
+Bluetooth Beacon - Out of Range (Office Beacon)</pre>
+  <pre class="action-style">Actions
+Notification: Don't forget to clock out!</pre>
+  <pre class="constraint-style">Constraints
+Day of Week: Mon-Fri</pre>
+''' Notes '''
+* The trigger uses the AltBeacon library for beacon detection
+* Beacons are identified by their UUID (Universally Unique Identifier)
+* Previously used beacons are cached for easy access even when not currently in range
+* The beacon scan may take a few seconds to complete
+* Location services must be enabled for beacon detection to work
+* The trigger monitors specific beacon UUIDs using region-based monitoring for efficiency
+''' Permissions Required '''
+* '''Location Permission''' - Required for Bluetooth beacon scanning (ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION)
+* '''Bluetooth Scan Permission''' - Required on Android 12+ (BLUETOOTH_SCAN)
+* '''Bluetooth Connect Permission''' - Required on Android 12+ (BLUETOOTH_CONNECT)
+* Location services must be enabled on the device
+''' See Also '''
+* [[Trigger:_Bluetooth_Event|Bluetooth Event Trigger]]
+* [[Trigger:_Geofence|Geofence Trigger]]