How to compile it - Razor-qt/razor-qt GitHub Wiki
Razor-qt uses CMake as its build tool. See Dependencies for the complete list of requirements and Razor-cmake-Options for customizing build parameters.
First, you need to get the source code, either tarball or by cloning the git repository see github help.
Now, suppose you have downloaded the razorqt-0.4.1.tar.bz2
tarball, here are roughly what you should do next (character $
below indicates the shell prompt with normal user privilege)
-
Place the tarball at your working directory, e.g.
~/src/razor
:$ mkdir -p ~/src/razor/ $ cp /where/you/put/the/downloaded/tarball.tar.gz ~/src/razor/
-
Unpack the archive. The new directory would be of something like
razorqt-0.4.1
:$ cd ~/src/razor/ $ tar xf razorqt-0.4.1.tar.gz
-
Make a new directory to perform an out-of-source build (recommended way to build software with CMake):
$ mkdir build
The directory structure is now like the following:
$ ls build razorqt-0.4.1
-
Go to the
build
directory and run cmake:$ cd build $ cmake -DCMAKE_INSTALL_PREFIX=../release ../razorqt-0.4.1
Which means: configure the build to be installed in
~/src/razor/release
as the root directory instead of the default/usr/local/
. -
There are more useful variables to customize. E.g.
-DCMAKE_BUILD_TYPE=debug
compiles razor with debugging symbols... Please see CMake documentation for more details. There are also some Razor related Razor-cmake-Options as well. -
If the configuration phase runs successfully, run
make
andmake install
as usual. However, for better management with package manager, checkinstall is preferred over the traditionalmake install
. Anyway, suit yourself.$ make $ sudo checkinstall # or su -c checkinstall $ # Install the created package if neccessary with dkpg -i in Debian-based system or rpm -Uvh in Fedora/RHEL-based systems, ...
-
After the build process, one way to use Razor-qt is to make use of
.xinitrc
as following$ echo 'exec razor-session -w openbox' > .xinitrc_razor # Using openbox as its window manager, you can choose another one as well.
-
Now, you could run the new Razor-qt session with the following command, the
:1
is used to create a new display so it will not mess up with your current GUI session:$ sudo xinit ~/.xinitrc_razor -- :1 $ # Or su -c 'xinit ~/.xinitrc_razor -- :1' in some other distro