]> git.sur5r.net Git - i3/i3status/blob - README.md
Merge pull request #243 from jasperla/fei_error
[i3/i3status] / README.md
1 # i3status 
2
3 ## Description
4
5 i3status is a small program for generating a status bar for i3bar, dzen2, xmobar
6 or similar programs. It is designed to be very efficient by issuing a very small
7 number of system calls, as one generally wants to update such a status line
8 every second. This ensures that even under high load, your status bar is updated
9 correctly. Also, it saves a bit of energy by not hogging your CPU as much as
10 spawning the corresponding amount of shell commands would.
11
12 ## Development
13
14 i3status has the following dependencies:
15   * libconfuse-dev
16   * libyajl-dev
17   * libasound2-dev
18   * libnl-genl-3-dev
19   * libcap2-bin (for getting network status without root permissions)
20   * asciidoc (only for the documentation)
21   * libpulse-dev (for getting the current volume using PulseAudio)
22
23 On debian-based systems, the following line will install all requirements:
24 ```bash
25 apt-get install libconfuse-dev libyajl-dev libasound2-dev libiw-dev asciidoc libcap2-bin libpulse-dev libnl-genl-3-dev
26 ```
27
28 ## Upstream
29
30 i3status is developed at https://github.com/i3/i3status
31
32 ## Compilation 
33
34 Compiling is done with the usual make-line
35 ```bash
36   make && sudo make install
37 ```