| commit | author | age | ||
| a67156 | 1 | # Configuration file for libinput-gestures. |
| J | 2 | # |
| 3 | # The default configuration file exists at /etc/libinput-gestures.conf | |
| 4 | # but a user can create a personal custom configuration file at | |
| 5 | # ~/.config/libinput-gestures.conf. | |
| 6 | # | |
| 7 | # Lines starting with '#' and blank lines are ignored. Currently | |
| 8 | # "gesture" and "device" configuration keywords are supported as | |
| 9 | # described below. The keyword can optionally be appended with a ":" (to | |
| 10 | # maintain compatibility with original format configuration files). | |
| 11 | # | |
| 12 | # Each gesture line has 3 [or 4] arguments separated by whitespace: | |
| 13 | # | |
| 14 | # action motion [finger_count] command | |
| 15 | # | |
| 16 | # where action and motion is either: | |
| 17 | # swipe up | |
| 18 | # swipe down | |
| 19 | # swipe left | |
| 20 | # swipe right | |
| 21 | # pinch in | |
| 22 | # pinch out | |
| 23 | # | |
| 24 | # command is the remainder of the line and is any valid shell command + | |
| 25 | # arguments. | |
| 26 | # | |
| 27 | # finger_count is a single numeric digit and is optional (and is | |
| 28 | # typically 3 or 4). If specified then the command is executed when | |
| 29 | # exactly that number of fingers is used in the gesture. If not | |
| 30 | # specified then the command is executed when that gesture is executed | |
| 31 | # with any number of fingers. Gesture lines specified with finger_count | |
| 32 | # have priority over the same gesture specified without any | |
| 33 | # finger_count. | |
| 34 | # | |
| 35 | # Typically command will be xdotool, or wmctrl. See "man xdotool" for | |
| 36 | # the many things you can action with that tool. Note that unfortunately | |
| 37 | # xdotool does not work with native Wayland clients. | |
| 38 | ||
| 39 | ############################################################################### | |
| 40 | # SWIPE GESTURES: | |
| 41 | ############################################################################### | |
| 42 | ||
| 43 | # Note the default is an "internal" command that uses wmctrl to switch | |
| 44 | # workspaces and, unlike xdotool, works on both Xorg and Wayland (via | |
| 45 | # XWayland). It also can be configured for vertical and horizontal | |
| 46 | # switching over tabular workspaces, as per the example below. You can | |
| 47 | # also add "-w" to the internal command to allow wrapping workspaces. | |
| 48 | ||
| 49 | # Move to next workspace (works for GNOME/KDE/etc on Wayland and Xorg) | |
| 50 | gesture swipe up 4 _internal ws_up | |
| 51 | gesture swipe up 3 xdotool key super+s | |
| 52 | ||
| 53 | ||
| 54 | # NOTE ABOUT FINGER COUNT: | |
| 55 | # The above command will configure this command for all fingers (i.e. 3 | |
| 56 | # for 4) but to configure it for 3 fingers only, change it to: | |
| 57 | # gesture swipe up 3 _internal ws_up | |
| 58 | # Then you can configure something else for 4 fingers or leave 4 fingers | |
| 59 | # unconfigured. You can configure an explicit finger count like this for | |
| 60 | # all example commands in this configuration file. | |
| 61 | # | |
| 62 | # gesture swipe up xdotool key super+Page_Down | |
| 63 | ||
| 64 | # Move to prev workspace (works for GNOME/KDE/etc on Wayland and Xorg) | |
| 65 | gesture swipe down 4 _internal ws_down | |
| 66 | gesture swipe down 3 xdotool key super+s | |
| 67 | # gesture swipe down xdotool key super+Page_Up | |
| 68 | ||
| 69 | # Browser go forward (works only for Xorg, and Xwayland clients) | |
| 70 | gesture swipe left xdotool key alt+Right | |
| 71 | ||
| 72 | # Browser go back (works only for Xorg, and Xwayland clients) | |
| 73 | gesture swipe right xdotool key alt+Left | |
| 74 | ||
| 75 | # NOTE: If you don't use "natural" scrolling direction for your touchpad | |
| 76 | # then you may want to swap the above default left/right and up/down | |
| 77 | # configurations. | |
| 78 | ||
| 79 | # Optional extended swipe gestures, e.g. for browser tab navigation: | |
| 80 | # | |
| 81 | # Jump to next open browser tab | |
| 82 | # gesture swipe right_up xdotool key control+Tab | |
| 83 | # | |
| 84 | # Jump to previous open browser tab | |
| 85 | # gesture swipe left_up xdotool key control+shift+Tab | |
| 86 | # | |
| 87 | # Close current browser tab | |
| 88 | # gesture swipe left_down xdotool key control+w | |
| 89 | # | |
| 90 | # Reopen and jump to last closed browser tab | |
| 91 | # gesture swipe right_down xdotool key control+shift+t | |
| 92 | ||
| 93 | # Example of 8 static workspaces, e.g. using KDE virtual-desktops, | |
| 94 | # arranged in 2 rows of 4 across using swipe up/down/left/right to | |
| 95 | # navigate in fixed planes. Must match how you have configured your | |
| 96 | # virtual desktops. | |
| 97 | # gesture swipe up _internal --col=2 ws_up | |
| 98 | # gesture swipe down _internal --col=2 ws_down | |
| 99 | # gesture swipe left _internal --row=4 ws_up | |
| 100 | # gesture swipe right _internal --row=4 ws_down | |
| 101 | ||
| 102 | # Example virtual desktop switching for Ubuntu Unity/Compiz. The | |
| 103 | # _internal command does not work for Compiz but you can explicitly | |
| 104 | # configure the swipe commands to work for a Compiz virtual 2 | |
| 105 | # dimensional desktop as follows: | |
| 106 | # gesture swipe up xdotool key ctrl+alt+Up | |
| 107 | # gesture swipe down xdotool key ctrl+alt+Down | |
| 108 | # gesture swipe left xdotool key ctrl+alt+Left | |
| 109 | # gesture swipe right xdotool key ctrl+alt+Right | |
| 110 | ||
| 111 | # Example to change audio volume: | |
| 112 | # Note this only works on an Xorg desktop (not Wayland). | |
| 113 | # gesture swipe up xdotool key XF86AudioRaiseVolume | |
| 114 | # gesture swipe down xdotool key XF86AudioLowerVolume | |
| 115 | ||
| 116 | ############################################################################### | |
| 117 | # PINCH GESTURES: | |
| 118 | ############################################################################### | |
| 119 | ||
| 120 | # GNOME SHELL open/close overview (works for GNOME on Xorg only) | |
| 121 | #gesture pinch in xdotool key super+s | |
| 122 | #gesture pinch out xdotool key super+s | |
| 123 | ||
| 124 | # KDE Plasma open/close overview | |
| 125 | # gesture pinch in xdotool key ctrl+F9 | |
| 126 | # gesture pinch out xdotool key ctrl+F9 | |
| 127 | ||
| 128 | # GNOME SHELL open/close overview (works for GNOME on Wayland and Xorg) | |
| 129 | # Note since GNOME 3.24 on Wayland this is implemented natively so no | |
| 130 | # real point configuring for Wayland. | |
| 131 | # gesture pinch in dbus-send --session --type=method_call --dest=org.gnome.Shell /org/gnome/Shell org.gnome.Shell.Eval string:'Main.overview.toggle();' | |
| 132 | # gesture pinch out dbus-send --session --type=method_call --dest=org.gnome.Shell /org/gnome/Shell org.gnome.Shell.Eval string:'Main.overview.toggle();' | |
| 133 | ||
| 134 | # Optional extended pinch gestures: | |
| 135 | # gesture pinch clockwise <whatever command> | |
| 136 | # gesture pinch anticlockwise <whatever command> | |
| 137 | ||
| 138 | ############################################################################### | |
| 139 | # This application normally determines your touchpad device | |
| 140 | # automatically. Some users may have multiple touchpads but by default | |
| 141 | # we use only the first one found. However, you can choose to specify | |
| 142 | # the explicit device name to use. Run "libinput list-devices" to work | |
| 143 | # out the name of your device (from the "Device:" field). Then add a | |
| 144 | # device line specifying that name, e.g: | |
| 145 | # | |
| 146 | # device DLL0665:01 06CB:76AD Touchpad | |
| 147 | # | |
| 148 | # If the device name starts with a '/' then it is instead considered as | |
| 149 | # the explicit device path although since device paths can change | |
| 150 | # through reboots this is best to be a symlink. E.g. instead of specifying | |
| 151 | # /dev/input/event12, use the corresponding full path link under | |
| 152 | # /dev/input/by-path/*. | |
| 153 | # | |
| 154 | # You can choose to use ALL touchpad devices by setting the device name | |
| 155 | # to "all". E.g. Do this if you have multiple touchpads which you want | |
| 156 | # to use in parallel. This reduces performance slightly so only set this | |
| 157 | # if you have to. | |
| 158 | # | |
| 159 | # device all | |
| 160 | ||
| 161 | ############################################################################### | |
| 162 | # You can set a minimum travel distance threshold before swipe gestures | |
| 163 | # are actioned using the swipe_threshold configuration command. | |
| 164 | # Specify this value in dots. The default is 0. | |
| 165 | # E.g. set it to 100 dots with "swipe_threshold 100". | |
| 166 | # swipe_threshold 0 | |
| 167 | ||
| 168 | ############################################################################### | |
| 169 | # You can set a timeout on gestures from start to end. The default is | |
| 170 | # the value commented below. It can be any value in float secs >= 0. | |
| 171 | # 0 = no timeout. E.g. set it to 2 secs with "timeout 2". | |
| 172 | # timeout 1.5 | |
