X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=docs%2Fi3status.html;h=c86426839fd57c3a648b8a3d48b4f9bafeaacf78;hb=eee149f9ffa4fe019179bd14159eb0a4bd3762c0;hp=c4bccd500a51816d5bbeb211dc8cce5bf65e09df;hpb=87cee41137a38cc7025adc53c18810af31067213;p=i3%2Fi3.github.io diff --git a/docs/i3status.html b/docs/i3status.html index c4bccd5..c864268 100644 --- a/docs/i3status.html +++ b/docs/i3status.html @@ -4,13 +4,13 @@ - + i3: i3status(1) @@ -125,7 +125,8 @@ order += "ethernet eth0" order += "battery 0" order += "cpu_temperature 0" order += "load" -order += "time" +order += "tztime local" +order += "tztime berlin" wireless wlan0 { format_up = "W: (%quality at %essid, %bitrate) %ip" @@ -152,10 +153,15 @@ run_watch VPN { pidfile = "/var/run/vpnc/pid" } -time { +tztime local { format = "%Y-%m-%d %H:%M:%S" } +tztime berlin { + format = "%Y-%m-%d %H:%M:%S %Z" + timezone = "Europe/Berlin" +} + load { format = "%5min" } @@ -232,6 +238,10 @@ be used with i3bar and can be used for custom scripts.

+

It’s also possible to use the color_good, color_degraded, color_bad directives +to define specific colors per module. If one of these directives is defined +in a module section its value will override the value defined in the general +section just for this module.

5.2. IPv6

@@ -282,6 +292,8 @@ 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 you want the battery percentage to be shown without decimals, add +integer_battery_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.

@@ -296,9 +308,12 @@ colored red. The low_threshold type can be of threshold_type "time" or

5.8. CPU-Temperature

-

Gets the temperature of the given thermal zone.

+

Gets the temperature of the given thermal zone. It is possible to +define a max_threshold that will color the temperature red in case the +specified thermal zone is getting too hot. Defaults to 75 degrees C.

Example order: cpu_temperature 0

Example format: T: %degrees °C

+

Example max_threshold: 42

5.9. CPU Usage

@@ -309,18 +324,37 @@ colored red. The low_threshold type can be of threshold_type "time" or

5.10. Load

Gets the system load (number of processes waiting for CPU time in the last -1, 5 and 15 minutes).

+1, 5 and 15 minutes). It is possible to define a max_threshold that will +color the load value red in case the load average of the last minute is +getting higher than the configured threshold. Defaults to 5.

Example order: load

Example format: %1min %5min %15min

+

Example max_threshold: 5

5.11. Time

-

Formats the current system time. See strftime(3) for the format.

+

Outputs the current time in the local timezone. +To use a different timezone, you can set the TZ environment variable, +or use the tztime module. +See strftime(3) for details on the format string.

Example order: time

Example format: %Y-%m-%d %H:%M:%S

-

5.12. DDate

+

5.12. TzTime

+

Outputs the current time in the given timezone. +If no timezone is given, local time will be used. +See strftime(3) for details on the format string. +The system’s timezone database is usually installed in /usr/share/zoneinfo. +Files below that path make for valid timezone strings, e.g. for +/usr/share/zoneinfo/Europe/Berlin you can set timezone to Europe/Berlin +in the tztime module.

+

Example order: tztime berlin

+

Example format: %Y-%m-%d %H:%M:%S %Z

+

Example timezone: Europe/Berlin

+
+
+

5.13. DDate

Outputs the current discordian date in user-specified format. See ddate(1) for details on the format string. Note: Neither %. nor %X are implemented yet.

@@ -328,7 +362,7 @@ details on the format string.

Example format: %{%a, %b %d%}, %Y%N - %H

-

5.13. Volume

+

5.14. Volume

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 @@ -434,13 +468,21 @@ contrib/ folder, see http:/

-

10. SEE ALSO

+

10. SIGNALS

+
+

When receiving SIGUSR1, i3status’s nanosleep() will be interrupted and thus +you will force an update. You can use killall -USR1 i3status to force an update +after changing the system volume, for example.

+
+
+
+

11. SEE ALSO

strftime(3), date(1), glob(3), dzen2(1), xmobar(1)

-

11. AUTHORS

+

12. AUTHORS

Michael Stapelberg and contributors

Thorsten Toepper