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"). 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.

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