1I3BAR(1)                           i3 Manual                          I3BAR(1)
2
3
4

NAME

6       i3bar - xcb-based status- and workspace-bar
7

SYNOPSIS

9       i3bar [-b bar_id] [-s sock_path] [-t] [-h] [-v] [-V]
10

WARNING

12       i3bar will automatically be invoked by i3 for every bar configuration
13       block.
14
15       Starting it manually is usually not what you want to do.
16
17       You have been warned!
18

OPTIONS

20       -s, --socket sock_path
21           Overwrites the path to the i3 IPC socket.
22
23       -b, --bar_id bar_id
24           Specifies the bar ID for which to get the configuration from i3. By
25           default, i3bar will use the first bar block as configured in i3.
26
27       -t, --transparency
28           Enable transparency (RGBA colors)
29
30       -h, --help
31           Display a short help-message and exit
32
33       -v, --version
34           Display version number and exit.
35
36       -V
37           Be verbose.
38

DESCRIPTION

40       i3bar displays a bar at the bottom (or top) of your monitor(s)
41       containing workspace switching buttons and a statusline generated by
42       i3status(1) or similar. It is automatically invoked (and configured
43       through) i3.
44
45       i3bar supports colors via a JSON protocol starting from v4.2, see
46       https://i3wm.org/docs/i3bar-protocol.html
47

ENVIRONMENT

49   I3SOCK
50       Used as a fallback for the i3 IPC socket path if neither the
51       commandline contains an argument nor the I3_SOCKET_PATH property is set
52       on the X11 root window.
53

EXAMPLES

55       Nothing to see here, move along. As stated above, you should not run
56       i3bar manually.
57
58       Instead, see the i3 documentation, especially the User’s Guide.
59

SEE ALSO

61       i3status(1), j4status(1) or conky(1) for programs generating a
62       statusline.
63
64       dzen2(1) or xmobar(1) for similar programs to i3bar.
65

AUTHORS

67       Axel Wagner and contributors
68
69
70
71i3 4.22                           01/02/2023                          I3BAR(1)
Impressum