1I3BLOCKS(1)                                                        I3BLOCKS(1)
2
3
4

NAME

6       i3blocks - A feed generator for text based status bars
7

SYNOPSIS

9       i3blocks [OPTION]...
10

DESCRIPTION

12       The i3blocks(1) command generates a status line for i3bar(1). It
13       schedules command lines described in a simple configuration file at
14       specified time intervals, upon signal reception or on clicks.
15

OPTIONS

17       -h
18           Show the help message and exit.
19
20       -c CONFIGFILE
21           Specifies an alternate configuration file path.
22
23       -v
24           Increase log level. This option is a cumulative. By default only
25           fatal errors are shown in the status bar. Passing this option once
26           will show error messages as well. Using -vv and more will show more
27           debug output on standard error.
28

CONFIGURATION

30       i3blocks must be defined as the status line command of the bar block
31       described in your i3(1) configuration file:
32
33           bar {
34             status_command i3blocks
35           }
36
37       By default, i3blocks looks for a configuration file in the following
38       order (note that /etc may be prefixed with /usr/local depending on the
39       compilation flags):
40
41        1. $XDG_CONFIG_HOME/i3blocks/config (or ~/.config/i3blocks/config)
42
43        2. ~/.i3blocks.conf
44
45        3. $XDG_CONFIG_DIRS/i3blocks/config (or /etc/xdg/i3blocks/config)
46
47        4. /etc/i3blocks.conf
48
49       For the content of the configuration file, please refer to the i3blocks
50       website: https://vivien.github.io/i3blocks
51

SEE ALSO

53       i3(1), i3bar(1), i3status(1)
54

AUTHORS

56       i3blocks is written by Vivien Didelot and other contributors.
57

RESOURCES

59       Project web site: https://vivien.github.io/i3blocks
60
61       Git source repository and issue tracker:
62       https://github.com/vivien/i3blocks
63
64       Official collection of scripts for i3blocks:
65       https://github.com/vivien/i3blocks-contrib
66
67       i3bar protocol: http://i3wm.org/docs/i3bar-protocol.html
68

COPYING

70       Copyright © Vivien Didelot. Free use of this software is granted under
71       the terms of the GPLv3+ License.
72
73
74
75                                  2019-08-12                       I3BLOCKS(1)
Impressum