Installation

1. What do I need to use this program?

You will need the following:

The Folding@home client software can be downloaded from the Folding@home site.

2. How do I install the application?

First, get the Folding@home client software for Linux. You can obtain it from the Folding@home site. Copy the executable to a location in your $PATH. I recommend /usr/local/bin. Then, you must set it to be executable:

$ chmod a+x FAH4Console-Linux.exe

Now, you're ready to install the applet. If you downloaded the tar.gz file, entering the following command:

$ tar zxvf kfolding-XXX.tar.gz

If you downloaded the tar.bz2 file, entering the following command:

$ tar jxvf kfolding-XXX.tar.gz

Then enter the following:

$ cd kfolding-XXX
$ ./configure
$ make
$ su -c "make install"

You will be prompted for your root password. Enter it and the installation will complete.

3. I installed the applet but it doesn't appear in the panel applet menu. Where is it?

You're probably running a distribution like Redhat or Xandros that doesn't have KDE installed in the normal way. Perform the steps described above but try specifying the prefix (the location of your KDE installation) when you run configure. It will probably be in either /usr or /usr/local.

$ ./configure --prefix=/usr

Usage

1. Can I run it without running KDE?

Yes, but you must have KDE installed on your system (at least Qt, kdelibs, and kdebase). Then, you can run it in the applet proxy:

$ appletproxy kfoldingapplet

2. I have a computer with more than one processor (SMP) and would like to monitor more than one Folding@home core. Is this possible? How do I do it?

Yes, but there's a trade-off. Folding@home Applet for KDE is designed to monitor only one core at a time so you'll have to run multiple instances of the applet. If you do this and you close the applet, your settings won't be saved. This is the nature of KDE's session management. The only solution is to just leave it running when you log out and when you log in again, your settings will be restored.

To allow running of multiple instance of Folding@home Applet, first close all running instaces of the applet. Then, you'll need to modify the following file as root:

$KDEDIR/share/apps/kicker/applets/kfoldingapplet.desktop

Where $KDEDIR is the location of your KDE installation. This will most likely by /opt but on some systems, such as Redhat, it may be /usr or /usr/local.

Change the following line:

X-KDE-UniqueApplet=true

to

X-KDE-UniqueApplet=false

You'll then be able to run multiple instance. Don't forget to configure each applet to have a unique working directory and Machine Id. Just right-click the applet and select 'Configure Folding@home Applet..." and fill in the data.