aboutsummaryrefslogtreecommitdiffstats
path: root/sway/sway-input.5.txt
diff options
context:
space:
mode:
Diffstat (limited to 'sway/sway-input.5.txt')
-rw-r--r--sway/sway-input.5.txt74
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/////
2vim:set ts=4 sw=4 tw=82 noet: 2vim:set ft=asciidoc ts=4 sw=4 tw=82 noet:
3///// 3/////
4sway-input (5) 4sway-input (5)
5============== 5==============
@@ -11,12 +11,57 @@ sway-input - input configuration file and commands
11Description 11Description
12----------- 12-----------
13 13
14Sway allows for configuration of libinput devices within the sway configuration file. 14Sway allows for configuration of devices within the sway configuration file.
15sway-input commands must be used inside an _input { }_ block in the config. 15sway-input commands must be used inside an _input { }_ block in the config.
16To obtain a list of available device identifiers, run **swaymsg -t get_inputs**. 16To obtain a list of available device identifiers, run **swaymsg -t get_inputs**.
17 17
18Commands 18Input Commands
19-------- 19--------------
20
21Keyboard Configuration
22~~~~~~~~~~~~~~~~~~~~~~
23
24For 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
43Mapping 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
63Libinput 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
101Seat Configuration
102------------------
103
104Configure options for multiseat mode. sway-seat commands must be used inside a
105_seat { }_ block in the config.
106
107A _seat_ is a collection of input devices that act independently of each other.
108Seats are identified by name and the default seat is _seat0_ if no seats are
109configured. Each seat has an independent keyboard focus and a separate cursor that
110is controlled by the pointer devices of the seat. This is useful for multiple
111people using the desktop at the same time with their own devices (each sitting in
112their 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
56See Also 122See Also
57-------- 123--------
58 124