Написать свой оконный менеджер: опыт скрипта для KWin
Большую часть дня я провожу между терминалом, редактором и браузером. Расставлять окна мышью — это сотни мелких движений в день, и каждое из них отвлекает.
Tiling-менеджеры окон решают эту проблему: окна расставляются автоматически, а вы управляете ими с клавиатуры. Но обычно они требуют сменить весь рабочий стол, а отказываться от KDE я не хотел.
Готовый плагин существовал. Я поставил его, поработал неделю — и начал писать свой.
Эта статья о том решении и о том, что из него вышло.
Почему не хватило готового решения
Сразу буду честен: готовый плагин был неплохим. Он работал.
Проблема была в другом. В моём рабочем процессе было несколько конкретных требований, и каждое из них в плагине либо отсутствовало, либо работало иначе. Каждый раз я подстраивался под представления плагина.
Это мелкое трение, но оно повторяется десятки раз в день. И именно ради таких вещей инструменты настраивают.
Критерий решения, по-моему, такой: если вы пользуетесь инструментом каждый день и он каждый день вам сопротивляется — менять его стоит. Если раз в месяц — потерпите.
Я был в первом случае.
Что такое скрипт KWin
Технически это простая штука: оконный менеджер KDE загружает JavaScript-скрипты и даёт им API для управления окнами.
Самый простой скрипт выглядит так:
workspace.windowAdded.connect((window) => {
if (window.normalWindow) {
window.frameGeometry = { x: 0, y: 0, width: 1280, height: 1440 }
}
})Подписываетесь на событие, при появлении окна меняете его размер. Вся логика тайлинга — это развитие той же идеи.
Набор нужных вещей невелик: список окон, их геометрия, размер экрана и события (окно добавлено, закрыто, активировано).
Первая работающая версия
Я начал с простейшего раскладки: одно «главное» окно слева, остальные справа стопкой.
Логика умещается в несколько функций:
- Составить список управляемых окон (исключив диалоги и панели).
- Разделить экран на главную и стековую части.
- Поместить первое окно в главную, остальные равномерно распределить в стек.
- Пересчитывать при любом изменении.
Рабочая версия появилась за вечер. И именно тут я понял главное: ценность этого проекта не в объёме кода, а в том, что он подходит именно вам.
Откуда берётся сложность
Основная логика проста. Сложность появляется по краям, и растёт она быстрее, чем ожидаешь.
Вот с чем я столкнулся:
Какими окнами вообще управлять? Диалоги, всплывающие меню, панель — их тайлить не нужно. Нужен фильтр, и он никогда не бывает полным.
Полноэкранные и свёрнутые окна. Если пользователь развернул окно, скрипт не должен в это вмешиваться.
Несколько мониторов. У каждого должна быть своя раскладка, а при переносе окна между мониторами состояние нужно обновлять.
Активности и виртуальные рабочие столы. При переходе окна на другой стол оно должно выпадать из текущей раскладки.
Этот список со временем удлиняется. Поэтому я рано принял одно правило: любая новая возможность должна отключаться. Не работает — выключили, а не выбросили весь скрипт.
Что добавилось
За несколько месяцев скрипт вырос. Сейчас в нём пять раскладок: вертикальный и горизонтальный master-stack, монокль (одно окно во весь экран), сетка и спираль.
Самые полезные из дополнений:
Терминал-scratchpad. Терминал, который появляется и прячется по одной клавише. Он оказался куда полезнее, чем я ожидал, — пользуюсь им десятки раз в день.
Оверлей с подсказками. По нажатию клавиши выводится список всех сочетаний. Причина простая: я забывал сочетания, которые сам же и придумал. Позже я сделал генерацию этого списка автоматической, из кода, — потому что написанный вручную мгновенно устарел.
Окно настроек. Сначала все настройки жили в конфигурационном файле. Потом я сделал простую форму внутри системных настроек. В проекте «для себя» это может показаться лишним, но оно избавило меня от редактирования файлов.
Сохранение состояния. Это оказалось самой сложной частью, и она до сих пор неполная: при перезапуске KWin состояние раскладки теряется. Я оставил это как принятое ограничение, потому что полное решение потребовало бы несоразмерных усилий.
Тесты — неожиданная необходимость
Писать тесты для личного проекта может показаться избыточным. У меня вышло наоборот.
Причина в том, что логику расстановки окон можно написать как чистую функцию: на вход список окон и размер экрана, на выход список геометрий. Такой код тестировать очень легко.
И тесты были очень нужны, потому что каждая новая раскладка грозила сломать старые. Сейчас в скрипте 22 теста, и они дают мне уверенность после каждого изменения.
Здесь любопытное противоречие: для системы комментариев в блоге я намеренно не писал тестов, потому что она проста и цена ошибки мала. А здесь логика сложная и риск регрессии высокий. Тот же человек — совершенно другое решение, потому что критерий не в типе проекта, а в цене ошибки и сложности.
В какие ловушки я попал
Несколько стоит упомянуть.
Чтение конфигурации. Способ, описанный в документации, у меня не сработал — нужно было использовать глобальную функцию. Такие вещи видны не в документации, а только в исходниках.
Файлы автозапуска. В них обязателен абсолютный путь. Относительный путь или символ домашнего каталога не раскрываются, и служба молча не стартует.
Клавиатурные сочетания кэшируются. Если поменять сочетание в коде, старое останется в системном кэше. Его нужно вручную сбросить в системных настройках. Не зная этого, я потратил час.
Конфликт с другими tiling-плагинами. Если работают два сразу, они начинают двигать окна друг друга. В свой установочный скрипт я добавил шаг автоматического отключения.
Стоило ли оно того
Честный ответ: если считать время только с точки зрения экономии — нет.
Настройка готового плагина заняла бы несколько часов. Я потратил несколько дней.
Но есть две другие отдачи.
Первая — окружение теперь полностью соответствует моему рабочему процессу. Ежедневно повторяющееся трение исчезло. Мелочь, но она действует каждый день.
Вторая, и неожиданная, — я понимаю своё окружение. Раньше окна «как-то сами так расставлялись». Теперь я знаю, почему именно так, и могу изменить что угодно. Это ощущение повлияло на весь мой опыт работы в Linux.
Если вы обдумываете подобный проект, дам один совет: начните с простейшей работающей версии. Одна раскладка, два сочетания клавиш, никаких настроек. Поработайте с ней неделю. Если за эту неделю вы к ней не вернулись — проект вам не нужен, а потратили вы всего один вечер.
Если вернулись — продолжайте с этого места. У меня получилось именно так.