include /etc/kanshi/config.d/*
profile {
	output LVDS-1 disable
	output "Some Company ASDF 4242" {
		mode 1600x900
		position 0,0
	}
}
profile nomad {
	output LVDS-1 enable scale 2
}

These defaults only apply when the respective output is mentioned in a specific profile. For example, the following two profiles are equivalent:

output eDP-1 scale 2
profile manual {
	output eDP-1 scale 2
}
profile uses-defaults {
	output eDP-1
}

Output directives may be specified in a bracket-delimited block as well.

The criteria can be one of:

• An output name (e.g. "DP-1"). Note, output names may not be stable: they may change across reboots (depending on kernel driver probe order) or creation order (typically for USB-C docks).
• A space-separated string containing the output manufacturer, model and serial number (e.g. "Foocorp ASDF 1234"). A wildcard pattern can be used (e.g. "Foocorp ASDF *"), see glob(7). If one of these fields is missing, it needs to be populated with the string "Unknown" (e.g. "Foocorp ASDF Unknown").
• An output alias (e.g. "$work-desk3") defined by an output alias directive. Output aliases can only be used in profile scope.
• A wildcard "*", to match any output. Wildcards can only be used in profile scope and will only match one output.

Output directives may be specified in a bracket-delimited block as well.

On sway(1), output names and identifiers can be obtained via "swaymsg -t get_outputs".

Commands are executed asynchronously and their order may not be preserved. If you need to execute sequential commands, you should collect in one exec statement or in a separate script.

On sway(1) for example, exec can be used to move workspaces to the right output:

profile multihead {
	output eDP-1 enable
	output DP-1 enable transform 270
	exec swaymsg workspace 1, move workspace to eDP-1
}

Note that some extra care must be taken with outputs identified by an output description as the real name may change:

profile complex {
	output "Some Other Company GTBZ 2525" mode 1920x1200
	exec swaymsg workspace 1, move workspace to output '"Some Other Company GTBZ 2525"'
}

Examples:

output HDMI-A-1 mode 1920x1080
output HDMI-A-1 mode 1920x1080@60Hz
output HDMI-A-1 mode --custom 1280x720@60Hz

Example:

output HDMI-A-1 position 1600,0