The i3xrocks(1) command generates a status line for i3bar(1). It schedules command lines described in a simple configuration file at specified time intervals, upon signal reception or on clicks.
- -h
-
Show the help message and exit.
- -c CONFIGFILE
-
Specifies an alternate configuration file path.
- -d CONFIGDIR
-
Specifies a conf.d style configuration directory.
- -u USERCONFIGDIR
-
Specifies a conf.d style user configuration directory.
- -v
-
Increase log level. This option is a cumulative. By default only fatal errors are shown in the status bar. Passing this option once will show error messages as well. Using -vv and more will show more debug output on standard error.
i3xrocks must be defined as the status line command of the bar block described in your i3(1) configuration file:
bar {
status_command i3xrocks
}By default, i3xrocks looks for a configuration file in the following order (note that /etc may be prefixed with /usr/local depending on the compilation flags):
-
$XDG_CONFIG_HOME/i3xrocks/config (or ~/.config/i3xrocks/config)
-
~/.i3xrocks.conf
-
$XDG_CONFIG_DIRS/i3xrocks/config (or /etc/xdg/i3xrocks/config)
-
/etc/i3xrocks.conf
For the content of the configuration file, please refer to the i3blocks website: https://vivien.github.io/i3blocks
i3xrocks is written by Vivien Didelot and other contributors. Xresource and conf.d additions by Ken Gilmer.
Project web site: https://vivien.github.io/i3xrocks
Git source repository and issue tracker: https://github.com/vivien/i3xrocks
Official collection of scripts for i3xrocks: https://github.com/vivien/i3xrocks-contrib
i3bar protocol: http://i3wm.org/docs/i3bar-protocol.html