From 07377af249b35f11b2a05f8d2d1b9d130cfb4182 Mon Sep 17 00:00:00 2001 From: Ultrabug Date: Tue, 19 Feb 2013 18:47:16 +0100 Subject: more instructions on the README --- README.md | 36 +++++++++++++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 80d3c56..6ea571d 100644 --- a/README.md +++ b/README.md @@ -3,15 +3,45 @@ py3status py3status extends the mighty i3status for enhanced i3bar customization on i3wm -## Start using it +## Requirements +You must set the `output_format` to `i3bar` in the general section of your i3status.conf: + + general { + output_format = "i3bar" + } + +## Installation +Just clone the repository: + + $ git clone git@github.com:ultrabug/py3status.git .py3status + +Get into the cloned directory: + + $ cd .py3status + +And run the setup.sh as root or via sudo: + + $ sudo sh setup.sh + +## Usage In your i3 config file, simply change the `status_command` with: status_command py3status -## Useful options -You can see the help of py3status by issuing `py3status -h` +Usually you have your own i3status configuration, just point to it: + + status_command py3status -c ~/.i3/i3status.conf + +## Options +You can see the help of py3status by issuing `py3status -h`: -c I3STATUS_CONF path to i3status config file -n INTERVAL polling interval in seconds (default 1 sec) -i INCLUDE_PATH user-based class include directory -d disable integrated transformations + +## Update +Just pull on your local clone to get the latest py3status: + + $ cd .py3status + $ git pull -- cgit v1.3