# How to install and use &swordInstmgr;

&swordInstmgr; is not provided with the &bibletime; .rpm. You need to download the source tarball from the &crosswire;. A precompiled copy of &swordInstmgr; is included on the &sword; CD which can be obtained from the &crosswire;

## Requirements for &swordInstmgr;

All of the packages required for &swordInstmgr; to compile are included in the major &Linux; distributions. It is also possible to compile &swordInstmgr; on most &UNIX; distributions. If you encounter compile errors, please read the messages, they should lead you to missing packages which you will probably find on your installation disks.

The following table contains the minimum requirements for &swordInstmgr; binaries to run, or for the source version to compile.

### Packages required for &swordInstmgr;

Package | Location
--- | ---
&sword; | Use the version provided with your copy of &sword;. Must be configured (in the file ~/sword/Makefile.cfg) with the VCL libraries = yes
GTK | If you are compiling &swordInstmgr;, any version of GTK should work.

## &swordInstmgr;

To compile &swordInstmgr; first &sword; must have been compiled. See the instructions for &sword;.

Find the file `libsword.so`, &sword; probably installed it to `/usr/local/sword/lib` unless you customized the installation.

In order that &swordInstmgr; (and also &bibletime;) can find this shared library open a text editor and add `/usr/local/sword/lib` to the end of `/etc/ld.so.conf`.

Now you are ready to compile &swordInstmgr;.

CD to your &sword; source and open the directory `.../sword/apps/X11/InstallMgr`. Now in a shell do:

    	ldconfig
    	./configure
    	make
    	su
    	make install

Now in a shell as root (su) you can run installmgr by typing `/usr/local/bin/installmgr`.

If this was successful, there are two options for loading text modules into &sword;.

- Options -> Manage remote sources -- Connect to Crosswire by modem and download sword documents and modules from the crosswire repository. This is a feature that has not yet been ported to &Linux; and &UNIX;.

- Options -> Local Path -- If you have unzipped sources, point this to your local module repository. The local repository may be on a local or networked hard drive, or the &sword; CD mounted on a local or networked CD ROM drive. All of the available modules will be displayed, and may now be installed.

&sword; CD's can be obtained from the Crosswire Bible Society

## Setting up your repository

If you have the &sword; CD, you can skip this step. The texts are stored on the CD uncompressed, and are accessed directly from installmgr under the manage remote sources tab.

Download modules from &crosswire; use the zipped up modules (modulename.zip), not the windows executable compressed files (modulename.exe).

Create a directory for your module repository, `$HOME/sword_modules` for example.

Open a program that can uncompress zip files. Such as gnozup or archiver. Command line tools can also be used, to find which ones are installed on your system do a `man -k zip`

Use your unzipping program to extract the module files into `$HOME/sword_modules`. All of the files will be placed into the correct subdirectories. If you wish to add modules later remember to unzip to `$HOME/sword_modules`.

## Setting up the &sword; configuration file.

Instructions for the &sword; configuration file can be found in the section "The &sword; configuration file" which covers the manual installation of the &sword; modules.

## Using &swordInstmgr; to load sword modules.

You must start &swordInstmgr; as root for it to be able to load modules. Start it with these commands:

    	[me@localhost user]$ su
    	Password:
    	[root@localhost user]# /usr/local/bin/installmgr

You will now see the installmgr window. You will need to use options>local path to point to your local module repository.

Now the available modules will be shown on the left pane and the installed modules on the right. All you need to do is select modules in the left pane and click install to make them available to &sword; and &bibletime;. &swordInstmgr; screenshot