Software requirements

To compile screenhack you will need These should be available as packages for your Linux distribution, if they are not installed by default.

Getting the source

At present, you can only get screenhack via a SVN checkout:
svn co


You will need to make a build subdirectory and run cmake:
cd screenhack
mkdir build
cd build
cmake ../
If you have a PC with N cores, use
make -jN+1
to speed up compilation. The cmake scripts should detect which Renderman renderer(s) you have installed and compile some display drivers and shaders for them.


This is still not automated. A directory called screenhack will be made in your home directory. The executable will be in the bin subdirectory. The share directory contains plugins used by screenhack.

Initial setup

When you run screenhack for the first time, it will create a directory structure under .screenhack and run a dialog to allow selection of the default renderer and customize some paths used by the renderer.