openbox(1)

1OPENBOX(1)                  General Commands Manual                 OPENBOX(1)
2
3
4

NAME

6       openbox  —  A minimalistic, highly configurable, next generation window
7       manager with extensive standards support.
8

SYNOPSIS

10       openbox    [--help]     [--version]     [--replace]     [--reconfigure]
11       [--restart]   [--config-file FILE]  [--sm-disable]  [--sync]  [--debug]
12       [--debug-focus]  [--debug-xinerama]
13

DESCRIPTION

15       Openbox is minimalistic, highly configurable,  next  generation  window
16       manager with extensive standards support.
17
18       You can start Openbox in three ways:
19
20       If  you  run  a display manager such as GDM, you will find 3 entries in
21       the login session type menu  for  Openbox:  GNOME/Openbox,  KDE/Openbox
22       and  Openbox.  If  you want to use Openbox within GNOME or KDE, you can
23       choose the appropriate entry, and it will  launch  GNOME  or  KDE  with
24       Openbox as the window manager.
25
26       The  third  option  at log in, which is Openbox       without a session
27       manager, uses the openbox-session       command to  start  Openbox.  On
28       log  in,  openbox will run the ~/.config/openbox/autostart.sh script if
29       it  exists,  and  will  run  the  system-wide   script   /etc/xdg/open‐
30       box/autostart.sh  otherwise.  You  may  place  anything you want to run
31       automatically in those files, for example:
32
33
34              xsetroot -solid grey &
35              gnome-settings-daemon &
36
37       Make sure that each line is followed by a "&" or else the  script  will
38       stop  there  and further commands will not be executed. You can use the
39       /etc/xdg/openbox/autostart.sh file as an example for creating your own.
40
41       The default /etc/xdg/openbox/autostart.sh runs a number of things  with
42       Openbox.
43
44       Lastly,  if  you  use startx to launch your X session, you can set up a
45       ~/.xinitrc file to run openbox-session and follow the  same  directions
46       as above regarding the autostart.sh file.
47
48       You  can use the obconf tool to configure Openbox easily with a graphi‐
49       cal interface, however more in-depth configuration is possible by edit‐
50       ing the configuration files by hand.
51
52       The   default   configuration   and   menu   files   are  installed  in
53       /etc/xdg/openbox/, and the user  configuration  is  placed  in  ~/.con‐
54       fig/openbox/.  You  can  copy  the  default  configuration and menus to
55       ~/.config/openbox and edit it to your liking.
56

OPTIONS

58       These are the possible options that openbox accepts:
59
60       --help    Show a summary of the options available.
61
62       --version Show the version of the program.
63
64       --replace Replace the currently running window manager.
65
66       --reconfigure
67                 If Openbox is already running on  the  display,  tell  it  to
68                 reload its configuration.
69
70       --restart If  Openbox  is  already  running  on the display, tell it to
71                 restart. This is useful if  you  have  upgraded  Openbox  and
72                 don't want to restart X.
73
74       --config-file FILE
75                 Use  FILE  for configuration instead of looking for rc.xml in
76                 the XDG search path. FILE is an absolute path.
77
78       --sm-disable
79                 Do not connect to the session manager.
80
81       --sync    Run in synchronous mode (for debugging).
82
83       --debug   Display debugging output.
84
85       --debug-focus
86                 Display debugging output for focus handling.
87
88       --debug-xinerama
89                 Split the display into two fake xinerama regions, if xinerama
90                 is  not  already enabled. This is for debugging xinerama sup‐
91                 port.
92

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO