936
edits
Changes
no edit summary
<span style="color: #B22A2A; font-size: 24px; display: inline-block; margin-top: 15px; margin-bottom: 0px;"><strong>About this trigger</strong></span>
<pre class="header-style">This trigger will fire when the corresponding MacroDroid widget button is pressed. There are four default colored buttons provided, and you can configure a custom button by selecting an icon and label. MacroDroid widgets can be added to your home screen via the normal Android mechanism.</pre>
''' Options '''
''' Widget Types '''
* '''Custom''': Create a fully customized widget with your own icon and label
* '''Green''': Pre-configured green colored button
* '''Blue''': Pre-configured blue colored button
* '''Red''': Pre-configured red colored button
* '''Yellow''': Pre-configured yellow colored button
Only one widget button trigger may be added per macro.
''' Custom Widget Options '''
When selecting Custom widget type:
* '''Widget Label''': Text displayed on or below the widget (supports Magic Text)
* '''Icon''': Select an icon from the built-in icon library or use a custom image
* '''Icon Text''': Optional text overlay on the icon (supports Magic Text)
* '''Icon Tint''': Enable tinting and select a custom tint color for the icon
''' Adding Widgets '''
To add a MacroDroid widget to your home screen:
1. Long-press on an empty area of your home screen
2. Select "Widgets" from the menu
3. Find MacroDroid in the widget list
4. Drag the desired widget button to your home screen
5. Select the macro to associate with the widget
''' Examples '''
<pre class="trigger-style">Triggers
Widget Button Pressed (Custom)</pre>
<pre class="action-style">Actions
Silent Mode: Toggle
Vibrate: 100ms</pre>
''Toggle silent mode with a custom home screen widget.''
----
<pre class="trigger-style">Triggers
Widget Button Pressed (Green)</pre>
<pre class="action-style">Actions
Wifi: On
Bluetooth: On
Notification: Connected Mode Enabled</pre>
''Quick access to enable connectivity options using the green widget button.''
''' Notes '''
* Only one Widget Button trigger may be added per macro.
* Custom widgets support user images from your device's storage in addition to built-in icons.
* Widget labels can use Magic Text to display dynamic information.
* The widget appearance can be updated dynamically using the Configure Widget Button action.
* Widgets remain on the home screen independently of the macro's enabled/disabled state.
* If the associated macro is disabled, pressing the widget will have no effect.
* Custom widget icons support tinting to match your home screen theme.
''' See Also '''
* [[Action:_Widget_Button_Modify|Widget Button Modify Action]]