Installation (RU)

English · Русский

Хелпер familiar сам всё подключает: пишет include в твой kitty.conf и генерирует kitten-мапы с абсолютными путями (относительный путь kitty резолвит от ~/.config/kitty, а не от файла с map — просто относительным не обойтись). Никакой ручной правки, никакого sed, и это переживает обновления.

Homebrew (рекомендую)

brew tap denoby/familiar https://github.com/DenoBY/familiar
brew install denoby/familiar/familiar   # полное имя = доверие только этой формуле
familiar enable --all                    # киты + конфиг терминала

Полное имя denoby/familiar/familiar требует Tap Trust из Homebrew 6.0+: сторонние tap не загружаются, пока им не доверишь, а установка по полному имени доверяет только этой формуле. Как альтернатива — один раз доверить весь tap (brew trust denoby/familiar), после чего работает голое brew install familiar.

Самое свежее из master: brew install --HEAD denoby/familiar/familiar.

Из клона (без Homebrew)

git clone https://github.com/DenoBY/familiar && cd familiar
./bin/familiar enable --all

Команда одна и та же. Затем перезагрузи конфиг — Cmd+Ctrl+, — или перезапусти kitty. (Ctrl+Shift+F5 — это Linux-дефолт перезагрузки; на macOS это Cmd+Ctrl+,.)

Режимы установки

Сколько подключать:

Команда	Что включает
familiar enable --all	все киты + конфиг терминала (вид, сплиты, табы, русская раскладка) — спросит подтверждение, т.к. переопределит твои настройки kitty
familiar enable --kittens	только все киты, конфиг терминала не трогает
familiar enable session review log	только названные оверлеи (--terminal добавит и конфиг терминала)
familiar enable --terminal	только конфиг терминала, без китов
familiar enable --all --theme darcula	то же, что --all, но с палитрой Darcula (JetBrains) вместо дефолтной — см. Темы
familiar disable	снять familiar-блок (--restore вернёт kitty.conf из копии, снятой при первом enable)
familiar status	показать, что подключено сейчас

Кириллические дубли клавиш (S→ы, R→к, L→д) для русской раскладки генерируются автоматически.

Удаление / откат

familiar только дописывает размеченный блок в твой kitty.conf и кладёт рядом familiar.conf — больше ничего не трогает, поэтому снимается чисто:

familiar disable            # убрать familiar-блок + familiar.conf
familiar disable --restore  # ...и вернуть kitty.conf из копии

При первом enable familiar один раз копирует kitty.conf в kitty.conf.familiar.bak (состояние «до familiar»). --restore возвращает его байт-в-байт; копия остаётся и после, так что откатиться можно и позже. familiar status показывает, где она лежит.

Хочешь вручную? Удали блок между маркерами # >>> familiar >>> / # <<< familiar <<< в kitty.conf, убери familiar.conf или просто скопируй kitty.conf.familiar.bak обратно поверх kitty.conf.

Открыть: Cmd+Shift+S / Cmd+Shift+R / Cmd+Shift+L.