Document optional custom alerts

README.md

@@ -1,8 +1,8 @@
 # Notifications Master
 
-Notifications Master currently keeps a private history of the notifications that appear on
+Notifications Master keeps a private history of your Android notifications and
-your Android device. It works as a standard Android notification listener; it
+can play custom alerts for the ones that matter. It works normally without root
-does not need root or an Xposed module.
+or an Xposed module.
 
 ## AI Assistance
 
@@ -30,14 +30,37 @@ unencrypted file at the location you choose. Android may withhold sensitive or
 custom notification content; this app records only what Android makes available
 to a notification listener.
 
-When all logging types are disabled, the notification listener is disabled too:
+The optional lock protects log screens with your device biometric or credential
-the app has no polling, scheduled job, or background service to run.
+prompt; the alert setup remains usable. When all logging types, custom alert
+rules, and direct-alert controls are disabled, the notification listener is
+disabled too: the app has no polling or scheduled job to run.
+
+## Custom alerts
+
+Create named sound and vibration profiles, then assign them to per-app rules.
+Rules can match notification text, respond to new notifications or meaningful
+edits, and either play a profile, silence the original alert, or leave it
+unchanged. Rules can be ordered, combined, and queued; a protected alert can
+play to completion.
+
+Without optional system integration, a matching profile plays alongside the
+source app's normal alert. With a compatible LSPosed setup enabled, Notifications
+Master can suppress a matched standard notification alert while leaving the
+notification itself visible. Experimental per-app control is also available for
+direct vibrations that are explicitly marked by Android as notification usage.
+It deliberately does not touch media, alarms, ringtones, touch feedback, or
+unknown vibration usage.
+
+Custom alerts respect Do Not Disturb. Android does not allow a normal app to
+force direct custom sound or vibration through Do Not Disturb.
 
 ## Requirements
 
 Notifications Master supports Android 14 through Android 16 (API levels 34–36).
 After installation, grant **Notification access** when prompted. The optional
-app lock uses your device's biometric or credential prompt.
+log lock uses your device's biometric or credential prompt. LSPosed integration
+is optional and requires a compatible rooted device plus a system-server scope;
+the notification log and ordinary custom alerts remain available without it.
 
 Tested Android versions: