MacroDroid Wiki

Changes

Trigger: Quick Settings tile (view source)

Revision as of 21:31, 6 January 2026

1,287 bytes added ,  Tuesday at 21:31
no edit summary
Line 1: Line 1: −
===<p><b>About</b></p>===
+
<pre class="header-style">The Quick Settings Tile trigger fires when a MacroDroid quick settings tile is pressed in the notification panel. Quick settings tiles appear when you swipe down from the top of the screen, providing easy access to commonly used functions. MacroDroid allows you to configure up to 16 custom quick settings tiles.</pre>
   −
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
''' Requirements '''
−
The quick settings tile trigger allows you to invoke a macro by long pressing or short pressing a quick tile found in your quick settings shade.
     −
To access, bring down the notification shade with two fingers to show your quick tiles. Now you should see a pencil icon, click the pencil. Now you can drag and drop the custom quick tiles into place.
+
* This trigger requires Android 7.0 (Nougat) or higher
−
</pre>
     −
==<p><b>How to add a quick tile</b></p>==
+
''' Options '''
   −
On the home screen in the "Quick Settings Tiles" tile<br>
+
''' Tile Selection '''
−
You can configure up to 16 tiles<br>
  −
'''''Each mosaic can be configured as follows.'''''
  −
* '' Icon: ''
  −
* '' Title: Tells you what the tile does.''
  −
* '' Subtitle:'' ''Provides additional context (if needed). ''
  −
Two modes:
  −
* '' Toggle: Switch functions on/off with a tap.''
  −
* '' Button: Access a specific action with a quick tap.''
  −
<br>
  −
Notification Bar
     −
* '' Collapse Notification Bar (Default): Selecting this option will collapse the notification bar and return it to its normal state.''
+
Select which MacroDroid tile (1-16) will trigger this macro. The tile label displayed is taken from the quick settings configuration if set, otherwise shows "MacroDroid Tile #".
   −
''See also: [https://macrodroidforum.com/wiki/index.php/Action:_Configure_Quick_Tile Action: Configure Quick Tile]. | [https://macrodroidforum.com/wiki/index.php?title=Constraint:_Quick_tile_state Constraint: Configure Quick Tile].''
+
''' Trigger Event '''
   −
==<p><b>Supported configurations</b></p>==
+
* '''Toggle On''' - Fires when the tile is pressed to turn ON (for toggle-style tiles)
 +
* '''Toggle Off''' - Fires when the tile is pressed to turn OFF (for toggle-style tiles)
 +
* '''Long Press''' - Fires when the tile is long-pressed
   −
* '' Toggle On/Button Press ''
+
''' Examples '''
−
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
−
Activated when the button goes into an activated state.
+
''Example 1: Toggle flashlight with quick settings tile''
−
</pre>
+
 
−
* '' Toggle Off ''
+
  <pre class="trigger-style">Triggers
−
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
 
−
Activated when the button goes to a deactivated state.
+
Quick Settings Tile: Toggle On (Tile 1 - Flashlight)</pre>
−
</pre>
+
  <pre class="action-style">Actions
−
* '' Long Press ''
+
 
−
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+
Enable Flashlight</pre>
−
It is activated when you make a long click.
+
 
−
</pre>
+
  <pre class="trigger-style">Triggers
 +
 
 +
Quick Settings Tile: Toggle Off (Tile 1 - Flashlight)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Disable Flashlight</pre>
 +
 
 +
''Example 2: Launch app with quick settings tile''
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Quick Settings Tile: Toggle On (Tile 2 - Camera)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Launch Application: Camera</pre>
 +
 
 +
''Example 3: Open tile settings with long press''
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Quick Settings Tile: Long Press (Tile 3)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Launch Activity: MacroDroid Settings</pre>
 +
 
 +
''' Configuration '''
 +
 
 +
Quick settings tiles are configured separately from the trigger:
 +
1. Open MacroDroid Settings
 +
2. Navigate to Quick Settings Tiles
 +
3. Configure each tile with:
 +
  * Label - The text displayed on the tile
 +
  * Icon - The icon shown on the tile
 +
  * Toggle mode - Whether the tile acts as an on/off toggle or a single action button
 +
  * Collapse on press - Whether to close the notification panel when pressed
 +
  * Subtitle - Optional secondary text (Android 10+)
 +
 
 +
''' Adding Tiles to Quick Settings '''
 +
 
 +
After configuring tiles in MacroDroid:
 +
1. Swipe down from the top of the screen to open quick settings
 +
2. Tap the edit/pencil icon
 +
3. Find MacroDroid tiles in the available tiles section
 +
4. Drag them to your quick settings panel
 +
 
 +
''' Notes '''
 +
 
 +
* You can have multiple macros triggered by the same tile (e.g., separate macros for Toggle On and Toggle Off)
 +
* When exporting/importing macros, the tile configuration is preserved and will be applied on import if the tile slot is available
 +
* Tiles that are not enabled in MacroDroid settings will appear dimmed in the tile selection list
 +
* The tile icon and label can be updated dynamically using the "Configure Quick Settings Tile" action
 +
* Long press functionality allows for additional actions without using another tile slot
 +
 
 +
''' See Also '''
 +
 
 +
* [[Action: Configure Quick Tile]]
 +
* [[Trigger: Notification Bar Button]]
 +
* [[Trigger: Widget Button]]
Retrieved from ‘https://macrodroidforum.com/wiki/index.php/Special:MobileDiff/3022’