debian man page for i3bar

I3BAR(1)																  I3BAR(1)

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 does not support any color or other markups, so stdin should be plain utf8, one line at a time. If you use i3status(1), you therefore
       should specify output_format = none in the general section of its config file.

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) or conky(1) for programs generating a statusline.

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

AUTHORS
       Axel Wagner and contributors

AUTHOR
       Axel Wagner <mail+i3bar@merovius.de>
	   Author.

  4.1								   October 2011 							  I3BAR(1)