Skip to content

Latest commit

 

History

History
37 lines (28 loc) · 1.61 KB

HOWTO-INSTALL.md

File metadata and controls

37 lines (28 loc) · 1.61 KB

HOWTO install as a service (Linux)

  1. Install kanata.
  2. Copy the configuration file to a system wide place. (We use /etc/kanata.)
  3. Install the service description for kanata.
  4. (re)start the system service.
  5. Enable it to auto-start on boot.
mkdir /etc/kanata
cp colemax-maxtend.kbd /etc/kanata
sudo install -m 644 kanata.service /lib/systemd/system/kanata.service
# maybe the next line will be required after installing or changing the service file:
# sudo systemctl daemon-reload 
sudo systemctl start kanata
sudo systemctl enable kanata

HOWTO install to autostart (Windows)

  1. Create an installation directory. We use C:\Utilities.
  2. Download kanata_winIOv2.exe or kanata_gui.exe (for tray icon support) and move it to C:\Utilities.
  3. Copy the configuration file to C:\Utilities\colemax-maxtend.kbd.
  4. If you are using kanata_gui.exe and you want tray icons per layer, copy the icons folder to C:\Utilities\icons
  5. Copy kanata.bat to C:\Utilities.
  6. Press Win+R, enter shell:startup and click OK.
  7. Create a shortcut to C:\Utilities\kanata.bat in this folder.

Properties of Kanata Shortcut

When you login to your user account, Kanata will be run in a small terminal window. You will be able to monitor layer changes in this window.

To test your setup & start Kanata immediately, double-click the shortcut.

If you are running kanata_gui.exe, you'll see a tray icon. You can quit Kanata from the tray icon (right-click menu).

You can also end either version of Kanata it by closing the terminal window, or typing Ctrl+C in the terminal window.