Freely-Given.org Sword Module Installation

Picture of the FG Logo

The Bible Drop Box converts USFM Bibles to OSIS XML, and from there to both uncompressed and compressed Sword Modules (but still needing more testing). Some of the conversion routines don’t handle all USFM codes yet.

The produced Sword Modules can be used by many "front-end" applications on a wide range of desktop, laptop, netbook, phone, and tablet operating systems including Linux, Mac OS X, Windows, Android, and iOS. See here for a list of some of the possibilites.

This page is intended to show users some of the different ways that they can get USFM or OSIS Bibles onto their computers once they are converted to Sword modules. Please send your feedback to help extend and improve these notes.

Installing a Sword Bible module on an Android device

The following instructions worked for me on an Android phone with a SD card:

  1. Use the Bible Drop Box or similar to convert your files to a Sword module.
  2. Navigate to the compressed Sword module folder on the private page listed in the Bible Drop Box response email you received.
  3. Install AndBible onto your Android device from the GooglePlay store.
  4. Make sure that AndBible is storing its data on the SD card. (I can't remember if that's the default or not.)
  5. Plug your Android phone/tablet into computer using a USB cable.
  6. Make sure that the computer recognises the SD card on the phone as a USB drive. (Mac users might need this.)
  7. Open the phone SD-card folder on your computer.
  8. Now we have some alternatives it seems:
    1. From here we're told to: "Expand the module so that the .conf file is in sdcard/jsword/mods.d and the bible files in a subdirectory of sdcard/jsword/modules e.g. sdcard\jsword\modules\texts\ztext\nettext."
  9. This was what I found worked (by trial and error) -- please let us know if you have better instructions to we can update this.
    1. Navigate to the folder: Android / data / net.bible.android.activity / files / mods.d
    2. Copy in the .conf file from the mods.d subfolder of #2 above.
    3. Navigate to the folder: Android / data / net.bible.android.activity / files / modules / texts / ztext
    4. Copy in the folder from the modules/text/ztext subfolder of #2 above.
  10. Issue the command to eject the Android device from your computer.
  11. Unplug the USB cable to the Android.
  12. Run AndBible on the Android and change the Bible version. Choose Undetermined language and then <your language name>.
  13. Enjoy. Share with others.

Installing a Sword Bible module on an Ubuntu Linux computer

The following instructions worked for me on an Ubuntu Linux computer:

  1. Use the Bible Drop Box or similar to convert your files to a Sword module.
  2. Navigate to the compressed Sword module folder on the private page listed in the Bible Drop Box response email you received.
  3. Install a Sword-based program onto your computer -- in my case I used "sudo apt-get install xiphos" (made mostly for Gnome or Unity) but alternatives include BibleTime (made mostly for KDE).
  4. Using the above software, install whatever major language modules interest you. (I found that they get installed in /home/<username>/.sword.) Close the program.
  5. Open the above folder in a window (you might have to display hidden files first) and then navigate to the mods.d subfolder.
  6. Copy in the .conf file from the mods.d subfolder of #2 above.
  7. Navigate to the modules/texts/ztext subfolder of your .sword folder.
  8. Copy in the folder from the modules/text/ztext subfolder of #2 above.
  9. Run your Bible software again.
  10. Look under Biblical Texts in Modules then Unknown (for BibleTime it's Bibles in the Bookshelf and then __LANGUAGE__) and then <your language name>.
  11. Enjoy. Share with others.

Installing a Sword Bible module onto an iOS device

The following instructions worked for a user with a Mac and an Apple iPad:

  1. Use the Bible Drop Box or similar to convert your files to a Sword module.
  2. Navigate to the compressed Sword module folder on the private page listed in the Bible Drop Box response email you received.
  3. Download the files onto your computer.
  4. Install PocketSword onto your iOS device.
  5. Open PocketSword.
  6. In the Preferences menu turn ‘Module Maintainer Mode’ ON.
  7. Go to the Download menu – in the top right corner there should be an icon (asterisk or folder with download symbol). When you click on that, one of the options should be Module Maintainer mode, where you will be given a selection of avenues to upload the files.
  8. On your computer open a browser and go to the designated avenue. It should bring up a list of modules that it finds already installed on the device. There should be a facility to select the compressed file with the new modules to be uploaded. If the upload is successful you will see the new modules in the list of installed modules.
  9. That’s all, but it’s probably wise to turn Module Maintainer Mode OFF again.
  10. Run your Bible software again.
  11. Enjoy. Share with others.

Please use the Contact Page to let us know of any corrections or improvements to these instructions, and/or any other methods to get USFM and OSIS and other Bibles onto people's devices. Thanks.

You may also be interested to read our Bibles on Phones page.