Webarchitects Kitty Ansible Role

This Ansible role helps you install or update Kitty in the ~/.local directory on Debian and Ubuntu. It may also work on other Linux distributions, but has only been tested on these two.

You can use this repository to install the latest version, the nightly version, or a specific version of Kitty that is 0.20.3 or newer (earlier versions do not have GPG signatures).

How to Use

The recommended way to use this role is through the localhost repo. This repo contains a script called kitty.sh that will download and run this role. Here’s how you can do it:

git clone https://git.coop/webarch/localhost.git
cd localhost
./kitty.sh --check
./kitty.sh

This role is meant to be run by a non-root user and will install Kitty in ~/.local/bin. If your ~/.local/bin directory is not in your $PATH variable, add the following lines to your ~/.bash_profile or another file that sets your $PATH when you log in:

PATH="${HOME}/.local/bin:${PATH}"
export PATH="${PATH}"

Role Variables

Check the defaults/main.yml file for default variables, the vars/main.yml file for preset variables, and the meta/argument_specs.yml file for variable specifications.

The variable ansible_env.HOME refers to the $HOME directory of the user running Ansible.

Remote Servers

For remote installations, you should install the kitty-terminfo package. Also, check the SSH documentation for more information.

Configuration Tweaks

To make sure that Ctrl+Shift+V works in Vim, add this line to ~/.config/kitty/kitty.conf:

map ctrl+shift+v send_text all \x16

Repository Information

The main URL for this repository is https://git.coop/webarch/kitty, and it is also mirrored on GitHub and available on Ansible Galaxy.

If you use this role, please choose a tagged release and refer to the release notes for more details.

You can also use this role with the localhost repo to install Kitty locally, but some changes may be necessary to avoid prompts for sudo passwords.

Copyright

Copyright 2022-2023 Chris Croome, <[email protected]>.

This role is shared under the same terms as Ansible, the GNU GPLv3.