aboutsummaryrefslogtreecommitdiff
path: root/man/i3bar.man
blob: 761748f3219c892638a2a26f734cacb7cb29b1fd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
i3bar(1)
========
Axel Wagner <mail+i3bar@merovius.de>
v4.1, October 2011

== NAME

i3bar - xcb-based status- and workspace-bar

== SYNOPSIS

*i3bar* [*-b* 'bar_id'] [*-s* 'sock_path'] [*-t*] [*-h*] [*-v*] [*-V*]

== WARNING

i3bar will automatically be invoked by i3 for every 'bar' configuration block.

Starting it manually is usually not what you want to do.

You have been warned!

== OPTIONS

*-s, --socket* 'sock_path'::
Overwrites the path to the i3 IPC socket.

*-b, --bar_id* 'bar_id'::
Specifies the bar ID for which to get the configuration from i3. By default,
i3bar will use the first bar block as configured in i3.

*-t, --transparency*::
Enable transparency (RGBA colors)

*-h, --help*::
Display a short help-message and exit

*-v, --version*::
Display version number and exit.

*-V*::
Be verbose.

== DESCRIPTION

*i3bar* displays a bar at the bottom (or top) of your monitor(s) containing
workspace switching buttons and a statusline generated by i3status(1) or
similar. It is automatically invoked (and configured through) i3.

i3bar supports using a JSON protocol for setting the status line, see
https://i3wm.org/docs/i3bar-protocol.html

Since i3 4.23, i3bar supports another JSON protocol for setting workspace
buttons. See https://i3wm.org/docs/i3bar-workspace-protocol.html.

== ENVIRONMENT

=== I3SOCK

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

== EXAMPLES

Nothing to see here, move along. As stated above, you should not run i3bar manually.

Instead, see the i3 documentation, especially the User’s Guide.

== SEE ALSO

+i3status(1)+, +j4status(1)+ or +conky(1)+ for programs generating a statusline.

+dzen2(1)+ or +xmobar(1)+ for similar programs to i3bar.

== AUTHORS

Axel Wagner and contributors