Руководство пользователя i3

Очень простой операцией является открытие нового терминала. По умолчанию для этого используется сочетание клавиш $mod+Enter, то есть Alt+Enter (Mod1+Enter) в стандартной конфигурации. Нажав $mod+Enter, будет открыт новый терминал, который заполнит всё доступное пространство на экране.

Если теперь открыть другой терминал, i3 разместит его рядом с текущим, разделив размер экрана пополам. В зависимости от вашего монитора, i3 расположит созданное окно рядом с существующим окном (на широких дисплеях) или под существующим окном (на повернутых дисплеях).

Для переключения фокуса между двумя терминалами можно использовать клавиши со стрелками. Для удобства стрелки также доступны непосредственно на числовой части клавиатуры под правой рукой:

Обратите внимание, что это отличается от популярного текстового редактора vi, который был разработан на терминале ADM-3A и поэтому использует hjkl вместо jkl; — по умолчанию i3 предназначен для минимального перемещения пальцев, но некоторые пользователи vi изменяют свою конфигурацию i3 для согласованности.

В данный момент ваше рабочее пространство разделено (содержит два терминала) в определенном направлении (по горизонтали по умолчанию). Каждое окно можно снова разделить по горизонтали или вертикали, как и рабочее пространство. Термины «окно» для контейнера, фактически содержащего окно X11 (например, терминал или браузер), и «разделенный контейнер» для контейнеров, состоящих из одного или нескольких окон.

Чтобы разделить окно по вертикали, нажмите $mod+v перед созданием нового окна. Чтобы разделить его по горизонтали, нажмите $mod+h.

Разделенный контейнер может иметь один из следующих макетов:

Для переключения режимов нажмите $mod+e для splith/splitv (переключает), $mod+s для stacking и $mod+w для tabbed.

Чтобы отобразить окно в полноэкранном режиме или выйти из полноэкранного режима, нажмите $mod+f.

В i3 также есть глобальный полноэкранный режим, в котором клиент будет занимать все доступные выходы (команда — fullscreen toggle global).

Помимо открытия приложений из терминала, вы также можете использовать удобную утилиту dmenu, которая открывается нажатием $mod+d по умолчанию. Просто введите имя (или часть имени) приложения, которое вы хотите открыть. Соответствующее приложение должно быть в вашей переменной среды $PATH, чтобы это работало.

Кроме того, если у вас есть приложения, которые вы открываете очень часто, вы можете создать сочетание клавиш для их прямого запуска. Подробности см. в разделе [настройка].

Если приложение не предоставляет механизма для закрытия (большинство приложений предоставляют меню, клавишу Esc или сочетание клавиш, например, Control+w, для закрытия), вы можете нажать $mod+Shift+q для закрытия окна. Для приложений, которые поддерживают протокол WM_DELETE, это позволит корректно закрыть приложение (сохранив любые изменения или выполнив другие действия по очистке). Если приложение не поддерживает протокол WM_DELETE, ваш сервер X закроет окно, а поведение зависит от приложения.

Рабочие пространства — это простой способ группировать набор окон. По умолчанию вы находитесь на первом рабочем пространстве, как указывает панель в левом нижнем углу. Чтобы переключиться на другое рабочее пространство, нажмите $mod+num, где num — номер рабочего пространства, которое вы хотите использовать. Если рабочего пространства еще нет, оно будет создано.

Общим подходом является размещение веб-браузера на одном рабочем пространстве, приложений для связи (mutt, irssi, …) на другом, а приложений, с которыми вы работаете, на третьем. Конечно, нет необходимости следовать этому подходу.

Если у вас несколько экранов, при запуске будет создано рабочее пространство на каждом экране. Если вы открываете новое рабочее пространство, оно будет привязано к экрану, на котором вы его создали. При переключении на рабочее пространство на другом экране i3 переключит фокус на этот экран.

Чтобы переместить окно в другое рабочее пространство, просто нажмите $mod+Shift+num, где num (как при переключении рабочих пространств) — номер целевого рабочего пространства. Аналогично переключению рабочих пространств, целевое рабочее пространство будет создано, если оно еще не существует.

Самый простой способ изменить размер контейнера — использование мыши: перетащите границу до нужного размера.

Вы также можете использовать [режимы привязки] для определения режима изменения размера с помощью клавиатуры. Для примера см. стандартную конфигурацию, предоставленную i3.

Для перезапуска i3 на месте (и, таким образом, получения чистого состояния, если есть ошибка, или для обновления до более новой версии i3) вы можете использовать $mod+Shift+r.

Для чистого выхода из i3 без завершения работы вашего сервера X вы можете использовать $mod+Shift+e. По умолчанию появится диалог, который попросит вас подтвердить, действительно ли вы хотите выйти.

Режим плавающих окон — это противоположность режима разбиения по углам. Положение и размер окна не управляются автоматически i3, а вручную вами. Использование этого режима нарушает парадигму разбиения по углам, но может быть полезным в некоторых особых случаях, например, для окон «Сохранить как» или окон панели инструментов (GIMP или аналогичных). Эти окна обычно устанавливают соответствующую подсказку и по умолчанию открываются в режиме плавающих окон.

Вы можете переключить режим плавающего окна для окна, нажав $mod+Shift+Space. Перетаскивая заголовок окна с помощью мыши, вы можете перемещать окно. Перетаскивая границы, вы можете изменить размер окна. Вы также можете сделать это, используя [модификатор плавающего окна]. Другой способ изменения размера плавающих окон с помощью мыши — щелкнуть правой кнопкой мыши по заголовку и перетащить.

Для изменения размера плавающих окон с помощью клавиатуры см. режим привязки к изменению размера, предоставленный стандартной конфигурацией i3 .

Плавающие окна всегда находятся поверх окон, разделённых по углам.

Начиная с i3 4.21, можно перетаскивать контейнеры с помощью мыши. Перетаскивание можно инициировать, перетаскивая заголовок окна или нажав клавишу [floating_modifier] и перетаскивая контейнер, удерживая левую кнопку мыши. См. параметр [config_tiling_drag] для настройки действия, вызывающего перетаскивание контейнеров.

После начала перетаскивания и перемещения курсора за пределы исходного контейнера создаются индикаторы опускания, соответствующие положению курсора относительно целевого контейнера. Эти индикаторы помогают понять, каким будет результирующее расположение [tree] после отпускания кнопки мыши.

Возможные позиции опускания:

Цвет индикатора соответствует настройке client.focused. См. [client_colors].

С версии i3 v4.20 стало возможным включать другие файлы конфигурации из вашей конфигурации i3.

Синтаксис:

i3 расширяет pattern с помощью подобного оболочке расширения слов, используя функцию стандартной библиотеки C wordexp(3).

Примеры:

Если указанный файл не может быть прочитан, например, из-за недостатка прав доступа к файлу или из-за висящей символической ссылки, i3 сообщит об ошибке и продолжит обработку остальной конфигурации.

Чтобы вывести список всех загруженных файлов конфигурации, выполните i3 --moreversion:

Переменные доступны для всех файлов конфигурации, но будьте осторожны с ограничением:

Это техническое ограничение: расширение переменных происходит на отдельном этапе перед анализом директив include.

По концепции, включенные файлы могут только добавлять к конфигурации, а не отменять действия уже обработанной конфигурации. Например, вы можете только добавлять новые сочетания клавиш, а не перезаписывать или удалять существующие. Это означает:

Использование комментариев в файле конфигурации для правильной документации вашей настройки для последующего использования рекомендуется. Комментарии начинаются с символа # и могут использоваться только в начале строки:

Примеры:

i3 поддерживает как шрифты ядра X, так и шрифты FreeType (через Pango) для рендеринга заголовков окон.

Для генерации описания шрифта ядра X можно использовать xfontsel(1). Для отображения специальных символов (Unicode) необходимо использовать шрифт, поддерживающий кодировку ISO-10646.

Описание шрифта FreeType состоит из семейства шрифтов, стиля, веса, варианта, растяжения и размера. Шрифты FreeType поддерживают рендеринг справа налево и часто содержат больше символов Unicode, чем шрифты ядра X.

Если i3 не может открыть настроенный шрифт, он выведет ошибку в лог-файле и переключится на рабочий шрифт.

Синтаксис:

Примеры:

Сочетание клавиш заставляет i3 выполнять команду (см. ниже) при нажатии определенной клавиши. i3 позволяет назначать сочетания клавиш как на кодах клавиш, так и на символах клавиш (вы также можете смешивать сочетания, хотя i3 не защитит вас от перекрывающихся).

Моя рекомендация: Если вы часто переключаете раскладки клавиатуры, но хотите сохранить свои сочетания в том же физическом расположении на клавиатуре, используйте коды клавиш. Если вы не переключаете раскладки и хотите чистый и простой файл конфигурации, используйте символы клавиш.

Некоторые инструменты (такие как xdotool) могут не работать при событии нажатия клавиши, потому что клавиатура все еще захвачена. В этих ситуациях можно использовать флаг --release, который выполнит команду после отпускания клавиш.

Синтаксис:

Примеры:

Доступные модификаторы:

Сочетание мыши заставляет i3 выполнять команду при нажатии определенной кнопки мыши в пределах нажатого контейнера (см. [command_criteria]). Настроить сочетания мыши можно аналогично сочетаниям клавиш.

Синтаксис:

По умолчанию сочетание выполняется только при щелчке по заголовку окна. Если задан флаг --release, оно выполнится при отпускании кнопки мыши.

Если задан флаг --whole-window, сочетание также выполнится при щелчке любой части окна, за исключением рамки. Чтобы сочетание выполнилось при щелчке по рамке, укажите флаг --border.

Если задан флаг --exclude-titlebar, заголовок не будет учитываться для сочетания клавиш.

Примеры:

Вы можете иметь несколько наборов сочетаний, используя разные режимы сочетаний. При переключении на другой режим сочетаний все сочетания из текущего режима отменяются, и только сочетания, определенные в новом режиме, действительны до тех пор, пока вы остаетесь в этом режиме. Единственный предопределенный режим сочетаний — default, в котором i3 начинает работу и которому принадлежат все сочетания, не определенные в определенном режиме сочетаний.

Работа с режимами сочетаний состоит из двух частей: определения режима сочетаний и переключения на него. Для этих целей существует одна директива конфигурации и одна команда, обе называемые mode. Директива используется для определения сочетаний, принадлежащих определенному режиму сочетаний, а команда — для переключения на указанный режим.

Рекомендуется использовать режимы сочетаний в сочетании с [переменными] для облегчения обслуживания. Ниже приведен пример использования режима сочетаний.

Обратите внимание, что рекомендуется определять сочетания для возврата в режим по умолчанию.

Обратите внимание, что можно использовать [разметку pango] для режимов сочетаний, но вам нужно явно включить ее, передав флаг --pango_markup в определение режима.

Синтаксис:

Пример:

Для перемещения плавающего окна с помощью мыши, вы можете либо взять за его заголовок, либо настроить так называемый плавающий модификатор, который затем вы можете нажать и щелкнуть где угодно в окне, чтобы переместить его. Наиболее распространенная настройка — использовать ту же клавишу, что и для управления окнами (например, Mod1). Затем вы можете нажать Mod1, щелкнуть по окну левой кнопкой мыши и перетащить его в нужное положение.

При удерживании плавающего модификатора вы можете изменить размер плавающего окна, нажав правой кнопкой мыши и перемещая его, удерживая нажатой. Если вы также удерживаете клавишу Shift, изменение размера будет пропорциональным (сохранится соотношение сторон).

Синтаксис:

Пример:

Можно указать максимальные и минимальные размеры плавающих окон. Если любой размер floating_maximum_size задан как -1, этот размер не будет ограничен максимальным значением. Если любой размер floating_maximum_size не определён или задан как 0, i3 будет использовать значение по умолчанию для ограничения максимального размера. floating_minimum_size обрабатывается аналогично floating_maximum_size.

Синтаксис:

Пример:

Новые рабочие пространства получают разумную ориентацию по умолчанию: широкоформатные мониторы (любые шире, чем выше) получают горизонтальную ориентацию, повернутые мониторы (любые выше, чем шире) — вертикальную.

С помощью директивы конфигурации default_orientation вы можете переопределить это поведение.

Синтаксис:

Пример:

Этот параметр определяет, в каком режиме будут запускаться новые контейнеры на уровне рабочего пространства.

Синтаксис:

Пример:

Этот параметр определяет выравнивание текста заголовка окна. По умолчанию left

Синтаксис:

Этот параметр определяет стиль рамки, который будет иметь новое окно. По умолчанию normal. Обратите внимание, что default_floating_border применяется только к окнам, которые изначально являются плавающими окнами, например, диалоговым окнам, но не к окнам, которые позже стали плавающими.

Установка стиля рамки на pixel удаляет панели заголовков в разбиениях. Стиль рамки normal позволяет настраивать ширину границы края, сохраняя панель заголовка.

Панель заголовка всегда отображается в стековом и вкладках, и это нельзя изменить через конфигурацию.

Синтаксис:

Обратите внимание, что new_window и new_float устарели и будут удалены в будущей версии. Мы настоятельно рекомендуем использовать новые параметры вместо них.

Пример:

Стиль границ "normal" и "pixel" поддерживают необязательную ширину границы в пикселях:

Пример:

Вы можете скрыть границы контейнера, прилегающие к краям экрана, используя hide_edge_borders (по умолчанию none). Скрытие границ полезно, если вы используете полосы прокрутки или не хотите тратить даже два пикселя на отображаемом пространстве.

Настройка «smart» скрывает границы на рабочих пространствах с только одним видимым окном, но сохраняет их на рабочих пространствах с несколькими видимыми окнами.

Настройка «smart_no_gaps» скрывает специфичные для края границы контейнера, если контейнер является единственным контейнером на рабочем пространстве, а зазоры до края экрана равны 0.

hide_edge_borders заменила старый синтаксис smart_borders. Используйте первый вместо последнего.

Синтаксис:

Пример:

С помощью директивы for_window вы можете позволить i3 выполнить любую команду при обнаружении определенного окна. Это может быть использовано, например, для задания окон в плавающем режиме или для изменения их стиля рамки.

Синтаксис:

Примеры:

Допустимые критерии такие же, как и для команд, см. [command_criteria]. Только команды могут выполняться во время выполнения, а не директивы конфигурации, см. [list_of_commands].

При появлении нового окна оно будет сфокусировано. Директива no_focus позволяет предотвратить это и должна использоваться в сочетании с [command_criteria].

Обратите внимание, что это не относится ко всем случаям, например, при вводе данных в работающее приложение, заставляющее его запросить фокус. Чтобы настроить поведение в таких случаях, обратитесь к [focus_on_window_activation].

no_focus также будет проигнорирован для первого окна на рабочем пространстве, так как нет причины не фокусировать окно в этом случае. Это позволяет улучшить удобство использования в сочетании с workspace_layout.

Синтаксис:

Пример:

Как вы узнали в разделе о привязках к клавиатуре, вам придется настроить множество привязок, содержащих модификаторы. Если вы хотите сэкономить на вводе и иметь возможность изменить используемый модификатор позже, переменные могут быть полезны.

Синтаксис:

Пример:

Переменные непосредственно заменяются в файле при парсинге. Расширение переменных не рекурсивное, поэтому невозможно определить переменную со значением, содержащим другую переменную. Нет сложной обработки, и абсолютно нет планов по изменению этого. Если вам нужна более динамичная конфигурация, вы должны создать небольшой скрипт, который генерирует файл конфигурации и запустить его перед запуском i3 (например, в файле ~/.xsession).

См. также [xresources], чтобы узнать, как создавать переменные на основе ресурсов, загруженных из базы данных ресурсов X.

[переменные] также могут быть созданы, используя значение, настроенное в базе данных ресурсов X. Это полезно, например, для того, чтобы избежать настройки значений цвета в конфигурации i3. Вместо этого значения можно настроить один раз в базе данных ресурсов X, чтобы добиться легко поддерживаемой, согласованной цветовой темы во многих приложениях X.

Определение ресурса загрузит этот ресурс из базы данных ресурсов и присвоит его значение указанной переменной. Это делается дословно, и поэтому значение должно быть в формате, используемом i3. Должен быть указан запасной вариант на случай, если ресурс не может быть загружен из базы данных.

Синтаксис:

Пример:

Для автоматического отображения определённого окна на конкретном рабочем пространстве можно использовать привязку. Окна можно сопоставлять по любым критериям, см. [command_criteria]. Разница между assign и for_window <criteria> move to workspace заключается в том, что первая команда выполняется только при отображении приложения (отображение означает фактическое отображение на экране), а вторая — каждый раз, когда свойства окна изменяются так, что соответствуют заданным критериям.

Поэтому рекомендуется сопоставлять окна по классам (и экземплярам, если это уместно) вместо названий окон, когда это возможно, поскольку некоторые приложения сначала создают своё окно, а затем заботятся о настройке правильного заголовка. Например, Firefox с Vimperator. Окно запускается под названием Firefox, и только когда загружается Vimperator, заголовок меняется. Поскольку i3 получит заголовок, как только приложение отобразит окно, вам придётся в этом случае сопоставлять Firefox. Ещё одна известная проблема связана со Spotify, который не устанавливает подсказки класса при отображении окна, что означает, что для привязки Spotify к определённому рабочему пространству вам нужно использовать правило for_window. Наконец, использование assign [tiling] и assign [floating] не поддерживается.

Также можно привязать окно к определённому выводу. Вы можете использовать имена RandR, такие как VGA1, или имена, относящиеся к выводу с текущим фокусным рабочим пространством, такие как left и down.

Привязки обрабатываются i3 в том порядке, в котором они появляются в файле конфигурации. Первая соответствующая привязка побеждает, и последующие привязки не рассматриваются.

Синтаксис:

Примеры:

Обратите внимание, что у вас может ещё не быть настроено основное устройство вывода. Для этого выполните:

Также стрелка не требуется, она просто выглядит хорошо :-). Если вы решите её использовать, она должна быть стрелкой в кодировке UTF-8, а не -> или чем-то подобным.

Чтобы получить класс и экземпляр, можно использовать xprop. После щелчка по окну вы увидите следующий вывод:

xprop:

Первая часть WM_CLASS — это экземпляр («irssi» в данном примере), вторая — класс («URxvt» в данном примере).

Если у вас возникнут проблемы с привязками, сначала проверьте журнал i3 (см. https://i3wm.org/docs/debugging.html). Он содержит более подробную информацию о процессе сопоставления и фактическом классе, экземпляре и заголовке окна при запуске.

Обратите внимание, что если вы хотите запустить приложение только один раз на определённом рабочем пространстве, но не хотите постоянно привязывать все его экземпляры, вы можете использовать поддержку i3 по уведомлениям об открытии (см. [exec]) в файле конфигурации следующим образом:

Запуск iceweasel на рабочем пространстве 3 (один раз):

Используя ключевое слово exec вне привязки клавиш, можно настроить команды, которые i3 будет выполнять при первоначальном запуске. Команды exec не будут выполняться при перезапуске i3; если вам нужна команда, которая будет выполняться и при перезапуске i3, используйте ключевое слово exec_always. Эти команды будут выполняться в порядке их следования.

См. [command_chaining] для получения подробной информации о специальном значении ; (точка с запятой) и , (запятая): они объединяют команды в i3, поэтому необходимо использовать строковые значения (как показано в [exec_quoting]), если эти символы встречаются в вашей команде.

Синтаксис:

Примеры:

Флаг --no-startup-id объяснён в [exec].

Если вы привязываете клиентов к рабочим пространствам, может быть полезно размещать рабочие пространства на определённых экранах. Кроме того, размещение рабочих пространств на экранах определяет, какое рабочее пространство i3 использует для нового экрана при добавлении экранов или запуске (например, по умолчанию он будет использовать 1 для первого экрана, 2 для второго и так далее).

Синтаксис:

output — это имя объекта RandR вывода, к которому вы прикрепляете свой экран. На ноутбуке у вас могут быть выводы VGA1 и LVDS1. Вы можете увидеть доступные выводы, выполнив команду xrandr --current.

Если ваш сервер X поддерживает RandR 1.5 или более позднюю версию, i3 будет использовать объекты мониторов RandR вместо объектов вывода. Выведите список с помощью xrandr --listmonitors. Как правило, объект монитора содержит ровно один вывод и имеет то же имя, что и вывод; но если это не так, вы можете указать имя монитора или вывода в конфигурации i3. Например, Dell UP2414Q использует два внутренних преобразователя, поэтому его имена вывода могут быть «DP1» и «DP2», но имя монитора — «Dell UP2414Q».

(Обратите внимание, что даже если вы укажете имя вывода, которое не охватывает весь монитор, i3 всё равно будет использовать всю область содержащего монитора, а не только область вывода.)

Вы можете указать несколько выводов. Будет использован первый доступный.

Если вы используете именованные рабочие пространства, их нужно заключить в кавычки.

Примеры:

Можно изменить все цвета, которые i3 использует для рисования декораций окна.

Синтаксис:

Где colorclass может быть одним из следующих:

Цвета в формате HTML (шестнадцатеричном формате #rrggbb, необязательно #rrggbbaa), см. пример ниже:

Примеры (значения по умолчанию):

Обратите внимание, что для декораций окна цвет вокруг дочернего окна — это «child_border», а цвет «border» — только две тонкие линии вокруг заголовка.

Цвет индикатора используется для обозначения места открытия нового окна. Для горизонтальных контейнеров разделения по горизонтали правая граница будет окрашиваться в цвет индикатора, для вертикальных контейнеров — нижняя граница. Это относится только к отдельным окнам внутри контейнера разделения, которые в противном случае неотличимы от отдельных окон вне контейнера разделения.

i3 использует сокеты Unix для предоставления интерфейса IPC. Это позволяет сторонним программам получать информацию от i3, такую как текущие рабочие пространства (для отображения панели рабочих пространств) и управлять i3.

По умолчанию сокет IPC будет создан в $XDG_RUNTIME_DIR/i3/ipc-socket.%p, если каталог доступен, в противном случае по умолчанию в /tmp/i3-%u.XXXXXX/ipc-socket.%p, где %u — ваш имя пользователя в Unix, %p — PID i3, а XXXXXX — строка случайных символов из набора допустимых символов для имён файлов (см. mkdtemp(3)).

Вы можете переопределить путь по умолчанию через переменную среды I3SOCK или путём указания директивы ipc-socket. Это не рекомендуется, так как i3 делает правильный выбор по умолчанию. Если вы всё же решите его изменить, настоятельно рекомендуется установить его в расположении в вашей домашней директории, чтобы другие пользователи не могли создать этот каталог.

Примеры:

Затем вы можете использовать приложение i3-msg для выполнения любой команды, перечисленной в [list_of_commands].

По умолчанию, фокус окна следует за перемещениями мыши, когда курсор пересекает границы окна. Однако, если у вас есть конфигурация, где ваша мышь часто находится на пути (например, тачпад на вашем ноутбуке, который вы не хотите полностью отключать), вы можете отключить слежение фокуса за мышью и управлять фокусом только с помощью клавиатуры. Мышь по-прежнему будет полезна внутри активного окна (например, для нажатия на ссылки в окне браузера).

Синтаксис:

Пример:

По умолчанию, при переключении фокуса на окно на другом выводе (например, фокусировка окна на рабочем столе 3 на выводе VGA-1, приходящем с рабочего стола 2 на LVDS-1), курсор мыши перемещается в центр этого окна.

С помощью параметра mouse_warping вы можете управлять, когда следует перемещать курсор мыши. none полностью отключает перемещение, в то время как output — это стандартное поведение, описанное выше.

Синтаксис:

Пример:

Когда вы находитесь в полноэкранном режиме, некоторые приложения всё ещё открывают всплывающие окна (например, Xpdf). Это связано с тем, что эти приложения могут не знать, что они находятся в полноэкранном режиме (они не проверяют соответствующий признак). i3 поддерживает четыре варианта для этой ситуации:

Синтаксис:

Пример:

По умолчанию, при работе в контейнере с несколькими окнами или дочерними контейнерами, фокус переключается на противоположное окно при попытке переместить фокус за край контейнера (если в этом направлении нет других контейнеров) — фокус переносится.

При необходимости, можно отключить это поведение, установив директиву конфигурации focus_wrapping в значение no.

Если включено, переключение фокуса не происходит по умолчанию, если в указанном направлении есть другое окно или контейнер, вместо этого фокус будет установлен на это окно или контейнер. Это стандартное поведение, так что вы можете перемещаться по всем вашим окнам, не прибегая к использованию focus parent.

Если вы хотите, чтобы фокус всегда переключался и знаете, что используете focus parent для переключения между различными контейнерами, вы можете установить focus_wrapping в значение force.

Чтобы ограничить фокус текущим рабочим столом, установите focus_wrapping в значение workspace. Вам нужно будет использовать focus parent, пока рабочий стол не будет выбран, чтобы переключаться на другой рабочий стол с помощью команд фокуса (команда workspace всё ещё будет работать как ожидается).

Синтаксис:

Примеры:

Как подробно описано в https://i3wm.org/docs/multi-monitor.html, некоторые драйверы видео X11 (особенно двоичный драйвер nVidia) поддерживают только Xinerama, а не RandR. В такой ситуации i3 необходимо явно указать использовать менее совершенный API Xinerama, и поэтому не предоставляет поддержку переконфигурации экранов на лету (они считываются только один раз при запуске и всё).

Для пользователей, которые не могут изменить ~/.xsession для добавления параметра командной строки --force-xinerama, предоставляется параметр конфигурации:

Синтаксис:

Пример:

Также обратите внимание, что имена ваших выводов не являются описательными (например, HDMI1) при использовании Xinerama, а вместо этого нумеруются, начиная с 0: xinerama-0, xinerama-1, …

Эта директива конфигурации включает автоматическое workspace back_and_forth (см. [back_and_forth]) при переключении на рабочий стол, который в данный момент активен.

Например: Предположим, вы находитесь на рабочем столе "1: www" и переключаетесь на "2: IM" с помощью mod+2, потому что вам пришло сообщение. Вам не нужно помнить, откуда вы пришли, теперь вы можете просто нажать $mod+2 снова, чтобы вернуться на "1: www".

Синтаксис:

Пример:

Если приложение на другом рабочем столе устанавливает подсказку срочности, переход на этот рабочий стол может привести к немедленному фокусированию приложения, что также означает, что цвет декорации окна будет немедленно сброшен на client.focused. Это может сделать необоснованно сложным определить, какое окно первоначально вызвало событие.

Для предотвращения этого, вы можете указать i3 задерживать сброс состояния срочности на определённое время, используя директиву force_display_urgency_hint. Установка значения 0 отключает эту функцию.

Значение по умолчанию — 500 миллисекунд.

Синтаксис:

Пример:

Если окно активируется, например, с помощью google-chrome www.google.com, оно может запросить фокус. Поскольку это может быть нежелательным, можно настроить различные реакции.

Обратите внимание, что это может не повлиять на окна, которые открываются. Чтобы предотвратить фокусировку новых окон, см. [no_focus].

Синтаксис:

Различные режимы будут действовать следующим образом:

Если активировано, метки (см. [vim_like_marks]) на окнах отображаются в их декоре. Однако любая метка, начинающаяся с нижнего подчеркивания (_) в своём имени, не будет отображаться, даже если этот параметр активирован.

Значение по умолчанию для этого параметра — yes.

Синтаксис:

Пример:

Файлы конфигурации поддерживают продолжение строк, означающее, что при окончании строки символом обратного слэша (\), перевод строки будет проигнорирован парсером. Эта функция может быть использована для создания более читаемых файлов конфигурации. Комментируемые строки не продолжаются.

Примеры:

Вы можете настроить, как инициировать функцию перетаскивания в режиме укладки (см. [tiling_drag]).

По умолчанию — modifier.

Начиная с i3 4.24, вы можете настроить модификаторную клавишу, которая при нажатии будет переключать, а не перемещать контейнеры при непосредственном опускании на другой контейнер. По умолчанию — Shift. Обратите внимание, что вы должны удерживать и клавишу плавающего режима, и клавишу переключения перед началом перетаскивания.

Синтаксис:

Примеры:

Начиная с i3 4.22, вы можете настроить промежутки между окнами. «Промежутки» — это добавленное расстояние между окнами (или разделительными контейнерами) и краями экрана:

Вы можете настроить два типа промежутков:

Если вы знакомы с HTML и CSS, вы можете представить внутренние промежутки как padding, а внешние промежутки как margin, применённые к <div> вокруг вашего окна или разделительного контейнера.

Обратите внимание, что внешние промежутки добавляются к внутренним, то есть общий размер промежутка между краем экрана и окном (или разделительным контейнером) будет суммой внешних и внутренних промежутков.

Вы можете определить промежутки глобально или на рабочем пространстве, используя следующий синтаксис.

Синтаксис:

Внешние промежутки можно настроить для каждого направления индивидуально с помощью директив top, left, bottom и right. horizontal и vertical — это сокращения для left/right и top/bottom соответственно.

Пример:

Подсказка: Промежутки можно дополнительно изменить во время выполнения с помощью команды gaps, см. [changing_gaps].

Подсказка: Вы можете найти пример конфигурации здесь, которая использует режимы для демонстрации различных конфигураций промежутков.

По умолчанию i3 просто передаст i3bar и позволит вашей оболочке обработать выполнение, выполнив поиск правильной версии в $PATH. Если у вас где-то другой i3bar или бинарный файл отсутствует в $PATH, вы можете указать i3, что нужно выполнить.

Указанная команда будет передана sh -c, поэтому вы можете использовать подстановку шаблонов и должны правильно указывать кавычки и т. д.

Синтаксис:

Пример:

i3bar может запускать программу и отображать каждую строку ее вывода stdout в правой части панели. Это полезно для отображения системной информации, такой как ваш текущий IP-адрес, состояние батареи или дата/время.

Указанная команда будет передана sh -c, поэтому вы можете использовать подстановку шаблонов и должны правильно указывать кавычки и т. д. Обратите внимание, что для обработки сигналов, в зависимости от вашей оболочки (пользователи оболочки dash(1) известны тем, что подвержены влиянию), вы должны использовать команду exec оболочки, чтобы сигналы передавались вашей программе, а не оболочке.

Синтаксис:

Пример:

Начиная с i3 4.23, i3bar может запускать программу и использовать ее вывод stdout для определения кнопок рабочих пространств, отображаемых в левой части панели. С помощью этой функции, например, вы можете переименовать кнопки рабочих пространств, скрыть определенные рабочие пространства, всегда показывать кнопку рабочего пространства, даже если рабочее пространство не существует, или изменить порядок кнопок.

Также см. [status_command] для параметра statusline и https://i3wm.org/docs/i3bar-workspace-protocol.html для подробного протокола.

Синтаксис:

Пример:

Вы можете либо постоянно отображать i3bar на одном краю экрана (режим «панель»), либо делать его видимым при нажатии клавиши модификатора (режим «скрывать»). Также можно заставить i3bar всегда оставаться скрытым (режим «невидимый»). Клавиша модификатора может быть настроена с помощью параметра modifier.

Параметр режима может быть изменён во время выполнения с помощью команды bar mode. При перезагрузке режим будет возвращён к своему настроенному значению.

Режим «скрывать» максимизирует пространство экрана, которое может быть использовано для фактических окон. Когда панель скрыта, i3bar отправляет сигналы SIGSTOP и SIGCONT процессу status_command для экономии заряда батареи. Эта функция может быть отключена процессом status_command путём установки соответствующих значений в его сообщении заголовка JSON.

Режим «невидимый» позволяет постоянно максимизировать пространство экрана, так как панель никогда не отображается. Таким образом, вы можете настроить i3bar так, чтобы он не беспокоил вас, появляясь из-за подсказки срочности или из-за нажатия клавиши модификатора.

Для управления скрытием или отображением i3bar в режиме «скрывать» существует параметр hidden_state, который не имеет эффекта в режиме «панель» или «невидимый». Он указывает текущее состояние скрытия панели: (1) Панель ведет себя как в обычном режиме «скрывать», она скрыта и отображается только в случае подсказок срочности или при нажатии клавиши модификатора (состояние «hide»), или (2) она отображается поверх текущего видимого рабочего пространства (состояние «show»).

Как и режим, состояние hidden_state также может быть контролировано через i3, это можно сделать с помощью команды bar hidden_state.

По умолчанию используется режим «панель»; в режиме «скрывать» клавишей модификатора по умолчанию является Mod4 (обычно клавиша Windows). Значение по умолчанию для hidden_state — hide.

Синтаксис:

Пример:

Доступные модификаторы — Mod1-Mod5, Shift, Control (см. xmodmap(1)). Вы также можете использовать «none», если не хотите, чтобы какое-либо действие модификатора вызывало это поведение.

Указывает команду для выполнения при нажатии кнопки на i3bar, чтобы переопределить стандартное поведение. Это полезно, например, для отключения действия колесика мыши или запуска скриптов, которые реализуют пользовательское поведение для этих кнопок.

Кнопка всегда называется button<n>, где 1-5 — это стандартные кнопки, как указано ниже, а более высокие числа могут быть специальными кнопками на устройствах с большим количеством кнопок:

Обратите внимание, что старые команды wheel_up_cmd и wheel_down_cmd устарели и будут удалены в будущей версии. Мы настоятельно рекомендуем использовать более универсальную команду bindsym с button4 и button5 вместо этого.

Синтаксис:

Пример:

Указывает ID панели для настроенного экземпляра панели. Если этот параметр отсутствует, ID устанавливается в bar-x, где x соответствует позиции встраиваемого блока панели в файле конфигурации (bar-0, bar-1, …).

Синтаксис:

Пример:

Этот параметр определяет, на каком краю экрана i3bar должен отображаться.

По умолчанию — снизу.

Синтаксис:

Пример:

Вы можете ограничить i3bar одним или несколькими выходами (мониторами). По умолчанию обрабатываются все выходы. Ограничение выходов полезно для использования разных параметров для разных выходов, используя несколько блоков bar.

Чтобы сделать определённый экземпляр i3bar обработчиком нескольких выходов, укажите директиву output несколько раз.

Эти имена выходов имеют специальное значение:

Синтаксис:

Пример:

Обратите внимание, что у вас может ещё не быть основного выхода. Чтобы его создать, выполните:

i3bar по умолчанию предоставляет область системного трея, где программы, такие как NetworkManager, VLC, Pidgin и т. д., могут размещать маленькие значки.

Вы можете настроить, на каком выводе (мониторе) должны отображаться значки, или полностью отключить эту функцию.

Вы можете использовать несколько директив tray_output в своей конфигурации, чтобы указать список выводов, на которых должен отображаться трей. Первый доступный вывод в этом списке, как определено порядком директив, будет использован для вывода трея.

Синтаксис:

Пример:

Обратите внимание, что у вас может еще не быть основного вывода. Для его настройки выполните:

Обратите внимание, что при использовании нескольких блоков конфигурации панели, необходимо указать tray_output primary во всех из них или явно указать tray_output none в панелях, которые не должны отображать трей, в противном случае разные экземпляры могут конкурировать друг с другом при попытке отобразить значки трея.

Трей отображается справа от панели. По умолчанию используются отступы в 2 пикселя для верхней, нижней и правой стороны области трея и между отдельными значками.

Синтаксис:

Пример:

Указывает шрифт, который будет использоваться в панели. См. [шрифты].

Синтаксис:

Пример:

Указывает пользовательский символ, который будет использоваться для разделителя, в отличие от вертикального разделителя толщиной один пиксель.

Синтаксис:

Пример:

Указывает, должны ли отображаться кнопки рабочих пространств или нет. Это полезно, если вы хотите отобразить только панель состояния, содержащую дополнительную информацию.

По умолчанию кнопки рабочих пространств отображаются.

Синтаксис:

Пример:

По умолчанию ширина кнопки рабочего пространства определяется шириной текста, отображающего имя рабочего пространства. Если имя слишком короткое (например, одна буква), то кнопка рабочего пространства может выглядеть слишком маленькой.

Этот параметр задает минимальную ширину для кнопок рабочих пространств. Если имя рабочего пространства слишком короткое, чтобы покрыть кнопку, с обеих сторон кнопки добавляется дополнительный отступ, чтобы текст был центрирован.

Значение по умолчанию ноль означает, что дополнительный отступ не добавляется.

Настройка также применяется к индикатору текущего режима связывания.

Обратите внимание, что указанные пиксели относятся к логическим пикселям, которые могут переводиться в большее количество пикселей на дисплеях с высокой плотностью пикселей.

Синтаксис:

Пример:

Указывает, должны ли отображаться номера рабочих пространств в кнопках рабочих пространств. Это полезно, если вы хотите иметь именованное рабочее пространство, которое сохраняется в порядке на панели в соответствии с его номером без отображения префикса номера.

Когда strip_workspace_numbers установлено в yes, любое рабочее пространство, имеющее имя в формате "[n][:][NAME]", будет отображать только имя. Например, вы можете использовать это, чтобы отобразить римские цифры вместо цифр, присвоив своим рабочим пространствам имена "1:I", "2:II", "3:III", "4:IV" и т. д.

Когда strip_workspace_name установлено в yes, любое рабочее пространство, имеющее имя в формате "[n][:][NAME]", будет отображать только номер.

По умолчанию отображается полное имя в кнопке рабочего пространства. Обратите внимание, что двоеточие в имени рабочего пространства является необязательным, поэтому [n][NAME] также будет корректно удалять имя и номер рабочего пространства.

Синтаксис:

Пример:

Указывает, должен ли отображаться индикатор текущего режима связывания. Это полезно, если вы хотите скрыть кнопки рабочих пространств, но по-прежнему иметь возможность видеть индикатор текущего режима связывания. См. [режимы_связывания], чтобы узнать, что такое режимы и как их использовать.

По умолчанию индикатор режима отображается.

Синтаксис:

Пример:

Как и в i3, цвета указаны в формате HTML (шестнадцатеричном формате #rrggbb, необязательно #rrggbbaa). На данный момент можно настроить следующие цвета:

Синтаксис:

Пример (стандартные цвета):

i3bar может поддерживать прозрачность, передавая флаг --transparency в конфигурации:

Синтаксис:

В конфигурации цветов i3bar и атрибуте цвета блока состояния i3bar вы можете затем использовать цвета в формате RGBA, т. е. последние две (шестнадцатеричные) цифры указывают на непрозрачность. Например, #00000000 будет полностью прозрачным, а #000000FF — полностью непрозрачным черным (так же, как #000000).

Обратите внимание, что из-за того, как работает спецификация трея, включение этого флага приведет к тому, что все значки трея будут иметь прозрачный фон.

Чтобы сделать i3bar выше (не увеличивая размер шрифта) и/или добавить отступы слева и справа от i3bar, можно использовать директиву padding:

Синтаксис:

Примеры:

Примечание: для удобства пользователей, мигрирующих из i3-gaps в i3, директива height из i3-gaps поддерживается i3, но должна быть изменена на padding.

Что толку от менеджера окон, если вы не можете запускать приложения? Команда exec запускает приложение, передавая команду, которую вы указали, в оболочку. Это означает, что вы можете использовать подстановку (метасимволы), и программы будут искать в переменной среды $PATH.

См. [command_chaining] для получения дополнительной информации о специальном значении ; (точка с запятой) и , (запятая): они объединяют команды в i3, поэтому вам необходимо использовать строковые значения в кавычках (как показано в [exec_quoting]), если они встречаются в вашей команде.

Синтаксис:

Пример:

Параметр --no-startup-id отключает поддержку уведомлений о запуске для этой конкретной команды exec. С помощью уведомлений о запуске i3 может убедиться, что окно появляется на том рабочем столе, на котором вы выполнили команду exec. Кроме того, он изменит курсор X11 на watch (часы) во время запуска приложения. Таким образом, если приложение не поддерживает уведомления о запуске (хотя большинство приложений, использующих GTK и Qt, кажутся такими), вы получите курсор часов на 60 секунд.

Если выполняемая команда содержит ; (точку с запятой) и/или , (запятую), вся команда должна быть заключена в кавычки. Например, чтобы создать сочетание клавиш для команды оболочки notify-send Hello, i3, вы бы добавили запись в свой конфигурационный файл следующим образом:

Пример:

Однако, если сама команда с запятой и/или точкой с запятой требует кавычек, внутренние кавычки необходимо экранировать двойными обратными слешами, как в этом примере:

Пример:

Команда split делает текущее окно контейнером с разделением. Контейнеры с разделением могут содержать несколько окон. В зависимости от макета контейнера с разделением новые окна размещаются справа от текущего (splith) или под текущим (splitv).

Если вы применяете эту команду к контейнеру с разделением с той же ориентацией, ничего не произойдёт. Если вы используете другую ориентацию, ориентация контейнера с разделением будет изменена (если в нём не более одного окна). Опция toggle переключает ориентацию контейнера с разделением, если он содержит одно окно. В противном случае она делает текущее окно контейнером с разделением с ориентацией, противоположной ориентации родительского контейнера. Используйте layout toggle split для изменения макета любого контейнера с разделением с splitv на splith или наоборот. Вы также можете определить собственную последовательность макетов для циклического перехода с помощью layout toggle, см. [manipulating_layout].

Синтаксис:

Пример:

Используйте layout toggle split, layout stacking, layout tabbed, layout splitv или layout splith для изменения текущего макета контейнера на splith/splitv, stacking, tabbed, splitv или splith соответственно.

Укажите до четырёх макетов после layout toggle для циклического перехода по ним. При каждом выполнении команды будет применяться макет, указанный после текущего активного. Если текущий активный макет не в списке, будет активирован первый макет в списке.

Чтобы сделать текущее окно (!) полноэкранным, используйте fullscreen enable (или fullscreen enable global для глобального режима), чтобы выйти из полноэкранного режима, используйте fullscreen disable, и чтобы переключаться между этими состояниями, используйте fullscreen toggle (или fullscreen toggle global).

Аналогично, чтобы сделать текущее окно плавающим (или снова с размещением), используйте floating enable соответственно floating disable (или floating toggle):

Синтаксис:

Примеры:

Для изменения фокуса вы можете использовать команду focus. Доступны следующие опции:

Синтаксис:

Примеры:

Обратите внимание, что у вас может ещё не быть основного вывода. Для его настройки выполните:

Используйте команду move для перемещения контейнера.

Синтаксис:

Примеры:

Два контейнера можно поменять местами (т.е. переместить их в позицию друг друга) с помощью команды swap. Они примут позицию и геометрию контейнера, с которым произошла замена.

Первый контейнер для обмена можно выбрать, используя стандартный процесс критериев команды, а если нет критериев, то по умолчанию используется сфокусированное окно. Второй контейнер можно выбрать одним из следующих способов:

Обратите внимание, что обмен не работает со всеми контейнерами. В частности, обмен контейнеров, имеющих родительско-дочерние отношения, невозможен.

Синтаксис:

Примеры:

Если вы хотите, чтобы окно прилипало к экрану, т.е. оставалось на экране, даже если вы переключаетесь на другой рабочий стол, вы можете использовать команду sticky. Например, это может быть полезно для заметок, медиаплеера или окна видеочата.

Обратите внимание, что, хотя любое окно можно сделать прилипающим с помощью этой команды, это произойдёт только если окно плавающее.

Синтаксис:

Примеры:

Для перехода на определённый рабочий стол используйте команду workspace и номер или имя рабочего стола. Передайте необязательный флаг --no-auto-back-and-forth для отключения [workspace_auto_back_and_forth] только для этого вызова.

Для перемещения контейнеров на определённые рабочие столы используйте move container to workspace.

Вы также можете переключаться на следующий и предыдущий рабочий стол с помощью команд workspace next и workspace prev, что удобно, например, если у вас рабочие столы 1, 3, 4 и 9, и вы хотите прокручивать их с помощью одной комбинации клавиш. Чтобы ограничить их текущим выводом, используйте workspace next_on_output и workspace prev_on_output. Аналогично, вы можете использовать move container to workspace next, move container to workspace prev для перемещения контейнера на следующий/предыдущий рабочий стол и move container to workspace current (последняя команда имеет смысл только при использовании с критериями).

workspace next циклически перебирает пронумерованные или именованные рабочие столы. Но когда он достигает последнего пронумерованного/именованного рабочего стола, он ищет именованные рабочие столы после исчерпания пронумерованных и ищет пронумерованные после исчерпания именованных.

См. [move_to_outputs] для перемещения контейнера/рабочего стола на другой экран RandR.

Имена рабочих столов анализируются как Pango разметка i3bar.

Чтобы вернуться к ранее сфокусированному рабочему столу, используйте workspace back_and_forth, аналогично, вы можете переместить контейнеры на ранее сфокусированный рабочий стол с помощью move container to workspace back_and_forth.

Синтаксис:

Примеры:

См. [move_to_outputs] для перемещения контейнера/рабочего стола на другой экран RandR.

Для перемещения контейнера на другой выход RandR (адресуемый именами, такими как LVDS1 или VGA1), или на выход RandR, определяемый конкретным направлением (таким как left, right, up или down), существуют две команды:

Синтаксис:

Примеры:

Если вы указываете более одного выхода, контейнер/рабочее пространство циклически переключается между ними: если оно уже находится на одном из выходов в списке, оно переместится на следующий выход в списке. Если оно находится на выходе, не указанном в списке, оно переместится на первый указанный выход. Несуществующие выходы пропускаются.

Обратите внимание, что у вас может пока не быть настроенного первичного выхода. Для этого выполните:

Для перемещения контейнера в другой контейнер с определённой меткой (см. [vim_like_marks]), можно использовать следующую команду.

Окно будет перемещено сразу после помеченного контейнера в дереве, т.е. оно окажется в том же положении, как если бы вы открыли новое окно, когда помеченный контейнер был фокусирован. Если метка находится на разделительном контейнере, окно появится как новый дочерний элемент после текущего фокусированного дочернего элемента в этом контейнере.

Синтаксис:

Пример:

Если вы хотите изменить размер контейнеров/окон с помощью клавиатуры, вы можете использовать команду resize:

Синтаксис:

Направление может быть одним из up, down, left или right. Или вы можете быть менее конкретны и использовать width или height, в этом случае i3 возьмёт/отдаст место у других контейнеров. Необязательный аргумент пикселей указывает, на сколько пикселей контейнер должен быть увеличен или уменьшен (по умолчанию 10 пикселей). Необязательный аргумент ppt означает «процентные пункты», и если он указан, он указывает, что контейнер с выкладкой должен быть увеличен или уменьшен на это количество пунктов, а не на значение px.

Примечание по resize set: значение 0 для <width> или <height> означает «не изменять размер в этом направлении».

Рекомендуется определить привязки для изменения размера в отдельном режиме привязки. См. [binding_modes] и пример в стандартной конфигурации i3 для получения дополнительной информации.

Пример:

Часто в многомониторной среде вам нужно быстро перейти к определённому окну. Например, работая на рабочем пространстве 3, вы можете захотеть перейти к своему почтовому клиенту, чтобы написать своему боссу, что вы достигли важной цели. Вместо того, чтобы разбираться, как перейти к вашему почтовому клиенту, было бы удобнее иметь ярлык. Вы можете использовать команду focus с критериями для этого.

Синтаксис:

Примеры:

Эта функция похожа на функцию перехода: она позволяет вам напрямую перейти к определённому окну (это означает переключение на соответствующее рабочее пространство и установка фокуса на окна). Однако вы можете напрямую отметить определённое окно произвольным ярлыком и использовать его в дальнейшем. Вы можете удалить ярлык аналогичным образом, используя команду unmark. Если вы не указываете ярлык, unmark удаляет все метки. Вам не нужно гарантировать, что ваши окна имеют уникальные классы или заголовки, и вам не нужно изменять файл конфигурации.

Поскольку команда должна включать ярлык, с помощью которого вы хотите отметить окно, вы не можете просто привязать её к клавише. i3-input — это инструмент, созданный для этой цели: он позволяет ввести команду и отправляет её в i3. Он также может префикс этой команды и отобразить пользовательский запрос для диалога ввода.

Дополнительный параметр --toggle удалит метку, если окно уже имеет эту метку, или добавит её в противном случае. Обратите внимание, что вам может потребоваться использовать его в сочетании с --add (см. ниже), так как любые другие метки в противном случае будут удалены.

Флаг --replace заставляет i3 удалить все существующие метки, что также является стандартным поведением. Вы можете использовать флаг --add, чтобы добавить на окно более одной метки.

См. [show_marks], если вы не хотите отображать метки в декоре окна.

Синтаксис:

Вы можете использовать i3-input для запроса имени метки, а затем использовать команды mark и focus для создания и перехода к пользовательским меткам:

Примеры:

В качестве альтернативы, если вы не хотите работать с i3-input, вы можете создать отдельные привязки для определённого набора ярлыков и использовать только эти ярлыки:

Пример (в терминале):

По умолчанию i3 просто выведет заголовок окна X11. С помощью title_format это можно настроить, установив формат в соответствии с желаемым выводом. Эта директива поддерживает разметку Pango и следующие плейсхолдеры, которые будут заменены:

Используя директиву [for_window], вы можете установить формат заголовка для любого окна на основе [command_criteria].

Синтаксис:

Примеры:

По умолчанию i3 не отображает значок окна в строке заголовка.

Начиная с i3 v4.20, вы можете по желанию включить значки окон либо для определённых окон, либо для всех окон (используя директиву [for_window]).

Синтаксис:

Примеры:

Чтобы изменить рамку текущего клиента, вы можете использовать border normal для использования обычной рамки (включая заголовок окна), border pixel 1 для использования рамки толщиной 1 пиксель (без заголовка окна) и border none для того, чтобы сделать клиент безрамочным.

Также есть border toggle, который будет переключать различные стили рамок. Необязательный аргумент пикселей можно использовать для указания ширины рамки при переключении на обычные и пиксельные стили.

Обратите внимание, что «пиксель» относится к логическому пикселю. На HiDPI-дисплеях логический пиксель представлен несколькими физическими пикселями, поэтому pixel 1 может не обязательно переводиться в рамку толщиной в один физический пиксель.

Синтаксис:

Примеры:

Чтобы изменить значение по умолчанию для всех окон, см. директиву [default_border].

Как описано в https://i3wm.org/docs/debugging.html, i3 может вести журнал в буфере общей памяти, который вы можете выгрузить с помощью i3-dump-log. Команда shmlog позволяет включать или отключать ведение журнала в общей памяти во время выполнения.

Обратите внимание, что при использовании shmlog <size_in_bytes> текущий журнал будет удалён, и будет начат новый.

Синтаксис:

Примеры:

Команда debuglog позволяет включить или отключить отладку логирования во время выполнения. Отладка логирования гораздо более подробна, чем обычное логирование. Эта команда не активирует логирование с общей памятью (shmlog), и поэтому, скорее всего, полезна в сочетании с описанной выше командой [shmlog].

Синтаксис:

Примеры:

Вы можете перегрузить файл конфигурации i3 с помощью команды reload. Также вы можете перезапустить i3 на месте с помощью команды restart, чтобы вывести его из какого-то странного состояния (если такое случится) или выполнить обновление без перезагрузки вашей сессии X. Для правильного выхода из i3 можно использовать команду exit, но это не обязательно (достаточно просто убить вашу сессию X).

Примеры:

Есть две команды для использования любого существующего окна как окна блокнота. move scratchpad переместит окно на рабочее пространство блокнота. Это сделает его невидимым до тех пор, пока вы его снова не покажете. Нет способа открыть это рабочее пространство. Вместо этого, при использовании scratchpad show, окно будет показано снова как плавающее окно, центрированное на текущем рабочем пространстве (использование scratchpad show с видимым окном блокнота сделает его невидимым снова, поэтому у вас может быть сочетание клавиш для переключения). Обратите внимание, что это просто обычное плавающее окно, поэтому, если вы хотите «убрать его из блокнота», вы можете просто сделать его снова прикрепленным к рабочему пространству (floating toggle).

Как следует из названия, это полезно для того, чтобы окно с вашим любимым редактором всегда было под рукой. Однако вы также можете использовать это для других постоянно работающих приложений, которые вы не хотите видеть всё время: ваш музыкальный проигрыватель, alsamixer, возможно, даже ваш почтовый клиент…?

Синтаксис:

Примеры:

Есть команда без операции nop, которая позволяет переопределить стандартное поведение. Это может быть полезно, например, для отключения изменения фокуса при щелчке средней кнопкой мыши.

Необязательный аргумент comment игнорируется, но будет напечатан в файл журнала для отладки.

Синтаксис:

Пример:

Есть две опции в конфигурации каждого экземпляра i3bar, которые можно изменить во время выполнения, вызвав команду через i3. Команды bar hidden_state и bar mode позволяют установить текущие значения опций hidden_state соответственно mode каждого бара. Также возможно переключаться между состоянием скрытия и отображения, а также между режимом док-станции и скрытым режимом. Каждый экземпляр i3bar можно контролировать индивидуально, указав идентификатор бара; если он не указан, команда выполняется для всех экземпляров баров.

Синтаксис:

Примеры:

Отступы можно изменить во время выполнения с помощью следующего синтаксиса команды:

Синтаксис:

С помощью current или all вы можете изменить отступы либо только для текущего фокусированного, либо для всех существующих рабочих пространств (обратите внимание, что это не влияет на глобальную конфигурацию).

Примеры:

Чтобы изменить отступы для всех окон, см. директиву конфигурации [gaps].