Help:Installing

From Openbox

(Difference between revisions)
Jump to: navigation, search
(For 64-bit distributions)
(Building and installing the program)
 
(One intermediate revision by one user not shown)
Line 53: Line 53:
 
== Building and installing the program ==
 
== Building and installing the program ==
  
Once you have the above dependancies installed, you are ready to build Openbox. Untar the Openbox archive and from inside the source tree, run:
+
Once you have the above dependancies installed, you are ready to build Openbox.  
  
 +
You can obtain the source code from github.com (or as through tar archives (eg. linux from scratch)):
 +
<code><pre>
 +
  % git clone https://github.com/Mikachu/openbox.git
 +
</pre></code>
 +
 +
Run bootstrap script to obtain configuration scripts
 +
<code><pre>
 +
  % ./bootstrap
 +
</pre></code>
 +
 +
Then run:
 
<code><pre>
 
<code><pre>
 
   % ./configure --prefix=/usr --sysconfdir=/etc
 
   % ./configure --prefix=/usr --sysconfdir=/etc
Line 86: Line 97:
 
# make install
 
# make install
 
</pre></code>
 
</pre></code>
 +
 +
=== Tips for Developing and Using Openbox at the Same Time ===
 +
There are several ways of having two xserver sessions at once.
 +
 +
One of these is using Xephyr to create a nested window:
 +
 +
<code><pre>
 +
  % Xephyr -br -ac -noreset -screen 640x320 :1
 +
</pre></code>
 +
 +
And then running your second ammended openbox in this display:
 +
 +
<code><pre>
 +
  % DISPLAY=:1 ./openbox
 +
</pre></code>
 +
 +
(the line above assumes you're in the directory of where the openbox binaries lie)

Latest revision as of 00:27, 6 May 2017

Contents

[edit] Dependencies

Compiling Openbox should be a relatively painless experience. You will need the following packages:

  • C compiler (such as GCC)
  • Libc library and headers (development package)
  • Xlib library and headers (development package)
  • Xext and Xrandr library and headers (development package) - optional but recommended
  • Glib-2 library and headers (development package)
  • LibXML-2 library and headers (development package)
  • Pango library and headers (development package)
  • Imlib2 (development package) - optional but recommended
  • Startup-notification library and headers (development package) - optional but recommended
  • XCursor library and headers (development package) - optional but recommended
  • Pkg-config

These should all be available through your distribution.

[edit] Dependencies in Ubuntu and Debian

In Ubuntu and Debian, install the following packages:

  • build-essential
  • pkg-config
  • libpango1.0-dev
  • libglib2.0-dev
  • libxml2-dev
  • libxcursor-dev
  • libimlib2-dev
  • libstartup-notification0-dev
  • xlibs-dev
  • libxext-dev
  • x11proto-randr-dev

Note: 'xlibs-dev' is no longer available in in Ubuntu 8.04 LTS 'Hardy' repositories, but 'xlibs-static-dev' is.

If you want to hook in the Debian menu, you'll also want:

  • menu
  • menu-xdg

[edit] Dependencies in Fedora

In Fedora Core 6 or Fedora 7, install the following packages:

  • gcc
  • autoconf
  • automake
  • glib2-devel
  • pango-devel
  • imlib2-devel
  • startup-notification-devel
  • libXcursor-devel
  • libXfixes-devel
  • libSM-devel
  • libxml2-devel

[edit] Building and installing the program

Once you have the above dependancies installed, you are ready to build Openbox.

You can obtain the source code from github.com (or as through tar archives (eg. linux from scratch)):

  % git clone https://github.com/Mikachu/openbox.git

Run bootstrap script to obtain configuration scripts

  % ./bootstrap

Then run:

  % ./configure --prefix=/usr --sysconfdir=/etc
    ...configure detects the build evironment...
  % make
    ...openbox builds...
  % sudo make install
    ...openbox installs...

If you do not want to install to /usr, then you should use ./configure --prefix=<whatever you want> --sysconfdir=/etc --datarootdir=/usr/share. If you don't do this, the Openbox log in options will not be available, because they need to be installed to /usr/share/xsessions.

If the configure command fails and the reason is not obvious, you should look in the generated config.log file to discover the cause of the problem.

[edit] For 64-bit distributions

When building Openbox on the 64-bit versions of Debian or Fedora, use:

  % ./configure --prefix=/usr --sysconfdir=/etc --libdir=/usr/lib64
  % make
  % sudo make install

[edit] For CentOS 5.3

# yum install automake autoconf glib2-devel pango-devel startup-notification-devel libXcursor-devel libXfixes-devel libSM-devel libxml2-devel gcc-c++.i386 gcc.i386

# ./configure --prefix=/usr --sysconfdir=/etc 

# make

# make install

[edit] Tips for Developing and Using Openbox at the Same Time

There are several ways of having two xserver sessions at once.

One of these is using Xephyr to create a nested window:

  % Xephyr -br -ac -noreset -screen 640x320 :1

And then running your second ammended openbox in this display:

  % DISPLAY=:1 ./openbox 

(the line above assumes you're in the directory of where the openbox binaries lie)

Personal tools