BetterTouchTool conditions
The values BetterTouchTool conditions read, and what they become.
BetterTouchTool keeps a trigger's conditions as a predicate. Each value it can read is below.
| Condition | Value | Becomes | Notes |
|---|---|---|---|
active_app_name | string | A script condition | read by a script condition or compared as an app name: check it |
active_app_bundle_identifier | string | An Only if condition | |
active_app_executable_path | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
active_website_url | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
hovered_app_name | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
hovered_app_bundle_identifier | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
hovered_dock_app | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_window_title | string | An Only if condition | |
focused_window_app_name | string | A script condition | read by a script condition or compared as an app name: check it |
focused_window_x | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_window_y | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_window_width | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_window_height | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_element_role | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_element_subrole | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
running_processes | string | An Only if condition | |
fullscreen_active | bool | An Only if condition | |
missioncontrol_active | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
app_expose_active | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
active_window_is_pinned | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
window_titlebar_hovered | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
active_space | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
translated_active_space | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
connected_wifi_name | string | An Only if condition | |
power_source | string | An Only if condition | |
battery_level | number | An Only if condition | |
focus_mode | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
darkmode_active | bool | A script condition | read by a script condition or compared as an app name: check it |
lid_angle | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
BTTIdleTime | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
current_hour | number | An Only if condition | |
current_minute | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
current_day | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
current_weekday | number | An Only if condition | |
seconds_since_last_trigger | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
audio_output_device | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
audio_input_device | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
CurrentDisplayBrightness | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
BuiltInDisplayBrightness | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
keyboard_input_source | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
current_keyboard_input_source | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
connected_screen_count | number | An Only if condition | |
connected_screens | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
active_screen_resolutions | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
mouse_screen_width | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
mouse_screen_height | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
mouse_screen_x | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
mouse_screen_y | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_screen_x | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_screen_y | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_screen_width | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
focused_screen_height | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
mouse_position_x | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
mouse_position_y | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
mouse_pos_percent_x | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
mouse_pos_percent_y | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
position_in_window_x | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
position_in_window_y | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
color_under_cursor | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
left_mouse_down | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
middle_mouse_down | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
right_mouse_down | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
currently_pressed_mouse_buttons | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
currently_connected_mice | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
currently_pressed_keyboard_keys | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
currently_active_modifier_keys | string | An Only if condition | |
currently_blocking_keyboard | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
secure_input_pid | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
ignore_builtin_trackpad_active | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
fingers_touching_trackpad | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
last_trackpad_force | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
trackpad_touch_duration | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
trackpad_touch_swipe_distance | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
trackpad_mouse_distance_since_initial_touch | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
trackpad_id | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
thumb_recognized | bool | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
thumb_x_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
thumb_y_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
leftmost_touch_x_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
leftmost_touch_y_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
rightmost_touch_x_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
rightmost_touch_y_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
leftmost_rightmost_touch_distance_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
fingers_touching_magic_mouse | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
magic_mouse_touch_duration | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
leftmost_mouse_touch_x_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
leftmost_mouse_touch_y_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
rightmost_mouse_touch_x_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
rightmost_mouse_touch_y_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
leftmost_rightmost_mouse_touch_distance_percent | number | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
hovered_floating_menu_identifier | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
visible_floating_menu_identifiers | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
customVariable1 | string | An Only if condition | |
customVariable2 | string | An Only if condition | |
customVariable3 | string | An Only if condition | |
customVariable4 | string | An Only if condition | |
customVariable5 | string | An Only if condition | |
processMatchMode | enum | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
BTTScreenConditionIncludeUUID | string | A condition that never passes | no Switchboard equivalent: imports as a condition that never passes, with a note |
user_variable | any | An Only if condition | |
BTTTriggerConditionsData | predicate | An Only if condition |