From 55734296a386bd45057caed35d503a3329596008 Mon Sep 17 00:00:00 2001 From: Brady Joslin Date: Sat, 8 Aug 2020 17:43:08 -0500 Subject: [PATCH] Document SecureInput notification on macOS --- docs/configuration.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/configuration.md b/docs/configuration.md index 302d61f..0dcd821 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -164,6 +164,14 @@ Detected change, current window has properties: These are the parameters espanso detected for your target application, so you can now use them to create the perfect filter. +### macOS Notification for SecureInput + +On macOS there is a security feature known as `SecureInput`, which blocks text expanders from detecting input when entering text in sensitive areas, such as password fields (but also other apps, even the Terminal if configured). + +As a result, espanso will not work in those situations, and espanso will trigger a notification (as well as logging it) to warn the user if an app triggers SecureInput. If you want to disable the notification, just add the following line in your config file: + +`secure_input_notification: false` + ### Options Here's a list of all options available for the configuration file: @@ -182,4 +190,4 @@ Option | Description | Possible Values | Default | App-Specific `passive_key` | Change the key used to trigger passive mode | `CTRL`, `ALT`, `SHIFT`, `META`, `LEFT_CTRL`, `LEFT_ALT`, `LEFT_SHIFT`, `LEFT_META`, `RIGHT_CTRL`, `RIGHT_ALT`, `RIGHT_SHIFT`, `RIGHT_META`, `OFF`| `OFF` | No `secure_input_notification` | Enable/Disable the Secure Input notification on macOS | `true`/`false` | `true` | No `show_icon` | Show/Hide the icon in the status bar on macOS and Windows | `true`/`false` | `true` | No -`show_notifications` | Show/Hide the notifications| `true`/`false` | `true` | No \ No newline at end of file +`show_notifications` | Show/Hide the notifications| `true`/`false` | `true` | No