102 lines
2.8 KiB
ReStructuredText
102 lines
2.8 KiB
ReStructuredText
**********************
|
|
Window manager widgets
|
|
**********************
|
|
|
|
Awesome widget
|
|
==============
|
|
|
|
.. note:: Powerline currently only supports awesome 3.5.
|
|
|
|
.. note:: The Powerline widget will spawn a shell script that runs in the
|
|
background and updates the statusline with ``awesome-client``.
|
|
|
|
Add the following to :file:`rc.lua`, where ``{repository_root}`` is the absolute
|
|
path to Powerline installation directory (see :ref:`repository root
|
|
<repository-root>`):
|
|
|
|
.. code-block:: lua
|
|
|
|
package.path = package.path .. ';{repository_root}/powerline/bindings/awesome/?.lua'
|
|
require('powerline')
|
|
|
|
Then add the ``powerline_widget`` to ``wibox``:
|
|
|
|
.. code-block:: lua
|
|
|
|
right_layout:add(powerline_widget)
|
|
|
|
Qtile widget
|
|
============
|
|
|
|
Add the following to :file:`~/.config/qtile/config.py`:
|
|
|
|
.. code-block:: python
|
|
|
|
from libqtile.bar import Bar
|
|
from libqtile.config import Screen
|
|
from libqtile.widget import Spacer
|
|
|
|
from powerline.bindings.qtile.widget import PowerlineTextBox
|
|
|
|
screens = [
|
|
Screen(
|
|
top=Bar([
|
|
PowerlineTextBox(update_interval=2, side='left'),
|
|
Spacer(),
|
|
PowerlineTextBox(update_interval=2, side='right'),
|
|
],
|
|
35 # width
|
|
),
|
|
),
|
|
]
|
|
|
|
.. _lemonbar-usage:
|
|
|
|
lemonbar (formerly bar-aint-recursive)
|
|
======================================
|
|
|
|
To run the bar simply start the binding script:
|
|
|
|
python /path/to/powerline/bindings/lemonbar/powerline-lemonbar.py
|
|
|
|
You can specify options to be passed to ``lemonbar`` after ``--``, like so:
|
|
|
|
python /path/to/powerline/bindings/lemonbar/powerline-lemonbar.py --height 16 -- -f "Source Code Pro for Powerline-9"
|
|
|
|
to run with i3, simply ``exec`` this in the i3 config file and set the ``--i3`` switch:
|
|
|
|
exec python /path/to/powerline/bindings/lemonbar/powerline-lemonbar.py --i3
|
|
|
|
Running the binding in i3-mode will require `i3ipc <https://github.com/acrisci/i3ipc-python>`_
|
|
(or the outdated `i3-py <https://github.com/ziberna/i3-py>`_).
|
|
|
|
See the `lemonbar documentation <https://github.com/LemonBoy/bar>`_ for more
|
|
information and options.
|
|
|
|
All ``powerline-lemonbar.py`` arguments:
|
|
|
|
.. automan:: powerline.commands.lemonbar
|
|
:prog: powerline-lemonbar.py
|
|
:minimal: true
|
|
|
|
I3 bar
|
|
======
|
|
|
|
.. note::
|
|
As the patch to include background-colors in i3bar is likely not to be
|
|
merged, it is recommended to instead run ``bar`` (see above). The source for
|
|
i3bgbar is however still available `here
|
|
<https://github.com/S0lll0s/i3bgbar>`_.
|
|
|
|
Add the following to :file:`~/.i3/config`::
|
|
|
|
bar {
|
|
i3bar_command i3bgbar
|
|
|
|
status_command python /path/to/powerline/bindings/i3/powerline-i3.py
|
|
font pango:PowerlineFont 12
|
|
}
|
|
|
|
where ``i3bgbar`` may be replaced with the path to the custom i3bar binary and
|
|
``PowerlineFont`` is any system font with powerline support.
|