NeViRAIDE/nekifoch.nvim

github github
terminal-integration
stars 16
issues 0
subscribers 1
forks 1
CREATED

2023-08-31

UPDATED

7 days ago


NeKiFoCh

Neovim Kitty Font Changer

Release License Neovim version


Neovim plugin for managing Kitty terminal font settings.


https://github.com/RAprogramm/nekifoch/assets/70325462/04a0d7e7-a42e-4588-a926-0945adacb3f0

Installation

Install Nekifoch using your favorite plugin manager. For example, with lazy.nvim:

{
    'NeViRAIDE/nekifoch.nvim',
    build = 'chmod +x ./install.sh && ./install.sh',
    cmd = 'Nekifoch',
    config = true,
}

Default config values

{
    kitty_conf_path = '~/.config/kitty/kitty.conf',
    borders = 'single', --available values are: 'rounded', 'single', 'double', 'shadow', 'solid', 'none'
}

Usage

Nekifoch provides the :Nekifoch command with the following syntax:

:Nekifoch [action] [font_family/font_size]
  • [action] (optional) can be one of:
    • check,
    • set_font,
    • set_size,
    • list.
  • [font_family/font_size]: New font family/size for the set_font/set_size action.

Examples:

  • Open NeKiFoCh main menu:
:Nekifoch
  • Check the current font family and size:
:Nekifoch check
  • Check the current font family and size in float window:
:Nekifoch float_check
  • Replace the font family with "DejaVu Sans Mono":
:Nekifoch set_font DejaVuSansMono
  • Open float window to set font family:
:Nekifoch set_font
  • Replace the font size with "14":
:Nekifoch set_size 14
  • Open float window to set font size:
:Nekifoch set_size
  • List available fonts compatible with Kitty:
:Nekifoch list
  • List available fonts compatible with Kitty in float window:
:Nekifoch float_list

Configuration

Configure Nekifoch using the FontReplaceConfig dictionary:

Nekifoch can be configured by adding a Lua configuration to your Neovim configuration file (init.lua).

Here's an example configuration using Lua:

require('nekifoch').setup({
  kitty_conf_path = vim.fn.expand('~/.config/kitty/kitty.conf')
})

or

{
    'NeViRAIDE/nekifoch.nvim',
    build = 'chmod +x ./install.sh && ./install.sh',
    cmd = 'Nekifoch', -- to add lazy loading
    opts = {
        kitty_conf_path = vim.fn.expand('~/.config/kitty/kitty.conf'), -- your kitty config path
    }
}

Replace '~/.config/kitty/kitty.conf' with the actual path to your Kitty terminal configuration.

Credits

Developed by RAprogramm. Contributions are welcome.

License

APACHE 2.0

For in-depth details and usage instructions, refer to the documentation.


Enhance your Kitty terminal experience with Nekifoch