# Introduction To The Module Manager

The "module" is the unit of content in GnomeSword, and Sword generally; a Sword module is a resource available for viewing in Sword applications. There are several varieties: Most importantly, Bible texts, as well as dictionaries and lexicons, commentaries, and general books, including some which have graphical content (e.g. atlases). They are installed either from a local directory structure (such as a CDROM distribution) or remotely via ftp from a server such as Crosswire, which is the home of Sword, and from which all officially Sword-sanctioned modules are available.

If you have other Sword applications installed, they will all share the same set of Sword modules that you install through the Module Manager.

## The Module Manager Dialog

The Module Manager Dialog

# Sword Module Configurations

## Sword Module Installations

### Sword Module Installations

Module Installation

After you have selected your Install Source, click the Refresh button to cause GnomeSword to find the module summary available from that source before moving on.

## Sword Sources Settings

### Sword Sources Settings

Module Installation

There are other repositories available besides Crosswire's own, though the modules available from other repositories do not represent content officially sanctioned by Crosswire. On the web, see this page for list of those repositories known: http://www.crosswire.org/wiki/index.php/Module_Repositories

# Add And Remove Modules

## Adding Sword Modules

### Adding Modules

Module Installation

Modules that are already installed have a checkmark beside them. Locked modules, which require that you purchase an unlock key from the module's copyright holder, will show a lock symbol.

Select new modules to be installed by clicking the checkboxes and then the Install button at the bottom. Any number of modules may be requested for installation at one time. If there are modules installed for which a more recent version is available, a refresh icon will appear between the differing old and new version stamps.

## Removing Sword Modules

### Removing Modules

Removing Modules

Archival is available for any module, although it is provided with personal commentaries specifically in mind. A *.zip of the module is left in the directory ~/.sword/zip. Archival prior to removal of personal commentaries is recommended, in order to be available for future re-install if the subject matter of the personal commentary becomes important again.

# Installing Non-Standard Modules

Some resource modules in Sword Project format are available from sources other than Crosswire. Necessarily, installing such a module is a manual task.

Modules are normally packaged as *.zip files; they contain a configuration file plus a number of data files. Installation of such a module is done by cd'ing to your personal Sword (not GnomeSword) configuration directory, ~/.sword, and unzipping the file there. The configuration file will be left in "mods.d", and the module's data files will go into a subdirectory of "modules". Alternatively, if you have write access to the system Sword directory, typically /usr/share/sword, you may cd there instead before unzipping.

Restart GnomeSword after installing such a module, so that a fresh instance of the program can notice the new module in place.