1OPENBOX(1) General Commands Manual OPENBOX(1)
2
3
4
6 openbox — A minimalistic, highly configurable, next generation window
7 manager with extensive standards support.
8
10 openbox [--help] [--version] [--replace] [--reconfigure]
11 [--restart] [--sm-disable] [--sync] [--debug] [--debug-focus]
12 [--debug-xinerama]
13
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
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
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)