Pull to refresh

Awesome tasklist

Reading time 12 min
Views 26K
На 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 (c)			--нажатие левой кнопки
                 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)
    c:kill()
end ),


Альтернативное меню




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

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

awful.button({ }, 3, function (c)
          if instance then
              instance:hide()
              instance = nil
           else
              instance = context_menu(c)
           end
         end ),


Затем где нибудь в начале файла rc.lua добавьте функцию context_menu:

function context_menu(c)
    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(c) 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(c) 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


Примечание: Не определяйте как одновременно обе этих переменных, иначе вы вообще не увидите своих задач.



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

mytasklist[s] = awful.widget.tasklist(function(c)
                        return awful.widget.tasklist.label.currenttags(c, s)
                end, mytasklist.buttons)


И замените его на:

 mytasklist[s] = awful.widget.tasklist(function(c)
                              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(c)
                      return awful.widget.tasklist.label.currenttags(c, s)
                end, mytasklist.buttons)


И замените его на:

 mytasklist[s] = awful.widget.tasklist(function(c)
                              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.5
theme.tasklist_fg_normal — цвет текста панели задач, если значение не определено, то используется значение theme.fg_normal
theme.tasklist_bg_normal — цвет фона панели задач, если значение не определено, то используется значение theme.bg_normal
theme.tasklist_fg_focus — цвет текста активного приложения, если значение не определено, используется значение theme.fg_focus
theme.tasklist_bg_focus — цвет фона активного приложения, если значение не определено, то используется значение theme.bg_focus
theme.tasklist_fg_urgent — цвет текста «срочного» приложения, если не определено, то будет использоваться значение из theme.fg_urgent
theme.tasklist_bg_urgent — цвет фона «срочного» приложения, если не определено, то будет использоваться значение theme.bg_urgent
theme.tasklist_fg_minimize — цвет текста свернутого приложения, если не определено, то будет использоваться значение из theme.fg_minimize
theme.tasklist_bg_minimize — цвет фона свернутого приложения, если не определено, то будет использоваться значение из theme.bg_minimize
theme.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_focus
theme.tasklist_bg_focus — цвет фона активного приложения, если значение не определено, то используется значение theme.bg_focus
theme.tasklist_fg_urgent — цвет текста «срочного» приложения, если не определено, то будет использоваться значение из theme.fg_urgent
theme.tasklist_bg_urgent — цвет фона «срочного» приложения, если не определено, то будет использоваться значение theme.bg_urgent
theme.tasklist_fg_minimize — цвет текста свернутого приложения, если не определено, то будет использоваться значение из theme.fg_minimize
theme.tasklist_bg_minimize — цвет фона свернутого приложения, если не определено, то будет использоваться значение из theme.bg_minimize
theme.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.lua

Awesome 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(c) 
                               return awful.widget.tasklist.label.currenttags(c,s)
                          end, mytasklist.button)


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

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

Awesome 3.5
awful.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 — оконные подсказки для фокусировки на окне.
Tags:
Hubs:
+21
Comments 9
Comments Comments 9

Articles