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 @@ ///// -vim:set ts=4 sw=4 tw=82 noet: +vim:set ft=asciidoc ts=4 sw=4 tw=82 noet: ///// sway-input (5) ============== @@ -11,12 +11,57 @@ sway-input - input configuration file and commands Description ----------- -Sway allows for configuration of libinput devices within the sway configuration file. +Sway allows for configuration of devices within the sway configuration file. sway-input commands must be used inside an _input { }_ block in the config. To obtain a list of available device identifiers, run **swaymsg -t get_inputs**. -Commands --------- +Input Commands +-------------- + +Keyboard Configuration +~~~~~~~~~~~~~~~~~~~~~~ + +For more information on these xkb configuration options, see +**xkeyboard-config**(7). + +**input** <identifier> xkb_layout <layout_name>:: + Sets the layout of the keyboard like _us_ or _de_. + +**input** <identifier> xkb_model <model_name>:: + Sets the model of the keyboard. This has an influence for some extra keys your + keyboard might have. + +**input** <identifier> xkb_options <options>:: + Sets extra xkb configuration options for the keyboard. + +**input** <identifier> xkb_rules <rules>:: + Sets files of rules to be used for keyboard mapping composition. + +**input** <identifier> xkb_variant <variant>:: + Sets the variant of the keyboard like _dvorak_ or _colemak_. + +Mapping Configuration +--------------------- + +**input** <identifier> map_to_output <identifier>:: + Maps inputs from this device to the specified output. Only meaningful if the + device is a pointer, touch, or drawing tablet device. + +**input** <identifier> map_to_region <WxH\@X,Y>:: + Maps inputs from this device to the specified region of the global output + layout. Only meaningful if the device is a pointer, touch, or drawing tablet + device. + +**input** <identifier> map_region <WxH\@X,Y>:: + Ignores inputs from this device that do not occur within the specified region. + Can be in millimeters (e.g. 10mmx20mm\@10mm,20mm) or in terms of 0..1 (e.g. + 0.5x0.5\@0,0). Not all devices support millimeters. Only meaningful if the + device is not a keyboard an provides events in absolute terms (such as a + drawing tablet or touch screen - most pointers provide events relative to the + previous frame). + +Libinput Configuration +~~~~~~~~~~~~~~~~~~~~~~ **input** <identifier> accel_profile <adaptive|flat>:: Sets the pointer acceleration profile for the specified input device. @@ -53,6 +98,27 @@ Commands **input** <identifier> tap <enabled|disabled>:: Enables or disables tap for specified input device. +Seat Configuration +------------------ + +Configure options for multiseat mode. sway-seat commands must be used inside a +_seat { }_ block in the config. + +A _seat_ is a collection of input devices that act independently of each other. +Seats are identified by name and the default seat is _seat0_ if no seats are +configured. Each seat has an independent keyboard focus and a separate cursor that +is controlled by the pointer devices of the seat. This is useful for multiple +people using the desktop at the same time with their own devices (each sitting in +their own "seat"). + +**seat** <name> attach <input_identifier>:: + Attach an input device to this seat by its input identifier. A special value + of _*_ will attach all devices to the seat. + +**seat** <name> fallback <true|false>:: + Set this seat as the fallback seat. A fallback seat will attach any device not + explicitly attached to another seat (similar to a "default" seat). + See Also -------- |