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 |