Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

CAW!

branch: master
README
CAW!!!

CAW is a easily customizable taskbar written in Python.

Dependencies
--

libxcb 1.2
xcb-proto 1.4
xcb-util 0.3.4
xpyb 1.1
cairo 1.8.8
pango 1.24.5


Building
---------

python setup.py build


Install
--------

python setup.py install


Configuration
-----------------

A sample config is provided: /etc/xdg/caw/config.py

Copy this file to: $HOME/.config/caw/config.py

for more information on widgets and configuration settings:
http://caw.milkbox.net


Running
--------

caw



*** Development Notes ***

Running from the Build Directory (GIT)
----------------------------------------

1. export your PYTHONPATH to use the development path (where arch is your
   architecture (i686 / x86_64)

export PYTHONPATH=$SRC/caw/build/lib.linux-<arch>-2.6


2. build caw.

python setup.py build


3. execute 'caw' or directly run your configuration file.

bin/caw

or

python $HOME/.config/caw/config.py


Make sure if you make modifications to your source you rebuild it.  I normally leave
one terminal open to the <src> directory then run:

python setup.py build && python $HOME/.config/caw/config.py




Notes
--
I tried as much as possible to use the XPYB implementation but there are some
things (such as cairo drawing) that cannot be done on the Python side using XCB.
The choice to use XCB was two-fold: to learn xcb and to use something that is
predicted to be the new xlib (maybe?).  Anyways, I am using openbox, it relies
on pango which in-turn relies on cairo so that is OK.
Something went wrong with that request. Please try again.