Quickstart

Dependencies

  • Python 2.7 or >= 3.3

  • netifaces optional, needed for pi3bar.plugins.net.NetIFace

    (install with pip install netifaces)

Installation

Todo

pip install pi3bar

Clone the repository and install manually:

$ git clone https://rolln.de/knoppo/pi3bar

$ cd pi3bar/

$ python setup.py install

Configuration

Go to your your i3 directory (where your config is located):

$ cd ~/.i3/

# or

$ cd ~/.config/i3/

Create a file called status.py with the following content and customize it to fit your needs: (See the Reference for further information.)

#! /usr/bin/env python
from pi3bar.app import Pi3Bar
from pi3bar.plugins import *


Pi3Bar(
    IMAPUnread('example.com', 'mail@example.com', on_click={1: 'claws-mail'}),
    NetIFace('eth0', on_click={1: 'wicd-client -n'}),  # requires netifaces
    NetIFace('wlan0', on_click={1: 'wicd-client -n'}),  # requires netifaces
    Disk('/', on_click={1: 'thunar'}),
    Uname(),
    LoadAvg(on_click={1: 'xterm -e htop'}),
    Uptime(),
    Battery(),
    Clock(),
).run()

Make your script executable:

$ chmod +x status.py

Update your i3 config file:

bar {
    status_command ~/.i3/status.py
}

Reload or restart your i3 (usually <mod>+R).