source: x/wm/openbox.xml@ 83bf104

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 83bf104 was 83bf104, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

Tags and a url update

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11189 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 13.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY openbox-download-http
8 "http://openbox.org/dist/openbox/openbox-&openbox-version;.tar.gz">
9 <!ENTITY openbox-download-ftp " ">
10 <!ENTITY openbox-md5sum "00441b53cf14c03566c8e82643544ff9">
11 <!ENTITY openbox-size "9 MB">
12 <!ENTITY openbox-buildsize "18 MB">
13 <!ENTITY openbox-time "0.3 SBU">
14]>
15
16<sect1 id="openbox" xreflabel="openbox-&openbox-version;">
17 <?dbhtml filename="openbox.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>openbox-&openbox-version;</title>
25
26 <indexterm zone="openbox">
27 <primary sortas="a-openbox">Openbox</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to openbox</title>
32
33 <para>
34 <application>Openbox</application> is a highly configurable desktop
35 window manager with extensive standards support. It allows you to control
36 almost every aspect of how you interact with your desktop.
37 </para>
38
39 &lfs73_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&openbox-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>Download MD5 sum: &openbox-md5sum;
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download size: &openbox-size;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Estimated disk space required: &openbox-buildsize;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated build time: &openbox-time;
65 </para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">Openbox Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required">
73 <xref linkend="x-window-system"/> and
74 <xref linkend="pango"/> (compiled with support for libXft).
75 </para>
76
77 <bridgehead renderas="sect4">Optional</bridgehead>
78 <para role="optional">
79 <xref linkend="imlib2"/> (to enable icons in the right click menu).
80 </para>
81
82 <para condition="html" role="usernotes">
83 User Notes: <ulink url="&blfs-wiki;/openbox"/>
84 </para>
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of Openbox</title>
89
90 <note><para>If XORG_PREFIX is not <filename class='directory'>/usr</filename>,
91 tell <command>gcc</command> about it:</para>
92
93 <screen><userinput>export LIBRARY_PATH=$XORG_PREFIX/lib</userinput></screen>
94 </note>
95
96 <para>
97 Install <application>Openbox</application> by running the following
98 commands:
99 </para>
100
101<screen><userinput>./configure -&#45;prefix=/usr -&#45;sysconfdir=/etc -&#45;disable-static \
102 -&#45;docdir=/usr/share/doc/openbox-&openbox-version; &amp;&amp;
103make</userinput></screen>
104
105 <para>
106 To test the results, issue: <command>make check</command>.
107 </para>
108
109 <para>
110 Now, as the <systemitem class="username">root</systemitem> user:
111 </para>
112
113<screen role="root"><userinput>make install</userinput></screen>
114 </sect2>
115
116 <sect2 role="commands">
117 <title>Command Explanations</title>
118
119 <para>
120 <option>-&#45;sysconfdir=/etc</option>: This option puts
121 <application>Openbox</application>'s configuration files in
122 /etc/xdg/openbox instead of /usr/etc/xdg/openbox.
123 </para>
124
125 <para>
126 <option>-&#45;disable-static</option>: This option stops it compiling
127 static versions of the libraries.
128 </para>
129
130 <para>
131 <option>-&#45;docdir=/usr/share/doc/openbox-&openbox-version;</option>:
132 this puts a few files in a versioned directory in
133 <filename class="directory">/usr/share/doc</filename>.
134 </para>
135 </sect2>
136
137 <sect2 role="configuration">
138 <title>Configuring Openbox</title>
139
140 <sect3 id="openbox-config">
141 <title>Config Files</title>
142
143 <para>
144 /etc/xdg/openbox/menu.xml, /etc/xdg/openbox/rc.xml,
145 ~/.config/openbox/menu.xml and ~/.config/openbox/rc.xml
146 </para>
147
148 <indexterm zone="openbox openbox-config">
149 <primary sortas="e-AA.menu">~/.config/openbox/menu.xml</primary>
150 </indexterm>
151
152 <indexterm zone="openbox openbox-config">
153 <primary sortas="e-AA.rc">~/.config/openbox/rc.xml</primary>
154 </indexterm>
155
156 <indexterm zone="openbox openbox-config">
157 <primary sortas="e-etc-path-menu">/etc/xdg/openbox/menu.xml</primary>
158 </indexterm>
159
160 <indexterm zone="openbox openbox-config">
161 <primary sortas="e-etc-path-rc">/etc/xdg/openbox/rc.xml</primary>
162 </indexterm>
163 </sect3>
164
165 <sect3><title>Configuration Information</title>
166
167 <para>
168 <application>Openbox</application>'s right click menu can be used to
169 launch programs. The menu itself is configured with 2 files,
170 <filename>/etc/xdg/openbox/menu.xml</filename> and
171 <filename>~/.config/openbox/menu.xml</filename>. To make changes to the
172 menu, copy /etc/xdg/openbox/menu.xml to ~/.config/openbox/menu.xml and
173 edit it:
174 </para>
175
176<screen role="user"><userinput>cp -rf /etc/xdg/openbox ~/.config</userinput></screen>
177 <para>
178
179 <filename>~/.config/openbox/menu.xml</filename> can be edited with a
180 text editor or you can install
181 <ulink url="http://obmenu.sourceforge.net/">Obmenu</ulink> (requires
182 <ulink url="http://pyxml.sourceforge.net/topics/">pyxml</ulink>
183 and <xref linkend="pygtk"/>).
184 </para>
185
186 <para>
187 To have icons in your right click menu requires installing
188 <xref linkend="imlib2"/> before you install
189 <application>Openbox</application>. To set an icon for an entry in the
190 menu edit <filename>~/.config/openbox/menu.xml</filename> and add an
191 icon to the &lt;item&gt; tag like this:
192 </para>
193
194<screen>&lt;item label="Mplayer" icon="/usr/share/pixmaps/mplayer.png"&gt;</screen>
195
196 <para>
197 Many other aspects of <application>Openbox</application>'s behaviour are
198 configured with <filename>~/.config/openbox/rc.xml</filename> such as
199 what keybindings are used to launch programs or which mouse button
200 launches the main menu.
201 </para>
202
203 <para>
204 Details of the theme that <application>Openbox</application> applies to
205 window decorations are configured in
206 <filename>~/.config/openbox/rc.xml</filename>. You can get a list of the
207 available themes with the command:
208 </para>
209
210<screen role="user"><userinput>ls -d /usr/share/themes/*/openbox-3 | sed 's#.*es/##;s#/o.*##'</userinput></screen>
211 </sect3>
212
213 <sect3 id="openbox-init">
214 <title>Starting Openbox</title>
215
216 <para>
217 To automatically start <command>openbox</command> when you start
218 <application>Xorg</application>:
219 </para>
220
221<screen role="user"><userinput>echo openbox &gt; ~/.xinitrc</userinput></screen>
222
223 <para>
224 If you want to set a background image to your desktop you can use
225 <xref linkend="display"/> and launch it from ~/.xinitrc just before
226 openbox:
227 </para>
228
229<screen role="user"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "HERE_DOC"
230display -backdrop -window root /path/to/beautiful/picture.jpeg
231exec openbox
232HERE_DOC</userinput></screen>
233
234 <para>
235 Or if you like a bit of variety, put a selection of images in a folder
236 (in this example, the directory ~/.config/backgrounds) and choose one at
237 random each time you <command>xinit</command>:
238 </para>
239
240<screen role="user"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "HERE_DOC"
241# make an array which lists the pictures:
242picture_list=(~/.config/backgrounds/*)
243# create a random integer between 0 and the number of pictures:
244random_number=$(( ${RANDOM} % ${#picture_list[@]} ))
245# display the chosen picture:
246display -backdrop -window root "${picture_list[${random_number}]}"
247exec openbox
248HERE_DOC</userinput></screen>
249
250 <para>
251 If you like to have the numlock key set whan you start Xorg, install
252 <ulink url="http://home.kde.org/~seli/numlockx/">Numlockx</ulink> and
253 add that to your xinitrc. Another useful application is
254 <xref linkend="dbus"/>
255 </para>
256
257<screen role="user"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "HERE_DOC"
258. /etc/profile
259picture_list=(~/.config/backgrounds/*)
260random_number=$(( ${RANDOM} % ${#picture_list[*]} ))
261display -backdrop -window root "${picture_list[${random_number}]}"
262numlockx
263eval $(dbus-launch --auto-syntax --exit-with-session)
264lxpanel &amp;
265exec openbox
266HERE_DOC</userinput></screen>
267 </sect3>
268 </sect2>
269
270 <sect2 role="content">
271 <title>Contents</title>
272
273 <segmentedlist>
274 <segtitle>Installed Programs</segtitle>
275 <segtitle>Installed Libraries</segtitle>
276 <segtitle>Installed Directories</segtitle>
277
278 <seglistitem>
279 <seg>
280 gdm-control, gnome-panel-control, obxprop, openbox,
281 openbox-gnome-session, openbox-kde-session and openbox-session
282 </seg>
283 <seg>
284 libobrender.so and libobt.so
285 </seg>
286 <seg>
287 /etc/xdg/openbox, /usr/include/openbox,
288 /usr/share/doc/openbox-&openbox-version; and /usr/share/themes.
289 </seg>
290 </seglistitem>
291 </segmentedlist>
292
293 <variablelist>
294 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
295 <?dbfo list-presentation="list"?>
296 <?dbhtml list-presentation="table"?>
297
298 <varlistentry id="gdm-control">
299 <term><command>gdm-control</command></term>
300 <listitem>
301 <para>
302 is a command line tool to send signals to
303 <application>GDM</application>.
304 </para>
305 <indexterm zone="openbox gdm-control">
306 <primary sortas="b-gdm-control">gdm-control</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="gnome-panel-control">
312 <term><command>gnome-panel-control</command></term>
313 <listitem>
314 <para>
315 is a command line utility to invoke the <application>Gnome
316 Panel</application> run dialog/menu.
317 </para>
318 <indexterm zone="openbox gnome-panel-control">
319 <primary
320 sortas="b-gnome-panel-control">gnome-panel-control</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="obxprop">
326 <term><command>obxprop</command></term>
327 <listitem>
328 <para>
329 is a tool for displaying the properties on an x window. It has a
330 similar functionality to <command>xprop</command>, but allows you to
331 see UTF-8 strings as text.
332 </para>
333 <indexterm zone="openbox obxprop">
334 <primary sortas="b-obxprop">obxprop</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 <varlistentry id="openbox-prog">
340 <term><command>openbox</command></term>
341 <listitem>
342 <para>
343 is a standards compliant, highly configurable, window manager.
344 </para>
345 <indexterm zone="openbox openbox">
346 <primary sortas="b-openbox">openbox</primary>
347 </indexterm>
348 </listitem>
349 </varlistentry>
350
351 <varlistentry id="openbox-gnome-session">
352 <term><command>openbox-gnome-session</command></term>
353 <listitem>
354 <para>
355 is a script to launch an <application>Gnome</application> session
356 with openbox as your window manager from your
357 <filename>~/.xinitrc</filename>.
358 </para>
359 <indexterm zone="openbox openbox-gnome-session">
360 <primary
361 sortas="b-openbox-gnome-session">openbox-gnome-session</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="openbox-kde-session">
367 <term><command>openbox-kde-session</command></term>
368 <listitem>
369 <para>
370 is a script to launch an <application>KDE</application> session with
371 <application>Openbox</application> as your window manager from your
372 <filename>~/.xinitrc</filename>.
373 </para>
374 <indexterm zone="openbox openbox-kde-session">
375 <primary
376 sortas="b-openbox-kde-session">openbox-kde-session</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="openbox-session">
382 <term><command>openbox-session</command></term>
383 <listitem>
384 <para>
385 is a script to launch an <application>Openbox</application> session
386 from your <filename>~/.xinitrc</filename>.
387 </para>
388 <indexterm zone="openbox openbox-session">
389 <primary sortas="b-openbox-session">openbox-session</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="libobrender">
395 <term><filename class="libraryfile">libobrender.so</filename></term>
396 <listitem>
397 <para>
398 contains the functions used by <application>Openbox</application>
399 for theme rendering.
400 </para>
401 <indexterm zone="openbox libobrender">
402 <primary sortas="c-libobrender">libobrender.so</primary>
403 </indexterm>
404 </listitem>
405 </varlistentry>
406
407 <varlistentry id="libobt">
408 <term><filename class="libraryfile">libobt.so</filename></term>
409 <listitem>
410 <para>
411 is the <application>Openbox</application> toolkit library.
412 </para>
413 <indexterm zone="openbox libobt">
414 <primary sortas="c-libobt">libobt.so</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418 </variablelist>
419 </sect2>
420</sect1>
Note: See TracBrowser for help on using the repository browser.