Where Is the Kanata Config File?
Kanata reads a .kbd config passed with the cfg flag. Conventional home is the kanata folder under config home on Linux.
Last updated
Kanata takes its config as a command line argument, not from a fixed path. You keep the .kbd file wherever you like and pass it with the cfg flag. Community convention puts it in a kanata folder under the XDG config home, matching the systemd unit in the official docs.
The macOS daemon differs. Its sample plist points at etc kanata kanata.kbd with the binary in usr local bin. Windows users typically keep the file beside the exe or in Documents. Either way the flag, not the folder, decides. Includes pull shared layers from other files at the top level.
Where Kanata stores this, by platform
/home/<username>/.config/kanata/config.kbd
Conventional config from the official systemd example. Any path works when passed with the cfg flag.
/etc/kanata/kanata.kbd
Daemon default from the sample plist. Edit both paths in ProgramArguments when you relocate either file.
C:\Tools\kanata\kanata.kbd
Portable habit on Windows. Keep the kbd next to the exe and launch with the cfg flag from a shortcut.
Frequently asked questions
How do I write my first Kanata config?
Write a kbd file with defsrc, deflayer, and defcfg blocks, then run kanata with the cfg flag pointing at it. Samples ship in cfg_samples for every feature.
How do I run Kanata at login on Linux?
Create a user systemd unit running kanata with the cfg flag and no wait flag. The repo docs show the exact unit file with restart on failure.
Notice an outdated path? Let us know.