Where Is the kanshi Config File?
Where kanshi keeps monitor profiles on Linux, and how output rules map to workspaces.
Last updated
kanshi applies Wayland output profiles when monitors plug in. Its config lives at ~/.config/kanshi/config: named profiles, each with output lines for mode, position, and scale.
Laptop dockers feel the benefit first. One file covers desk, couch, and projector layouts. Keep EDID quirks in comments; monitor names shift between kernels and a note saves future debugging.
Where kanshi stores this, by platform
~/.config/kanshi/config
Profile-based output config for Wayland compositors. Reload on SIGUSR1. Pair with sway or Hyprland output lines for workspace assignment.
Frequently asked questions
How do I define monitor profiles?
Write ~/.config/kanshi/config with one profile block per setup (docked, undocked, presentation), each listing outputs and modes. Reload with killall -SIGUSR1 kanshi or by restarting the service. Test with kanshictl if available.
Does kanshi switch automatically on plug events?
Yes. kanshi watches for hotplug events and applies the first profile whose outputs all match. Name profiles after situations (dock, home, travel) rather than hardware so the intent stays clear when cables change.
Notice an outdated path? Let us know.