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]    [--sm-disable]    [--sync]   [--debug]   [--debug-focus]
12       [--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  command  line  options  available  and
61                 exit.
62
63       --version Show the version of the program and exit.
64
65       --replace Replace the currently running window manager.
66
67       --config-file FILE
68                 Specify the path to the config file to use.
69
70       --reconfigure
71                 If  Openbox  is  already  running  on the display, tell it to
72                 reload its configuration.
73
74       --restart If Openbox is already running on  the  display,  tell  it  to
75                 restart.  This  is  useful  if  you have upgraded Openbox and
76                 don't want to restart X.
77
78       --exit    Exit Openbox.
79
80       --sm-disable
81                 Do not connect to the session manager.
82
83       --sync    Run in synchronous mode (for debugging).
84
85       --startup CMD
86                 Run CMD after starting.
87
88       --debug   Display debugging output.
89
90       --debug-focus
91                 Display debugging output for focus handling.
92
93       --debug-session
94                 Display debugging output for session management.
95
96       --debug-xinerama
97                 Split the display into two fake xinerama regions, if xinerama
98                 is  not  already enabled. This is for debugging xinerama sup‐
99                 port.
100

SEE ALSO

102       obconf (1), openbox-session(1), openbox-gnome-session(1),  openbox-kde-
103       session(1).
104
105       The   program's   full  documentation  is  available  on  the  website:
106       http://openbox.org/
107
108       Please report bugs to: http://bugzilla.icculus.org/
109
110
111
112
113                                                                    OPENBOX(1)
Impressum