================================================ pydzen (c)2008 Rico Schiekel (fire@downgra.de) ================================================ Overview ======== pydzen is a wrapper script around dzen, written in python, to easily create nice looking statusbars. Installation ============ Copy the file 'pydzen.py' to a suitable directory like '/usr/local/bin/' or '~/bin/'. Next create a '.pydzen/' directory in your home and copy the file 'pydzenrc' and the 'plugin/' directory into it. Finally customize your 'pydzenrc' and the plugins like mentioned in the next paragraph. the shipped plugins need a relative new version of dzen. you can get it from http://gotmor.googlepages.com/dzen. at the moment, pydzen is tested with revision 215 from the subversion repository. Configuration ============= The 'pydzenrc' file contains all settings how your statusbar will look like. Most of these settings are self-explanatory. You can define new settings to use them in plugins by simply defining them here. Some of the plugins also need some tweaking, e.g. special paths or so. This is done in the plugin files, 'cause I'm to lazy. So look for 'user config' sections... New Plugins =========== A new plugin is simply a python file, which at least must define an update() function. This function must return correct dzen2 in-text formating strings, or None if nothing should be displayed. Plugins can import 'utils' and 'config' from the pydzen package to use the current configuration and nice helper functions. Take a look at the existing plugins to see this in use. Bug Reports =========== Send your bug reports and feature requests to <pydzen@downgra.de>. Patches ======= If you do not have the repository yet download it via: > hg clone http://downgra.de/hg/pydzen If you already have the repository please make sure you are using the current version: > hg pull > hg update or > hg fetch Now apply your changes (with the editor of you choice). Then commit your changes local via running: > hg commit -m "short description regarding your changes" Finally send the patch via mercurials patchbomb extension, > hg email -o -t pydzen@downgra.de or export your changes manualy (replace tip with -r?:? if needed): > hg export tip | mail -s "short description" pydzen@downgra.de License ======= This program is under the terms of GPL (GNU General Public License). see COPYING file.