[Из песочницы] Awesome tasklist

На Wiki, к сожалению, очень мало информации по настройке оконного менеджера Awesome. Поэтому решил внести свои пять копеек в популяризацию этого замечательного WM. В этой статье разбираем панель задач.Панель задач — отображает по умолчанию клиенты с активного тега/тегов.Перед началом работы скопируйте библиотеки в домашний каталог, если до сих пор этого не сделали.

mkdir -p ~/.config/awesome/themes cp /etc/xdg/awesome/rc.lua ~/.config/awesome/rc.lua cp -R /usr/share/awesome/lib/* ~/.config/awesome/ cp -R /usr/share/awesome/themes/* ~/.config/awesome/themes/ Вообще, за обработку панели задач отвечает файл awful/widget/tasklist.lua.

Так что если возникнет желание ознакомится со всеми возможностями панели задач, изучите этот файл. Также для работы этого файла потребуются другие библиотеки lua (вызываемые оттуда функции и т.д.), они прописаны в начале файла, это те самые require. Имейте в виду, что код для 3.4 и 3.5 в библиотеке tasklist, как и названия функций в них довольно существенно отличается.

Управление списком задач Для управления открытми клиентами существуют следующие клавиши: Mod4 + Shift + r — Перерисовать активное окно.Mod4 + m — Развернуть на весь экран.Mod4 + n — Свернуть.Mod4 + Control + n — Восстановить.Mod4 + f — Полноэкранный режим.Mod4 + Shift + c — Убить выбранный клиент.Mod4 + t — Прикрепить поверх всех.

Кстати, если эти клавиши вас не устравивают, вы в любой момент можете их переопределить, для этого в rc.lua найдите функцию awful.key отвечающую за нужные вам клавиши и измените их.

Разбираем rc.lua Разбирая rc.lua можно обнаружить следующий код, связанный с панелью задач: mytasklist = {} --создаем таблицу панели задач mytasklist.buttons = awful.util.table.join (--прикрепляем клавиши мыши к панели задач awful.button ({ }, 1, function © --нажатие левой кнопки if c == client.focus then --свернуть/развернуть приложение c.minimized = true else  — Without this, the following  — : isvisible () makes no sense c.minimized = false if not c: isvisible () then awful.tag.viewonly (c: tags ()[1]) end  — This will also un-minimize  — the client, if needed client.focus = c c: raise () end end), awful.button ({ }, 3, function () --нажатие правой клавиши if instance then --отображает список всех клиентов/приложений instance: hide () instance = nil else instance = awful.menu.clients ({ theme = { width = 250 } }) end end), awful.button ({ }, 4, function () --колесо прокрутки awful.client.focus.byidx (1) --перейти на следующий клиент if client.focus then client.focus: raise () end end), awful.button ({ }, 5, function () --колесо прокрутки awful.client.focus.byidx (-1) --перейти на предыдущий клиент if client.focus then client.focus: raise () end end)) …  — Create a tasklist widget — создание виджета tasklist mytasklist[s] = awful.widget.tasklist (s, awful.widget.tasklist.filter.currenttags, mytasklist.buttons) … layout: set_middle (mytasklist[s]) --Располагаем список задач в центре панели Если вам не нужна прокрутка на панели задач, то закоментируйте/удалите код, отвечающий за нее:

--awful.button ({ }, 4, function () --колесо прокрутки  — awful.client.focus.byidx (1) --перейти на следующий клиент  — if client.focus then client.focus: raise () end  — end), --awful.button ({ }, 5, function () --колесо прокрутки  — awful.client.focus.byidx (-1) --перейти на предыдущий клиент  — if client.focus then client.focus: raise () end  — end)) --И добавьте завершающую скобку после закомментированного кода, иначе выдаст ошибку ) Варианты для правой кнопки мыши Закрыть приложение Для того, чтобы при нажатии правой кнопки мыши мы могли закрывать приложение (как в OpenBox или Tint2), а не открывать список меню, переделайте код (или закомментируйте его, если вы не планируете использовать правую клавишу для панели задач). awful.button ({ }, 3, function () if instance then instance: hide () instance = nil else instance = awful.menu.clients ({ theme = { width = 250 } }) end end), На следующий:

awful.button ({ }, 3, function © c: kill () end), Альтернативное меню 7ea9b6ae119b47f6b8e616ef1d611c61.pngЕсли вас не устраивает стандартное контекстное меню в панели задач, то вы можете его заменить, на то, которое нужно именно вам, далее приводится лишь один из возможных вариантов.

Для начала заменим стандартный вызов awful.button на следующий:

awful.button ({ }, 3, function © if instance then instance: hide () instance = nil else instance = context_menu© end end), Затем где нибудь в начале файла rc.lua добавьте функцию context_menu:

function context_menu© if c.minimized then --меняем текст элемента меню в зависимости от состояния cli_min = «Развернуть» else cli_min = «Свернуть» end if c.ontop then cli_top = »★ Поверх всех» else cli_top = » Поверх всех» end if awful.client.floating.get© then cli_float = »★ Floating» else cli_float = » Floating» end --создаем список тегов (в виде подменю), для перемещения клиента на другой тег tag_menu = { } for i, t in pairs (tags.names) do if not tags[c.screen][i].selected then --удаляем из списка выбранный тег/теги table.insert (tag_menu, { tostring (t), function () awful.client.movetotag (tags[c.screen][i]) end }) end end taskmenu = awful.menu ({ items = { { «Переместить на», tag_menu }, { cli_min, function () c.minimized = not c.minimized end }, { «Fullscreen», function () c.fullscreen = not c.fullscreen end, beautiful.layout_fullscreen }, { cli_float, function () awful.client.floating.toggle© end }, { cli_top, function () c.ontop = not c.ontop end }, { «Закрыть», function () c: kill () end }, width = 150 }) taskmenu: show () return taskmenu end Отобразить только иконки или текст Если вас не устраивает отображение текста и иконок одновременно (например вы большой любитель Unity или Win7), то можно настроить Awesome для отображения только иконок или только текста у приложений. Есть один недостаток, если для приложения не назначено иконки, то соответсвенно и отображать будет нечего (у меня такая ситуация наблюдалась с терминалом xterm, если у вас похожая ситуация, то назначьте иконку по умолчанию для приложений не имеющих собственных иконок (описано ниже).Откройте ~/.config/awesome/awful/widget/tasklist.lua и в функции widget_tasklist_label_common () (для 3.4) или tasklist_label (для 3.5)замените return text, bg… на следующий код:

return not theme.tasklist_only_icon and text or '', bg, status_image, not tasklist_disable_icon and c.icon or nil Затем, создайте переменную в вашем theme.lua со следующим содержанием: --для отображения только иконок theme.tasklist_only_icon = true --для отображения только текста tasklist_disable_icon = true Примечание: Не определяйте как одновременно обе этих переменных, иначе вы вообще не увидите своих задач.

010ec729bc0e43179c38cc19dd636b37.png

Есть еще один способ убрать текст в Awesome 3.4 (к сожалению в 3.5 код вызываемой функции был изменен и поэтому этот способ в нем не работает), но здесь все манипуляции мы будем производить только с файлом rc.lua. Найдите следующий код:

mytasklist[s] = awful.widget.tasklist (function© return awful.widget.tasklist.label.currenttags (c, s) end, mytasklist.buttons) И замените его на:

mytasklist[s] = awful.widget.tasklist (function© local task = { awful.widget.tasklist.label.currenttags (c, s) } return '', task[2], task[3], task[4] end, mytasklist.buttons) В принципе данный код аналогичен первому, только здесь мы производим дополнительное действие.

Аналогичным способом можно удалить и иконки в Awesome 3.4. Откройте ваш rc.lua, найдите:

mytasklist[s] = awful.widget.tasklist (function© return awful.widget.tasklist.label.currenttags (c, s) end, mytasklist.buttons) И замените его на:

mytasklist[s] = awful.widget.tasklist (function© local task = { awful.widget.tasklist.label.currenttags (c, s) } return task[1], task[2], task[3], nil end, mytasklist.buttons) Иконка по умолчанию Для некоторых приложений не установлены иконки по умочанию (обычно это терминалы), и если вы, например, используете только иконки в панели задач, или используете отображение приложений в тегах, то приложения без иконок вы просто не увидите. Для решения этой проблемы отредактируйте функцию tasklist_update в файле ~/.config/awesome/awful/widget/tasklist.lua. в функции tasklist_update перед строкой table.insert вставьте следующий код: if not c.icon then c.icon = capi.image («path/to/icon/default_icon.png») end Настройка внешнего вида Для настройки панели задач, в theme.lua вы можете определить следующие переменные: Awesome 3.5theme.tasklist_fg_normal — цвет текста панели задач, если значение не определено, то используется значение theme.fg_normaltheme.tasklist_bg_normal — цвет фона панели задач, если значение не определено, то используется значение theme.bg_normaltheme.tasklist_fg_focus — цвет текста активного приложения, если значение не определено, используется значение theme.fg_focustheme.tasklist_bg_focus — цвет фона активного приложения, если значение не определено, то используется значение theme.bg_focustheme.tasklist_fg_urgent — цвет текста «срочного» приложения, если не определено, то будет использоваться значение из theme.fg_urgenttheme.tasklist_bg_urgent — цвет фона «срочного» приложения, если не определено, то будет использоваться значение theme.bg_urgenttheme.tasklist_fg_minimize — цвет текста свернутого приложения, если не определено, то будет использоваться значение из theme.fg_minimizetheme.tasklist_bg_minimize — цвет фона свернутого приложения, если не определено, то будет использоваться значение из theme.bg_minimizetheme.bg_image_normal — позволяет установить изображение для неактивных в данный момент клиентовtheme.bg_image_focus — позволяет установить фоновое изображение для активного клиентаtheme.bg_image_urgent — позволяет установить фоновое изображения для «срочного» клиентаtheme.bg_image_minimize — позволяет установить фоновое изображение для свернутого клиентаtheme.tasklist_disable_icon — позволяет отключить отображение иконок, если значение равно true

theme.tasklist_font — шрифт для панели задач, если не определено, то будет испльзоватся шрифт из theme.font

Для следующих элементов можно использовать только символы (не иконки)theme.tasklist_sticky — позволяет установить текст для «липкого» клиента, если значение не установлено, то используется »▪«theme.tasklist_ontop — позволяет установить текст/символ для приложения «поверх всех», если значение не установлено, то используется '⌃'theme.tasklist_floating — текст для приложения в «плавающем» режиме, если значение не установлено, то используется '✈'theme.tasklist_maximized_horizontal — текст для развернутого по горизонтали приложения, если на установлено, то используется '⬌'theme.tasklist_maximized_vertical — текст для приложения развернутого по вертикали, если на установлено, то используется '⬍'

Awesome 3.4 Здесь возможностей по настройке намного меньше, это еще одна причина перейти на более новую версию.theme.tasklist_fg_focus — цвет текста активного приложения, если значение не определено, используется значение theme.fg_focustheme.tasklist_bg_focus — цвет фона активного приложения, если значение не определено, то используется значение theme.bg_focustheme.tasklist_fg_urgent — цвет текста «срочного» приложения, если не определено, то будет использоваться значение из theme.fg_urgenttheme.tasklist_bg_urgent — цвет фона «срочного» приложения, если не определено, то будет использоваться значение theme.bg_urgenttheme.tasklist_fg_minimize — цвет текста свернутого приложения, если не определено, то будет использоваться значение из theme.fg_minimizetheme.tasklist_bg_minimize — цвет фона свернутого приложения, если не определено, то будет использоваться значение из theme.bg_minimizetheme.tasklist_floating_icon — иконка для приложения в «плавающем» режимеtheme.tasklist_font — шрифт для панели задач, если не определено, то будет испльзоватся шрифт из theme.fontВысота панели Если вас не устраивает стандартная высота панели задач, то ее можно изменить, для этого найдите в rc.lua код отвечающий за создание контейнера mywibox и измените его следующим образом: mywibox[s] = awful.wibox ({ position = «top», height = 24, screen = s }) Здесь вы можете изменить ее расположение, top — сверху, bottom — снизу. height — это высота панели. Или даже можете создать себе вторую панель, переместив панель задач сверху вниз (на примере 3.4):

bottomwibox = {} bottomwibox[s] = awful.wibox ({ position = «bottom», height = 27, screen = s }) bottomwibox[s].widget = { { mylauncher, layout = awful.widget.layout.horizontal.leftright }, mytasklist[s], layout = awful.widget.layout.horizontal.rightleft } Порядок открытых приложений По умолчанию новое приложение отображается слева от открытых ранее. Но если вы привыкли к другому, например в Gnome или KDE, то можно настроить, чтобы вновь открываемые приложения открывались справа, т.е. список задач был отсортирован по запуску, где первым в списке будет первое открытое приложение, а последним соответственно последнее.Для этого необходимо открыть файл ~/.config/awesome/awful/widget/tasklist.lua. Все манипуляции с этими файлами лучше всего делать когда они находится в домашнем каталоге, чтобы если вы что-то испортите, можно было их легко восстановить.

Итак, найдите в этом файле функцию function tasklist_update в ней есть следующая строка:

Awesome 3.4

table.insert (shownclients, c) Замените ее на: table.insert (shownclients, 1, c) Awesome 3.5 table.insert (clients, c) Замените ее на: table.insert (clients, 1, c) Перезапустите Awesome.Ширина приложений в списке задач Если вас не устраивает, то, что одно запущенное приложение можент занимать все доступное пространоство, на панели задач, то это поведение можно немного изменить. Для этого потребуется отредактировать файл ~/.config/awesome/awful/widget/tasklist.luaAwesome 3.4Найдите функцию new, в ней необхоидмо изменить:

layout = layout.horizontal.flex На тот вариант расположения виджетов, который вас устраивает. Их полный список находится в файлах awful/widget/layout horizontal.lua и vertical.lua:

layout = layout.horizontal.leftright Awesome 3.5Найдите функцию tasklist.new затем замените:

local w = base_widget or flex.horizontal () Например следующим кодом:

local w = base_widget or fixed.horizontal () А в начало файла добавьте:

local fixed = require («wibox.layout.fixed») Если предоженный вариант вас не устраивает, можете поэкспериментировать с layout’ами, они находятся в каталоге ~/.config/awesome/wibox/layout

Правда, ширина каждого клиента будет зависеть от названия, в принципе, это тоже можно поправить, если вам требуется фиксированная ширина клиентов, для этого нужно изменить в файле tasklist.lua функцию widget_tasklist_label_common (3.4) или tasklist_label (в 3.5):

В начало файла поместите:

local string = string Затем перед строкой ''if capi.client.focus == c then'' поместите следующий код:

if #name >20 then name = string.sub (name,1,20) end Здесь мы ограничиваем название 20-ю символами, если вам требуется другое значение, измените его.

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

Список клиентов По умолчанию в файле rc.lua для обработки списка клиентов и их отображения в контекстном меню используется следующий код: Awesome 3.5

mytasklist[s] = awful.widget.tasklist (s, awful.widget.tasklist.filter.currenttags, mytasklist.buttons) Awesome 3.4

mytasklist[s] = awful.widget.tasklist (function© return awful.widget.tasklist.label.currenttags (c, s) end, mytasklist.button) Т.е. изучив данный код, можно понять, что на панели задач, будут отображены клиенты для текущего тега. Если данное положение дел вас не устаривает, то вы можете например отобразить все клиенты со всех тегов, для этого нужно заменить соотвествующую функцию на одну из следующий:

Awesome 3.4awful.widget.tasklist.label.allscreen — для отображения клиентов со всех экрановawful.widget.tasklist.label.alltags — для отображения клиентов со всех тегов текущего экранаawful.widget.tasklist.label.currenttags — для отображения клиентов с текущего тегаawful.widget.tasklist.label.focused — для оторажения только клиентов в фокусе

Awesome 3.5awful.widget.tasklist.filter.allscreen — для отображения клиентов со всех экрановawful.widget.tasklist.filter.alltags — для отображения клиентов со всех тегов текущего экранаawful.widget.tasklist.filter.currenttags — для отображения клиентов с текущего тегаawful.widget.tasklist.filter.minimizedcurrenttags — для отображения свернутых клиентов на текущем тегеawful.widget.tasklist.filter.focused — для оторажения только клиентов в фокусе

Помимо этого, есть еще ряд приложений, которые не будут отображаться в списке клиентов, эта функция прописана в следующем коде: Awesome 3.5 — tasklist.lua — function tasklist_update:

if not (c.skip_taskbar or c.hidden or c.type == «splash» or c.type == «dock» or c.type == «desktop») and filter (c, s) then table.insert (clients, c) end Похожий код используется и в 3.4, но без строки ''and filter (c, s)''. Т.е. здесь мы пропускаем часть клиентов, если какие то из них вам все же нужны, удалите код отвечающий за них.

Сигналы Сигналы — это система сообщений которую рассылает ядро Awesome для управления виджетами, клиентами, тегами и т.д. Подробне ознакомится с системой сигналов вы можете здесь.Итак, поддерживаются следующие сигналы:

tag.attached_connect_signal (screen, «property: selected», u) tag.attached_connect_signal (screen, «property: activated», u) capi.client.connect_signal («property: urgent», u) capi.client.connect_signal («property: sticky», u) capi.client.connect_signal («property: ontop», u) capi.client.connect_signal («property: floating», u) capi.client.connect_signal («property: maximized_horizontal», u) capi.client.connect_signal («property: maximized_vertical», u) capi.client.connect_signal («property: minimized», u) capi.client.connect_signal («property: name», u) capi.client.connect_signal («property: icon_name», u) capi.client.connect_signal («property: icon», u) capi.client.connect_signal («property: skip_taskbar», u) capi.client.connect_signal («property: screen», u) capi.client.connect_signal («property: hidden», u) capi.client.connect_signal («tagged», u) capi.client.connect_signal («untagged», u) capi.client.connect_signal («unmanage», u) capi.client.connect_signal («list», u) capi.client.connect_signal («focus», u) capi.client.connect_signal («unfocus», u) Названия сигналов говорят сами за себя, единственное, первые 2 улавливают события от тегов, для того, чтобы при смене тега отобразить актуальный список клиентов на нем. После того, как будет принято данное событие будет вызвана функция u:

u = function () tasklist_update (screen, w, buttons, filter, data, style, uf) end Т.е. панель задач будет обновлена. Так что если вы где то будете менять какое то свойство для клиента, можете не беспокоиться, оно будет отловлено и корректно обработано. Если же нужного вам сигнала здесь нет, то вы всегда можете создать свой.

Ссылки Xephyr — позволяет открывать Awesome в новом Х-сервере. Т.е. если вы периодически экспериментируете с исходниками, то для экспериментов используйте Xephyr.Radical — мощная и расширяемя система меню.Hints — оконные подсказки для фокусировки на окне.

© Habrahabr.ru