gri3-wm/man/i3bar.man

i3bar(1)
========
Axel Wagner <mail+i3bar@merovius.de>
v4.1, October 2011

== NAME

i3bar - xcb-based status- and workspace-bar

== SYNOPSIS

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

== 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.

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

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

== 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 colors via a JSON protocol starting from v4.2, see
https://i3wm.org/docs/i3bar-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
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
+								i3bar(1)
 								========
 								Axel Wagner <mail+i3bar@merovius.de>
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								v4.1, October 2011
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
 								== NAME
-												Correct some minor mistakes in the manpage (thx sECuRE)

											
										
										
											2011-07-31 15:58:14 +02:00
+								i3bar - xcb-based status- and workspace-bar
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
 								== SYNOPSIS
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								*i3bar* [*-s* 'sock_path'] [*-b* 'bar_id'] [*-v*] [*-h*]
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								== WARNING
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								i3bar will automatically be invoked by i3 for every 'bar' configuration block.
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								Starting it manually is usually not what you want to do.
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								You have been warned!
-												Implement dock-positioning

											
										
										
											2011-02-21 15:47:58 +01:00
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								== OPTIONS
 								*-s, --socket* 'sock_path'::
 								Overwrites the path to the i3 IPC socket.
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								*-b, --bar_id* 'bar_id'::
 								Specifies the bar ID for which to get the configuration from i3.
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								*-v, --version*::
 								Display version number and exit.
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
 								*-h, --help*::
 								Display a short help-message and exit
 								== DESCRIPTION
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								*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.
-												Mention the color-options in the manpage

											
										
										
											2010-11-04 12:43:33 +01:00
-												i3bar: update manpage for the i3bar-protocol

fixes #739

											
										
										
											2012-08-12 19:25:48 +02:00
+								i3bar supports colors via a JSON protocol starting from v4.2, see
-												Replace http:// with https:// where applicable

The testcases will be updated automatically in a separate commit.

											
										
										
											2017-09-24 10:19:07 +02:00
+								https://i3wm.org/docs/i3bar-protocol.html
-												Mention the color-options in the manpage

											
										
										
											2010-11-04 12:43:33 +01:00
-												Use I3SOCK environment-variable

											
										
										
											2011-01-11 05:02:55 +01:00
+								== ENVIRONMENT
 								=== I3SOCK
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								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.
-												Use I3SOCK environment-variable

											
										
										
											2011-01-11 05:02:55 +01:00
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
+								== EXAMPLES
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								Nothing to see here, move along. As stated above, you should not run i3bar manually.
-												Implement dock-positioning

											
										
										
											2011-02-21 15:47:58 +01:00
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
+								Instead, see the i3 documentation, especially the User’s Guide.
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
 								== SEE ALSO
-												man/i3bar: Reference j4status

											
										
										
											2012-08-04 23:31:38 +02:00
+								+i3status(1)+, +j4status(1)+ or +conky(1)+ for programs generating a statusline.
-												i3bar: update manpage

											
										
										
											2011-10-20 23:55:24 +02:00
 								+dzen2(1)+ or +xmobar(1)+ for similar programs to i3bar.
-												Adding a manpage

											
										
										
											2010-09-17 18:27:07 +02:00
 								== AUTHORS
 								Axel Wagner and contributors