NET installation for JSword version 1.0


The latest JSword 1.0.3 has been specially tailored to include support for the NET bible.  Open tools->books and you will see a bible.org tab.  Open this, and click 'update available books, and you will be presented with a tree showing modules and commentaries.  In the first instance, download Bible/English/NETfree and give it a try.  Later, you may wish to take the 'for pay' NET module.  This will need unlocking.  Go to the installed books in the tools->books window, and you will see an unlock button.  Click this and you will be able to enter the key you have purchased.  Be sure you get it absolutely correct.  If the incorrect key is entered, the NET bible will not show.  If this happens, go back to the NET bible in the Tools->books window, and you will see the key you have entered displayed there.  You can then check and edit the key.  Make sure you have all alphabetic characters entered in the correct case.

If you have an existing Sword installation, and the path to your Sword installation is properly set up in BibleDesktop, JSword will discover and use any modules or module cipher keys that are installed in the ~/.sword/mods.d or modules directories.  You got to Tools->options and click on Sword books, where you can edit to path to point to your Sword directory.  If you are unsure as to where this is, try looking searching for mods.d and modules.  You should find both of these in a directory called jsword and a further set in a directory whch normally includes the word 'sword' in the path.  This is the path to include. You can use the Bible Desktop book manager, or the Bibletime or Gnomesword Module Managers or Windows Install Manager to download and update modules if they are already available on your system.  Once Install Manager has installed the modules for you, JSword, if configured correctly, will recognise the NET modules and display them properly. 

Most of the installation instructions below are specific to Linux, although advanced Windows users should be able to interpret them and recognise the Windows commands that replace the Unix commands.

The following instructions apply to manual installation of the modules and are for advanced users only.

If you are using Windows and need to edit the .conf files manually, you will need to use a programmer's editor such as the free Xint editor.  Windows notepad inserts extra characters and will not unlock the module.

If you do not have BibleTime, GnomeSword or Sword for Windows, you can still download the NETfree.zip, NETnotesfree.zip, NET.zip, or Netnotes.zip module files from ftp.bible.org/sword/packages/rawzip and install them manually.

From a console (cut and paste):
cd ~/.sword

The following is for the Premium versions - all one line:

wget ftp.bible.org/sword/packages/rawzip/NET.zip ftp.bible.org/sword/packages/rawzip/NETnotes.zip

This is for the free versions - all one line:

wget ftp.bible.org/sword/packages/rawzip/NETnotesfree.zip ftp.bible.org/sword/packages/rawzip/NETfree.zip

If the unzip utility is in your path:
unzip -x -n NET
unzip -x -n NETnotes
or
unzip -x -n NETnotesfree
unzip -x -n NETfree

If you are using the Premium versions of the NET Bible and Notes change directory and edit the .conf files:

cd mods.d

Alternatively in Nautilus or Konqueror select View > Show Hidden Files, navigate to the .zip files in the ~/.sword directory and right-click select extract here from the pop-up context menu. Ark will notify you that the mods.d and modules directories won't be extracted if they already exist - just click the Continue button.

*Note*: If you wish to use the premium NET modules, you will have to edit the configuration files ~/.sword/mods.d/NET.conf and ~/.sword/mod.d/NETnotes.conf. Just enter your key number with no extra spaces on the line in those files that begins with: CipherKey=. For example:

      BlockType=Book
      CipherKey=9999FFfF9999FfFF
      CompressType=ZIP


From the console: cd ~/.sword/mods.d and use a text editor such as vim, emacs, mcedit, and etc. Alternatively, in either Nautilus or Konqueror navigate to the .conf files and right click on them. Select a text editor like gedit or kedit from the pop-up context dialog. Enter your key number and File > Save your changes.

You may wish to backup your NET.conf and NETnotes.conf files as these contain the CipherKey. If you re-install the Sword modules for any reason they will be lost or overwritten and you can simply copy your backup into the mods.d directory.

Thanks to hwilkerson for these instructions