Portable BibleDesktop

Introduction

This page gives instructions on how to create a version of BibleDesktop that you can take with you where ever you go. Specific instructions are given for USB Drives and for CD-ROMs, but you can easily use any removable media of 512M to hold Portable BibleDesktop and all of CrossWire's modules.

Layout of Portable BibleDesktop

• BibleDesktop - contains the application
• Java - contains Java for Windows and for Linux (MacOSX 10.3 and later has Java)
• mods.d and modules - are for books (aka modules) for BibleDesktop to use. This is initially empty.

• The BibleDesktop launchers for Windows, Linux and Mac. Run the appropriate one for machine you are running on:
  • Windows - BibleDesktopWin.exe
  • Linux - BibleDesktopLinux.sh
  • Mac - BibleDesktopMac.app
• A lib folder containing the code for BibleDesktop
• A JSword folder that will contain all your preferences, the indexes for modules and various temporary files. This also is initially empty.

Portable BibleDesktop on USB Drive

1. Unzip the portability kit your USB Drive.
2. In the BibleDesktop folder run one of the following depending on what kind of machine you are on:
   • Windows - BibleDesktopWin.exe
   • Linux - BibleDesktopLinux.sh
   • Mac - BibleDesktopMac.app
3. Populate the USB drive with modules by doing one or more of the following:
   • Use BibleDesktop on the USB Drive to download modules.
   • Copy modules that you have already downloaded to mods.d and modules.

Note: Some versions of Linux make it hard to run programs on a USB drive. If that happens to you see BibleDesktop/ReadmeLinux.txt for help.

Portable BibleDesktop on CD-ROM

1. Unzip the portability kit to an empty folder of your choice.
2. In the BibleDesktop folder run one of the following depending on what kind of OS (Operating System) you are on:
   • Windows - BibleDesktopWin.exe
   • Linux - BibleDesktopLinux.sh
   • Mac - BibleDesktopMac.app
3. Set your preferences (aka preferences) that you want to have for startup, using BibleDesktop executable for your OS in the unzipped BibleDesktop folder to set preferences.
4. Populate the mods.d and modules folder that were unzipped with modules by doing one or more of the following:
   • Use BibleDesktop in the unzipped BibleDesktop folder to download modules.
   • Copy modules that you have already downloaded to the empty mods.d and modules folders.
5. Create indexes for Bibles, using BibleDesktop in the unzipped BibleDesktop folder to create indexes.
6. Using your favorite CD burning software copy the folders BibleDesktop, Java, mods.d and modules to the root of the CD.

Note: Because a CD is read-only, BibleDesktop will maintain preferences on each machine you run BibleDesktop on. Additionally, any modules you download with BibleDesktop on CD will be saved to the local machine.