Trigger: Widget Button
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.
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
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
Triggers Widget Button Pressed (Custom)
Actions Silent Mode: Toggle Vibrate: 100ms
Toggle silent mode with a custom home screen widget.
Triggers Widget Button Pressed (Green)
Actions Wifi: On Bluetooth: On Notification: Connected Mode Enabled
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