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
       /etc/xdg/openbox/autostart.sh  otherwise.  You  may  place  anything  you  want   to   run
       automatically 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 /etc/xdg/openbox/autostart.sh  file
       as an example for creating your own.

       The default /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 graphical interface,
       however more in-depth configuration is possible by  editing  the  configuration  files  by
       hand.

       The  default configuration and menu files are installed in /etc/xdg/openbox/, and the user
       configuration is placed in ~/.config/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  reload  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 support.

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)