Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OPENBOX(1)		    General Commands Manual		    OPENBOX(1)

NAME
       openbox	-- A minimalistic, highly configurable,	next generation	window
       manager with extensive standards	support.

SYNOPSIS
       openbox	  [--help]     [--version]     [--replace]     [--reconfigure]
       [--restart]    [--sm-disable]	[--sync]   [--debug]   [--debug-focus]
       [--debug-xinerama]

DESCRIPTION
       Openbox is minimalistic,	highly configurable,  next  generation	window
       manager with extensive standards	support.

       You can start Openbox in	three ways:

       If  you	run  a display manager such as GDM, you	will find 3 entries in
       the login session type menu  for	 Openbox:  GNOME/Openbox,  KDE/Openbox
       and  Openbox.  If  you want to use Openbox within GNOME or KDE, you can
       choose the appropriate entry, and it will  launch  GNOME	 or  KDE  with
       Openbox as the window manager.

       The  third  option  at log in, which is Openbox	     without a session
       manager,	uses the openbox-session       command to  start  Openbox.  On
       log  in,	 openbox will run the ~/.config/openbox/autostart.sh script if
       it exists, and will run the system-wide script /usr/local/etc/xdg/open-
       box/autostart.sh	otherwise. You may place anything you want to run  au-
       tomatically in those files, for example:

	      xsetroot -solid grey &
	      gnome-settings-daemon &

       Make  sure  that	each line is followed by a "&" or else the script will
       stop there and further commands will not	be executed. You can  use  the
       /usr/local/etc/xdg/openbox/autostart.sh file as an example for creating
       your own.

       The  default  /usr/local/etc/xdg/openbox/autostart.sh  runs a number of
       things with Openbox.

       Lastly, if you use startx to launch your	X session, you can  set	 up  a
       ~/.xinitrc  file	 to run	openbox-session	and follow the same directions
       as above	regarding the autostart.sh file.

       You can use the obconf tool to configure	Openbox	easily with a  graphi-
       cal interface, however more in-depth configuration is possible by edit-
       ing the configuration files by hand.

       The  default  configuration  and	 menu  files are installed in /usr/lo-
       cal/etc/xdg/openbox/, and the user configuration	is placed  in  ~/.con-
       fig/openbox/.  You  can	copy  the  default  configuration and menus to
       ~/.config/openbox and edit it to	your liking.

OPTIONS
       These are the possible options that openbox accepts:

       --help	 Show a	summary	of the	command	 line  options	available  and
		 exit.

       --version Show the version of the program and exit.

       --replace Replace the currently running window manager.

       --config-file FILE
		 Specify the path to the config	file to	use.

       --reconfigure
		 If  Openbox is	already	running	on the display,	tell it	to re-
		 load its configuration.

       --restart If Openbox is already running on  the	display,  tell	it  to
		 restart.  This	 is  useful  if	 you have upgraded Openbox and
		 don't want to restart X.

       --exit	 Exit Openbox.

       --sm-disable
		 Do not	connect	to the session manager.

       --sync	 Run in	synchronous mode (for debugging).

       --startup CMD
		 Run CMD after starting.

       --debug	 Display debugging output.

       --debug-focus
		 Display debugging output for focus handling.

       --debug-session
		 Display debugging output for session management.

       --debug-xinerama
		 Split the display into	two fake xinerama regions, if xinerama
		 is not	already	enabled. This is for debugging	xinerama  sup-
		 port.

SEE ALSO
       obconf  (1), openbox-session(1),	openbox-gnome-session(1), openbox-kde-
       session(1).

       The  program's  full  documentation  is	available  on	the   website:
       http://openbox.org/

       Please report bugs to: http://bugzilla.icculus.org/

								    OPENBOX(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=openbox&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help