kitty
Webarchitects Kitty Ansible Role
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
Copyright 2022-2023 Chris Croome, <[email protected]>.
This role is released under the same terms as Ansible itself, the GNU GPLv3.
ansible-galaxy install webarch-coop/ansible-role-kitty