Arsenik Kanata
================================================================================
Installation
--------------------------------------------------------------------------------
- To get Arsenik, check out this repository with Git or
[download it][Download Arsenik].
- Launch `kanata.kbd` with Kanata.
- You can install Kanata by downloading a
[pre-built executable][Download Kanata].
- Follow the installation details of your operating system.
Windows
Windows users might prefer to download the `kanata_winIOv2.exe` version as it
fixes some weird bugs like C and V inversion.
*Note: This tip has been tested for version 1.6.1 of Kanata. In later versions the
`winIOv2` version might be the default.*
Put the `kanata_winIOv2.exe` in the Kanata Arsenik folder, run it and you’re
good to go!
Linux
### Run Kanata without sudo
kanata needs to intercept `uinput` signals, which it cannot do without the
proper authorisations.
If you don’t want to run `kanata` with `sudo`, you’ll need to allow Kanata to
read from `uinput`. This requires the users to be part of both `input` and
`uinput` groups.
For that, you first need to create a `uinput` group if it doesn’t exist yet:
```bash
sudo groupadd -U $USERNAME uinput
```
where `$USERNAME` is the target user (or users in a comma-separated list). Then
add the target user (or users) to the group input:
```bash
sudo usermod -aG input $USERNAME
```
You can check after re-logging that both groups appear in the result of the
`groups` command launched as the target user.
Finally, you need to add a udev rule in `/etc/udev/rules.d/50-kanata.rules`:
```udev
KERNEL=="uinput", MODE="0660", GROUP="uinput", OPTIONS+="static_node=uinput"
```
### Making a user-side systemd
service for Kanata
Note: This only works if `kanata` is able to run without `sudo` (and is using
`systemd`).
Using a `systemd service` allows running `kanata` as a daemon, possibly right
after logging in. Here is a template for a service file:
```
[Unit]
Description=Kanata keyboard remapper
Documentation=https://github.com/jtroo/kanata
[Service]
Environment=PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/bin
Environment=DISPLAY=:0
Environment=HOME=/path/to/home/folder
Type=simple
ExecStart=/usr/local/bin/kanata --cfg /path/to/kanata/config/file
Restart=no
[Install]
WantedBy=default.target
```
Copy-paste it into `~/.config/systemd/user/kanata.service`, fill in the
placeholders, then run one of the following commands:
- `systemctl --user start kanata.service` to manually start `kanata`
- `systemctl --user enable kanata.service` so `kanata` may autostart whenever
the current user logs in
- `systemctl --user status kanata.service` to check if `kanata` is running
[Download Arsenik]: https://github.com/OneDeadKey/arsenik/releases
[Download Kanata]: https://github.com/jtroo/kanata/releases