diff options
Diffstat (limited to 'sway/sway-input.5.txt')
-rw-r--r-- | sway/sway-input.5.txt | 74 |
1 files changed, 70 insertions, 4 deletions
diff --git a/sway/sway-input.5.txt b/sway/sway-input.5.txt index f0c8f87c..05725360 100644 --- a/sway/sway-input.5.txt +++ b/sway/sway-input.5.txt | |||
@@ -1,5 +1,5 @@ | |||
1 | ///// | 1 | ///// |
2 | vim:set ts=4 sw=4 tw=82 noet: | 2 | vim:set ft=asciidoc ts=4 sw=4 tw=82 noet: |
3 | ///// | 3 | ///// |
4 | sway-input (5) | 4 | sway-input (5) |
5 | ============== | 5 | ============== |
@@ -11,12 +11,57 @@ sway-input - input configuration file and commands | |||
11 | Description | 11 | Description |
12 | ----------- | 12 | ----------- |
13 | 13 | ||
14 | Sway allows for configuration of libinput devices within the sway configuration file. | 14 | Sway allows for configuration of devices within the sway configuration file. |
15 | sway-input commands must be used inside an _input { }_ block in the config. | 15 | sway-input commands must be used inside an _input { }_ block in the config. |
16 | To obtain a list of available device identifiers, run **swaymsg -t get_inputs**. | 16 | To obtain a list of available device identifiers, run **swaymsg -t get_inputs**. |
17 | 17 | ||
18 | Commands | 18 | Input Commands |
19 | -------- | 19 | -------------- |
20 | |||
21 | Keyboard Configuration | ||
22 | ~~~~~~~~~~~~~~~~~~~~~~ | ||
23 | |||
24 | For more information on these xkb configuration options, see | ||
25 | **xkeyboard-config**(7). | ||
26 | |||
27 | **input** <identifier> xkb_layout <layout_name>:: | ||
28 | Sets the layout of the keyboard like _us_ or _de_. | ||
29 | |||
30 | **input** <identifier> xkb_model <model_name>:: | ||
31 | Sets the model of the keyboard. This has an influence for some extra keys your | ||
32 | keyboard might have. | ||
33 | |||
34 | **input** <identifier> xkb_options <options>:: | ||
35 | Sets extra xkb configuration options for the keyboard. | ||
36 | |||
37 | **input** <identifier> xkb_rules <rules>:: | ||
38 | Sets files of rules to be used for keyboard mapping composition. | ||
39 | |||
40 | **input** <identifier> xkb_variant <variant>:: | ||
41 | Sets the variant of the keyboard like _dvorak_ or _colemak_. | ||
42 | |||
43 | Mapping Configuration | ||
44 | --------------------- | ||
45 | |||
46 | **input** <identifier> map_to_output <identifier>:: | ||
47 | Maps inputs from this device to the specified output. Only meaningful if the | ||
48 | device is a pointer, touch, or drawing tablet device. | ||
49 | |||
50 | **input** <identifier> map_to_region <WxH\@X,Y>:: | ||
51 | Maps inputs from this device to the specified region of the global output | ||
52 | layout. Only meaningful if the device is a pointer, touch, or drawing tablet | ||
53 | device. | ||
54 | |||
55 | **input** <identifier> map_region <WxH\@X,Y>:: | ||
56 | Ignores inputs from this device that do not occur within the specified region. | ||
57 | Can be in millimeters (e.g. 10mmx20mm\@10mm,20mm) or in terms of 0..1 (e.g. | ||
58 | 0.5x0.5\@0,0). Not all devices support millimeters. Only meaningful if the | ||
59 | device is not a keyboard an provides events in absolute terms (such as a | ||
60 | drawing tablet or touch screen - most pointers provide events relative to the | ||
61 | previous frame). | ||
62 | |||
63 | Libinput Configuration | ||
64 | ~~~~~~~~~~~~~~~~~~~~~~ | ||
20 | 65 | ||
21 | **input** <identifier> accel_profile <adaptive|flat>:: | 66 | **input** <identifier> accel_profile <adaptive|flat>:: |
22 | Sets the pointer acceleration profile for the specified input device. | 67 | Sets the pointer acceleration profile for the specified input device. |
@@ -53,6 +98,27 @@ Commands | |||
53 | **input** <identifier> tap <enabled|disabled>:: | 98 | **input** <identifier> tap <enabled|disabled>:: |
54 | Enables or disables tap for specified input device. | 99 | Enables or disables tap for specified input device. |
55 | 100 | ||
101 | Seat Configuration | ||
102 | ------------------ | ||
103 | |||
104 | Configure options for multiseat mode. sway-seat commands must be used inside a | ||
105 | _seat { }_ block in the config. | ||
106 | |||
107 | A _seat_ is a collection of input devices that act independently of each other. | ||
108 | Seats are identified by name and the default seat is _seat0_ if no seats are | ||
109 | configured. Each seat has an independent keyboard focus and a separate cursor that | ||
110 | is controlled by the pointer devices of the seat. This is useful for multiple | ||
111 | people using the desktop at the same time with their own devices (each sitting in | ||
112 | their own "seat"). | ||
113 | |||
114 | **seat** <name> attach <input_identifier>:: | ||
115 | Attach an input device to this seat by its input identifier. A special value | ||
116 | of _*_ will attach all devices to the seat. | ||
117 | |||
118 | **seat** <name> fallback <true|false>:: | ||
119 | Set this seat as the fallback seat. A fallback seat will attach any device not | ||
120 | explicitly attached to another seat (similar to a "default" seat). | ||
121 | |||
56 | See Also | 122 | See Also |
57 | -------- | 123 | -------- |
58 | 124 | ||