From: Michael Stapelberg Date: Wed, 3 Oct 2012 12:10:45 +0000 (+0200) Subject: add i3status 2.6 X-Git-Url: https://git.sur5r.net/?p=i3%2Fi3.github.io;a=commitdiff_plain;h=7655baf7af75c0257a7c6ef1e676d157e6a5fa07 add i3status 2.6 --- diff --git a/_docs/i3status.man b/_docs/i3status.man index 0ba010e..9a19ec9 100644 --- a/_docs/i3status.man +++ b/_docs/i3status.man @@ -1,7 +1,7 @@ i3status(1) =========== -Michael Stapelberg -v2.5, May 2012 +Michael Stapelberg +v2.6, October 2012 == NAME @@ -72,6 +72,7 @@ ethernet eth0 { battery 0 { format = "%status %percentage %remaining %emptytime" path = "/sys/class/power_supply/BAT%d/uevent" + low_threshold = 10 } run_watch DHCP { @@ -155,10 +156,15 @@ best available public IPv6 address on your computer). Gets used, free, available and total amount of bytes on the given mounted filesystem. +These values can also be expressed in percentages with the percentage_used, +percentage_free, percentage_avail and percentage_used_of_avail formats. + *Example order*: +disk /mnt/usbstick+ *Example format*: +%free (%avail)/ %total+ +*Example format*: +%percentage_used used, %percentage_free free, %percentage_avail avail+ + === Run-watch Expands the given path to a pidfile and checks if the process ID found inside @@ -191,21 +197,30 @@ it using +setcap cap_net_admin=ep $(which i3status)+. === Battery -Gets the status (charging, discharging, running), percentage and remaining -time of the given battery and when it's estimated to be empty. If you want -to use the last full capacity instead of the design capacity (when using -the design capacity, it may happen that your battery is at 23% when fully -charged because it’s old. In general, I want to see it this way, because -it tells me how worn off my battery is.), just specify +Gets the status (charging, discharging, running), percentage, remaining +time and power consumption (in Watts) of the given battery and when it's +estimated to be empty. If you want to use the last full capacity instead of the +design capacity (when using the design capacity, it may happen that your +battery is at 23% when fully charged because it’s old. In general, I want to +see it this way, because it tells me how worn off my battery is.), just specify +last_full_capacity = true+. If your battery is represented in a non-standard path in /sys, be sure to modify the "path" property accordingly. The first occurence of %d gets replaced with the battery number, but you can just hard-code a path as well. +It is possible to define a low_threshold that causes the battery text to be +colored red. The low_threshold type can be of threshold_type "time" or +"percentage". So, if you configure low_threshold to 10 and threshold_type to +"time", and your battery lasts another 9 minutes, it will be colored red. + *Example order*: +battery 0+ -*Example format*: +%status %remaining (%emptytime)+ +*Example format*: +%status %remaining (%emptytime %consumption)+ + +*Example low_threshold*: +30+ + +*Example threshold_type*: +time+ === CPU-Temperature @@ -217,7 +232,7 @@ Gets the temperature of the given thermal zone. === CPU Usage -Gets the percentual CPU usage from +/proc/stat+. +Gets the percentual CPU usage from +/proc/stat+ (Linux) or +sysctl(3)+ (FreeBSD/OpenBSD). *Example order*: +cpu_usage+ @@ -254,6 +269,10 @@ details on the format string. Outputs the volume of the specified mixer on the specified device. Works only on Linux because it uses ALSA. +A simplified configuration can be used on FreeBSD and OpenBSD due to +the lack of ALSA, the +device+, +mixer+ and +mixder_idx+ options can be +ignored on these systems. On these systems the OSS API is used instead to +query +/dev/mixer+ directly. *Example order*: +volume master+ @@ -346,6 +365,10 @@ done Put that in some script, say +.bin/my_i3status.sh+ and execute that instead of i3status. +Note that if you want to use the JSON output format (with colors in i3bar), you +need to use a slightly more complex wrapper script. There are examples in the +contrib/ folder, see http://code.i3wm.org/i3status/tree/contrib + == SEE ALSO +strftime(3)+, +date(1)+, +glob(3)+, +dzen2(1)+, +xmobar(1)+ diff --git a/i3status/i3status-2.6.tar.bz2 b/i3status/i3status-2.6.tar.bz2 new file mode 100644 index 0000000..cfd4b60 Binary files /dev/null and b/i3status/i3status-2.6.tar.bz2 differ diff --git a/i3status/i3status-2.6.tar.bz2.asc b/i3status/i3status-2.6.tar.bz2.asc new file mode 100644 index 0000000..8900a13 --- /dev/null +++ b/i3status/i3status-2.6.tar.bz2.asc @@ -0,0 +1,17 @@ +-----BEGIN PGP SIGNATURE----- +Version: GnuPG v1.4.12 (GNU/Linux) + +iQIcBAABCgAGBQJQbCsJAAoJEE5xYO1KyO4dWAsP/it01mfVVwjw/f/d33aXAH+c +bNiKkjXSiK51xCX6HUBpZNd7memdGQN3rWhoDLCobNLYJ1t+1xp2/6Ol1NACNcyh +zZFA08JpV5hia/Kpjku0GPmCCEcom01hmfHDmhvyNH8VIAJ3fpjLDy0VzNAX/uku +DKo8sVUVOYxOoAoifQTZlaBkrc59SHFje3Z35+Z8pNKoMrjeO+7c7oEMXvOSfN9h +WffNSSOGjt9FuVAgapjqSei+osl7Og/wnIZADnd9/eiH77+TFbPqH0/wGdmHrC6/ +idm/1b4QSm3WwRrx2b8zUZ3vYX6gIYhpqgGKd2VyiMbRKfK0KBLLb5J0FQVFLIdZ +mI8RI1k9yd5w18NBCgA5W4AymkuMsd/MWzKDIMJtQxLNnkW/6Fxb8E0jVDCtucjN +DBk5SovZ+4JUXzNakutzFjr3W2/TbWavfSF2TsaAzFnWzp1Wl1WiAgNghNN8x0bv +crHUFUqPLa0BfSf9CIHLNOfCliK4xKkLSD5TQF+RXxxSmWEHPEHOOkwJYtNY8ObM +cifHT6u1ocUS6ACKSi3Vu/r2+a5jZUrXaE0cV4PsdAkvG/6z+n47mFg+42kSFL3d +tb3g/wb65dUUy38Pi+4uFeBSMM31NyULiXjS3aOV4AWnzOzA18vUgU13Z8rWF7b6 +S2c3aDEEcCBVo1fKHe8m +=0iAU +-----END PGP SIGNATURE----- diff --git a/i3status/index.html.mako b/i3status/index.html.mako index 76f80c1..b0bd67c 100644 --- a/i3status/index.html.mako +++ b/i3status/index.html.mako @@ -19,6 +19,8 @@

Releases

    +
  • i3status-2.6.tar.bz2 + (GPG signature, 2012-10-03)
  • i3status-2.5.1.tar.bz2 (GPG signature, 2012-05-11)
  • i3status-2.5.tar.bz2 diff --git a/i3status/manpage.html b/i3status/manpage.html index b7b468c..c4bccd5 100644 --- a/i3status/manpage.html +++ b/i3status/manpage.html @@ -4,7 +4,7 @@ - + i3: i3status(1) @@ -30,9 +30,9 @@ window.onload = function(){asciidoc.footnotes(); asciidoc.toc(2);}

    5.7. Battery

    -

    Gets the status (charging, discharging, running), percentage and remaining -time of the given battery and when it’s estimated to be empty. If you want -to use the last full capacity instead of the design capacity (when using -the design capacity, it may happen that your battery is at 23% when fully -charged because it’s old. In general, I want to see it this way, because -it tells me how worn off my battery is.), just specify +

    Gets the status (charging, discharging, running), percentage, remaining +time and power consumption (in Watts) of the given battery and when it’s +estimated to be empty. If you want to use the last full capacity instead of the +design capacity (when using the design capacity, it may happen that your +battery is at 23% when fully charged because it’s old. In general, I want to +see it this way, because it tells me how worn off my battery is.), just specify last_full_capacity = true.

    If your battery is represented in a non-standard path in /sys, be sure to modify the "path" property accordingly. The first occurence of %d gets replaced with the battery number, but you can just hard-code a path as well.

    +

    It is possible to define a low_threshold that causes the battery text to be +colored red. The low_threshold type can be of threshold_type "time" or +"percentage". So, if you configure low_threshold to 10 and threshold_type to +"time", and your battery lasts another 9 minutes, it will be colored red.

    Example order: battery 0

    -

    Example format: %status %remaining (%emptytime)

    +

    Example format: %status %remaining (%emptytime %consumption)

    +

    Example low_threshold: 30

    +

    Example threshold_type: time

    5.8. CPU-Temperature

    @@ -292,7 +302,7 @@ with the battery number, but you can just hard-code a path as well.

    5.9. CPU Usage

    -

    Gets the percentual CPU usage from /proc/stat.

    +

    Gets the percentual CPU usage from /proc/stat (Linux) or sysctl(3) (FreeBSD/OpenBSD).

    Example order: cpu_usage

    Example format: %usage

    @@ -320,7 +330,11 @@ details on the format string.

    5.13. Volume

    Outputs the volume of the specified mixer on the specified device. Works only -on Linux because it uses ALSA.

    +on Linux because it uses ALSA. +A simplified configuration can be used on FreeBSD and OpenBSD due to +the lack of ALSA, the device, mixer and mixder_idx options can be +ignored on these systems. On these systems the OSS API is used instead to +query /dev/mixer directly.

    Example order: volume master

    Example format: ♪: %volume

    Example configuration:

    @@ -414,6 +428,9 @@ do done

    Put that in some script, say .bin/my_i3status.sh and execute that instead of i3status.

    +

    Note that if you want to use the JSON output format (with colors in i3bar), you +need to use a slightly more complex wrapper script. There are examples in the +contrib/ folder, see http://code.i3wm.org/i3status/tree/contrib