kitty

Webarchitects Kitty Ansible Role

pipeline status

Ansible role to install update Kitty in ~/.local on Debian and Ubuntu (it might work on other Linux distros but it has only been tested on these two).

This repo can be used to install and update the latest version, or the nightly version or a specific version of Kitty equal to or newer than 0.20.3 (earlier versions did not have GPG signatures).

Usage

The suggested method for using this role is via the localhost repo which contains a kitty.sh script that will download this role and run it, for example:

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

This role is designed to be run by a non-root user, it will install Kitty to ~/.local/bin, if ~/.local/bin is not in your $PATH environmental variable add the following to your ~/.bash_profile or whichever file sets your $PATH environmental variable when you login:

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

Role variables

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

Variable name Default value Comment
kitty true If this variable is set to false all tasks in this role will be skipped.
kitty_bin {{ ansible_env.HOME }}/.local/bin The directory in which the kitty binary resides.
kitty_local {{ ansible_env.HOME }}/.local/kitty.app The directory that the Kitty archive is extracted into.
kitty_tmp {{ ansible_env.HOME }}/tmp The directory that the Kitty archive and GPG signature to downloaded into.
kitty_version latest Valid options are latest, nightly or a version number, eg 0.20.3.

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

Remote servers

Install the kitty-terminfo package and see the SSH documentation.

Config tweaks

To ensure that ctrl+shift+v goes to Vim add the following to ~/.config/kitty/kitty.conf:

map ctrl+shift+v send_text all \x16

Repo

The primary URL of this repo is https://git.coop/webarch/kitty however it is also mirrored to GitHub and available via Ansible Galaxy.

If you use this role please use a tagged release, see the release notes.

This role can also be used with the localhost repo to install kitty locally however not that it would need some changes so that it doesn't prompt for the sudo password and then run as root.

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

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

About

Ansible role for installing Kitty on Debian and Ubuntu

Install
ansible-galaxy install webarch-coop/ansible-role-kitty
GitHub repository
License
gpl-3.0
Downloads
69
Owner
Multi-stakeholder co-operative which provides ethical & green, web hosting, virtual servers and GNU/Linux sysadmin & devop services, code at git.coop/webarch