Jump to content
From ArchWiki
Состояние перевода: На этой странице представлен перевод статьи Polybar. Дата последней синхронизации: 30 июля 2019. Вы можете помочь синхронизировать перевод, если в английской версии произошли изменения.

polybar — быстрый и лёгкий инструмент для создания статус-баров. Он нацелен на лёгкую персонализацию, используя множество модулей и позволяя, например, отображать рабочие столы, дату или громкость звука. Особенно Polybar полезен в оконных менеджерах без панели или с её ограниченной функциональностью, таких как awesome или i3. Polybar также можно использовать и в окружениях рабочего стола, например, в Plasma.

## Установка

Установите пакет polybar. Экспериментальная версия доступна в пакете polybar-gitAUR.

## Настройка

Скопируйте пример конфигурационного файла из `/usr/share/doc/polybar/config` в `$XDG_CONFIG_HOME/polybar/config`

### Запуск Polybar

Polybar можно запустить со следующими параметрами:

    Usage: polybar [OPTION]... BAR

      -h, --help               Display this help and exit
      -v, --version            Display build details and exit
      -l, --log=LEVEL          Set the logging verbosity (default: WARNING)
                               LEVEL is one of: error, warning, info, trace
      -q, --quiet              Be quiet (will override -l)
      -c, --config=FILE        Path to the configuration file
      -r, --reload             Reload when the configuration has been modified
      -d, --dump=PARAM         Print value of PARAM in bar section and exit
      -m, --list-monitors      Print list of available monitors and exit
      -w, --print-wmname       Print the generated WM_NAME and exit
      -s, --stdout             Output data to stdout instead of drawing it to the X window
      -p, --png=FILE           Save png snapshot to FILE after running for 3 seconds

Но скорее всего, вы будете запускать Polybar с оконным менеджером, см. раздел #Запуск с оконным менеджером.

### Пример конфигурационного файла

Пример простого конфигурационного файла:

    [bar/mybar]
    modules-right = date

    [module/date]
    type = internal/date
    date = %Y-%m-%d%

Он создаёт статус-бар `mybar` с модулем `date`.

Также по умолчанию polybar создаёт пример со многими преднастроенными модулями в файле `/usr/share/doc/polybar/config`.

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

### Запуск с оконным менеджером

Создайте исполняемый файл, содержащий процесс загрузки, например, `$HOME/.config/polybar/launch.sh`:

    #!/bin/bash

    # Завершить текущие экземпляры polybar
    killall -q polybar

    # Ожидание полного завершения работы процессов
    while pgrep -u $UID -x polybar >/dev/null; do sleep 1; done

    # Запуск Polybar со стандартным расположением конфигурационного файла в ~/.config/polybar/config
    polybar mybar &

    echo "Polybar загрузился..."

Данный скрипт означает, что при перезагрузке оконного менеджера также перезагрузится и Polybar.

#### bspwm

Если вы используете bspwm, добавьте в `bspwmrc`:

    $HOME/.config/polybar/launch.sh

#### i3

Если вы используете i3, добавьте в его конфигурационный файл:

    exec_always --no-startup-id $HOME/.config/polybar/launch.sh

## Решение проблем

### Cannot open shared object file libjsoncpp.so

Попробуйте переустановить Polybar, как описано в issue на GitHub.

Если проблема не решится, попробуйте установить пакет jsoncpp.

## Смотрите также

- Polybar Github Wiki

Category:

- Eye candy (Русский)