1sway-output(5) File Formats Manual sway-output(5)
2
6 sway-output - output configuration commands for sway
7
9 You may combine output commands into one, like so:
10 output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png
12 stretch
13 You can get a list of output names with swaymsg -t get_outputs. You may
15 also match any output by using the output name "*".
16 Some outputs may have different names when disconnecting and reconnect‐
18 ing. To identify these, the name can be substituted for a string con‐
19 sisting of the make, model and serial which you can get from swaymsg -t
20 get_outputs. Each value must be separated by one space. For example:
21 output "Some Company ABC123 0x00000000" pos 1920,0
23
25 output <name> mode|resolution|res <WIDTHxHEIGHT>[@<RATE>[Hz]]
26 Configures the specified output to use the given mode. Modes are a
27 combination of width and height (in pixels) and a refresh rate that
28 your display can be configured to use. For a list of available
29 modes for each output, use swaymsg -t get_outputs.
30 Examples:
32 output HDMI-A-1 mode 1920x1080
34 output HDMI-A-1 mode 1920x1080@60Hz
36 output <name> position|pos <X> <Y>
38 Places the specified output at the specific position in the global
39 coordinate space. The cursor may only be moved between immediately
40 adjacent outputs. If scaling is active, it has to be considered
41 when positioning. For example, if the scaling factor for the left
42 output is 2, the relative position for the right output has to be
43 divided by 2. The reference point is the top left corner so if you
44 want the bottoms aligned this has to be considered as well.
45 Example:
47 output HDMI1 scale 2
49 output HDMI1 pos 0 1020 res 3200x1800
51 output eDP1 pos 1600 0 res 1920x1080
53 Note that the left x-pos of eDP1 is 1600 = 3200/2 and the bottom y-
55 pos is 1020 + (1800 / 2) = 1920 = 0 + 1920
56 output <name> scale <factor>
58 Scales the specified output by the specified scale factor. An inte‐
59 ger is recommended, but fractional values are also supported. If a
60 fractional value are specified, be warned that it is not possible
61 to faithfully represent the contents of your windows - they will be
62 rendered at the next highest integral scale factor and downscaled.
63 You may be better served by setting an integral scale factor and
64 adjusting the font size of your applications to taste. HiDPI isn't
65 supported with Xwayland clients (windows will blur).
66 output <name> subpixel rgb|bgr|vrgb|vbgr|none
68 Manually sets the subpixel hinting for the specified output. This
69 value is usually auto-detected, but some displays may misreport
70 their subpixel geometry. Using the correct subpixel hinting allows
71 for sharper text. Incorrect values will result in blurrier text.
72 When changing this via swaymsg, some applications may need to be
73 restarted to use the new value.
74 output <name> background|bg <file> <mode> [<fallback_color>]
76 Sets the wallpaper for the given output to the specified file,
77 using the given scaling mode (one of "stretch", "fill", "fit",
78 "center", "tile"). If the specified file cannot be accessed or if
79 the image does fill the entire output, a fallback color may be pro‐
80 vided to cover the rest of the output. fallback_color__ should be
81 specified as #RRGGBB. Alpha is not supported.
82 output <name> background|bg <color> solid_color
84 Sets the background of the given output to the specified color.
85 color should be specified as #RRGGBB. Alpha is not supported.
86 output <name> transform <transform> [clockwise|anticlockwise]
88 Sets the background transform to the given value. Can be one of
89 "90", "180", "270" for rotation; or "flipped", "flipped-90",
90 "flipped-180", "flipped-270" to apply a rotation and flip, or "nor‐
91 mal" to apply no transform. If a single output is chosen and a
92 rotation direction is specified (clockwise or anticlockwise) then
93 the transform is added or subtracted from the current transform.
94 output <name> disable|enable
96 Enables or disables the specified output (all outputs are enabled
97 by default).
98 output <name> dpms on|off
100 Enables or disables the specified output via DPMS. To turn an out‐
101 put off (ie. blank the screen but keep workspaces as-is), one can
102 set DPMS to off.
103
105 sway(5) sway-input(5)
106 2019-07-27 sway-output(5)