Trigger: Notification - Revision history

MacroDroidDev at 21:07, 6 January 2026

2026-01-06T21:07:57Z

MacroDroidDev at 21:07, 6 January 2026

2026-01-06T21:07:17Z

MacroDroidDev at 21:03, 6 January 2026

2026-01-06T21:03:30Z

JosueGd at 23:40, 23 January 2024

2024-01-23T23:40:51Z

JosueGd at 18:35, 23 January 2024

2024-01-23T18:35:23Z

Md sgf at 08:14, 25 May 2023

2023-05-25T08:14:48Z

JosueGd at 14:50, 29 April 2023

2023-04-29T14:50:20Z

MacroDroidDev at 10:27, 8 February 2022

2022-02-08T10:27:20Z

JosueGd: Created page with "This trigger will fire when a notification is received. You can add additional filters based on the application the notification has come from and the content of the notificat..."

2021-05-20T21:18:26Z

Created page with "This trigger will fire when a notification is received. You can add additional filters based on the application the notification has come from and the content of the notificat..."

New page

This trigger will fire when a notification is received. You can add additional filters based on the application the notification has come from and the content of the notification text.

By using this trigger in conjunction with the Speak Text action you can speak the incoming notification text.

@@ Line 80: / Line 80: @@
 * This trigger requires Notification Access permission to be granted to MacroDroid
 * On Android 15+, there may be restrictions on accessing notification content
 * The "Prevent multiple triggers" option is useful for apps that update notifications frequently (like download progress notifications)

@@ Line 70: / Line 70: @@
 When using this trigger, the following magic text values are available:
-* [notification_text] - The full notification text
+* {notification} - The full notification text
-* [notification_title] - The notification title
+* {not_title} - The notification title
-* [notification_app] - The name of the app that posted the notification
+* {not_app_name} - The name of the app that posted the notification
-* [notification_package] - The package name of the app
+* {not_app_package} - The package name of the app
-* [notification_big_text] - Extended notification text (if available)
+* {not_text_big} - Extended notification text (if available)
-* [notification_channel] - The notification channel ID (Android 8.0+)
+* {not_channel} - The notification channel ID (Android 8.0+)
 ''' Notes '''
@@ Line 89: / Line 89: @@
 * [[Action: Clear Notifications]]
-* [[Action: Post Notification]]
+* [[Action: Display Notification]]
-* [[Constraint: Notification on Screen]]
+* [[Constraint: Notification Present]]

@@ Line 1: / Line 1: @@
-===<p><b>About</b></p>===
+<pre class="header-style">The Notification trigger fires when a notification is received or cleared. You can add filters based on the application the notification came from and the content of the notification text. This is a powerful trigger that can be used to react to notifications from any app, enabling automation based on incoming alerts, messages, and other notification content.</pre>
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+''' Options '''
-The prevent multiple triggers option can be used in situations where multiple rapid notification updates occur (more than one in a fraction of a second). For example an app may receive a push notification (which is an incoming notification and will cause a trigger) and then immediately do something in the app to refresh that notification causing another trigger. By enabling this option on a single trigger will fire which in most situations is the desired behavior.
+''' Trigger Event '''
-==<p><b>Supported configurations</b></p>==
+* '''Notification Received''' - Fires when a new notification is posted
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+''' Application Selection '''
-=== Application(s) ===
+* '''Select Applications''' - Choose specific applications to monitor
-* ''''' Select Application(s) '''''
+When selecting specific applications, you can also choose to:
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+* '''Include''' - Only trigger for the selected apps
-Select one or more applications that will activate the trigger.
+* '''Exclude''' - Trigger for all apps EXCEPT the selected ones
-* ''''' Any Application '''''
+''' Text Filtering '''
-=== Filter ===
+You can filter notifications based on their text content:
-* ''''' Any Application '''''
+''Single Field Mode:''
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+''Separate Title and Message Mode:''
-It reacts to any content.
+Enable "Separate title and message" to filter on title and message independently with the same options above.
-* ''''' Matches '''''
+''' Advanced Options '''
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+* '''Enable regular expression matching''' - Use regex syntax for pattern matching
-The text of the notification must match a regular expression (you must enable the "Enable regular expression matching" checkbox).
+* '''Ignore case''' - Perform case-insensitive matching (disabled when regex is enabled)
-</pre>
+* '''Ignore ongoing/persistent notifications''' - Do not trigger for persistent notifications (like media players or ongoing calls)
-* ''''' Contains '''''
+''' Sound Options '''
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+Filter by notification sound:
-The notification text must contain the text defined in the trigger or the content of a variable (only if I use magic text).
+* '''Any value''' - Ignore sound status
-</pre>
+* '''Has sound''' - Only trigger for notifications that have a sound
-* ''''' Excludes '''''
+''' Examples '''
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+''Example 1: Speak incoming text messages''
-=== Checkbox ===
+  <pre class="trigger-style">Triggers
-* '''Enable regular expression matching'''
+Notification Received: Messages app</pre>
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+Speak Text: New message from {not_title}. {notification}</pre>
-Regular expression matching (or regex matching) is a technique for finding patterns within text using a specialized syntax known as regular expressions. It's a powerful tool for text processing and pattern recognition.
+  <pre class="constraint-style">Constraints
-* '''''Case insensitive'''''
+Headphones: Connected</pre>
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+''Example 2: Log error notifications''
-* '''''Ignore ongoing notifications'''''
+  <pre class="trigger-style">Triggers
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+Notification Received: Any Application (contains "error")</pre>
-Ignore all persistent notifications.
+  <pre class="action-style">Actions
-* '''''Prevent multiple triggers'''''
+Write to File: error_log.txt - {not_app_name}: {notification}</pre>
-<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
+''' Available Magic Text '''
-* '''''Notification Sound'''''
+When using this trigger, the following magic text values are available:
-'''''- Any value'''''
+''' Notes '''
-'''''- Has sound'''''
+* This trigger requires Notification Access permission to be granted to MacroDroid
-'''''- Has no sound '''''
+''' See Also '''

@@ Line 1: / Line 1: @@
 <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
-This trigger will fire when a notification is received. You can add additional filters based on the application the notification has come from and the content of the notification text.
+It will react to any installed application.
-By using this trigger in conjunction with the Speak Text action you can speak the incoming notification text.
+* ''''' Any Application '''''
-The prevent multiple triggers option can be used in situations where multiple rapid notification updates occur (more than one in a fraction of a second). For example an app may receive a push notification (which is an incoming notification and will cause a trigger) and then immediately do something in the app to refresh that notification causing another trigger. By enabling this option on a single trigger will fire which in most situations is the desired behavior.
+<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 </pre>

@@ Line 1: / Line 1: @@
-<pre style="background-color: #EEEEEE; color: Black; border-radius: 10px; padding: 10px;">
+<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;">
 This trigger will fire when a notification is received. You can add additional filters based on the application the notification has come from and the content of the notification text.
@@ Line 6: / Line 6: @@
 The prevent multiple triggers option can be used in situations where multiple rapid notification updates occur (more than one in a fraction of a second). For example an app may receive a push notification (which is an incoming notification and will cause a trigger) and then immediately do something in the app to refresh that notification causing another trigger. By enabling this option on a single trigger will fire which in most situations is the desired behavior.
 </pre>

@@ Line 6: / Line 6: @@
 The prevent multiple triggers option can be used in situations where multiple rapid notification updates occur (more than one in a fraction of a second). For example an app may receive a push notification (which is an incoming notification and will cause a trigger) and then immediately do something in the app to refresh that notification causing another trigger. By enabling this option on a single trigger will fire which in most situations is the desired behavior.
 </pre>
+<br>
 '''Example Usage'''<br/>
@@ Line 20: / Line 20: @@
 </pre><br>
 <pre style="background-color: green; color: white; border-radius: 10px; padding: 10px;">
-Constrains
+Constraints

← Older revision		Revision as of 10:27, 8 February 2022
Line 2:		Line 2:

	By using this trigger in conjunction with the Speak Text action you can speak the incoming notification text.		By using this trigger in conjunction with the Speak Text action you can speak the incoming notification text.
		+
		+	The prevent multiple triggers option can be used in situations where multiple rapid notification updates occur (more than one in a fraction of a second). For example an app may receive a push notification (which is an incoming notification and will cause a trigger) and then immediately do something in the app to refresh that notification causing another trigger. By enabling this option on a single trigger will fire which in most situations is the desired behavior.