GitHub - milkypostman/caw: CAW!

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 106 Commits
Packaging/Arch		Packaging/Arch
bin		bin
caw		caw
doc		doc
etc		etc
.gitignore		.gitignore
README		README
setup.cfg		setup.cfg
setup.py		setup.py

Repository files navigation

CAW!!!

CAW is a easily customizable taskbar written in Python 2.x.

Dependencies
--

libxcb 1.11
xcb-proto 1.11
xcb-util 0.3.4
xpyb 1.3.1 OR xcffib 0.2.3
cairo 1.8.8
pango 1.24.5


Building
---------

python2 setup.py build


Install
--------

python2 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.