ROXTerm
Author: Adrian Sampson
Description: ROXTerm, a full-featured VTE terminal emulator

- Home
- News
- Installation
- User Guide
- Forums

# Installation

## Download :

Visit the SourceForge project page to download release files or use other Sourceforge tools. If you want to get developmental versions ahead of releases, use git. For versions prior to 1.19.0 use svn (subversion). The actual command you will probably want to use to check out a snapshot is:

git clone git://roxterm.git.sourceforge.net/gitroot/roxterm/roxterm

## Requirements :

You need the libraries for GTK+2 which is pretty much standard on all free Unix derivatives these days. It definitely needs at least version 2.6 of glib and probably GTK+ 2.6 too. You will also need libglade 2 - usually, but not always installed; libvte, a Gnome component; and D-BUS (see below).

To compile ROXTerm you will need the header files for all the above libraries. In packaging systems they usually come in packages whose names end in "-dev" or "-devel".

Additionally, to build a git checkout of ROXTerm you need autoconf, automake and libtool. Use the latest versions possible. Old versions of automake (older than 1.7?) will cause building to fail because ROXTerm uses per-target CFLAGS.

### D-Bus

D-Bus is a messaging system which ROXTerm uses to connect terminals with its configure tool. ROXTerm uses the "session" bus, which should be started along with your desktop environment. Current versions of ROX, GNOME and KDE session managers all launch D-Bus. If you use some other session/desktop/window manager which doesn't launch D-Bus you can start it by inserting something like this near the start of your .xinitrc or .xsession:

if test -z "$DBUS_SESSION_BUS_ADDRESS" ; then eval `dbus-launch --sh-syntax --exit-with-session` export DBUS_SESSION_BUS_ADDRESS fi

The reason for using a bespoke configuration messaging system over D-Bus instead of gconf is because gconf doesn't provide a way to map an arbitrary number of profiles onto configuration filenames.

## Installing :

To install ROXTerm for ROX all you need to do is unpack the tarball in your Apps directory and run it from there, but you will probably want to rename the folder to ROXTerm. For other systems ROXTerm may be installed in the same way as any autoconf-based source package:

./configure make make install

If you are using a version fetched by git instead of a release tarball run the bootstrap.sh script first to create the configure script and various other files needed for building.

### Debian & Ubuntu

Up-to-date official Debian packages are now available. See http://packages.debian.org/roxterm. For those that want to build their own debian packages, the debian packaging files used to have a separate module in subversion but this has now been merged into the main trunk, and is also included with release tarballs from 1.19.1 onwards.

For instructions on building a debian package refer to the file INSTALL.Debian in the unpacked tarball/git working directory.

Ubuntu also has official roxterm packages, but due to Ubuntu's release cycle these may lag behind the latest upstream releases. Therefore I have set up a PPA at https://launchpad.net/~h-realh/+archive/ppa to provide the most recent releases of ROXTerm for Ubuntu's current release when appropriate.