Quick Start Instructions

These instructions are designed to get you up and started with Bible+ quickly, for more detailed instructions, please read the other sections of this manual:

  1. From the Files page (http://palmbibleplus.sourceforge.net/files.htm) download the latest version of Bible+.
  2. After you have downloaded Bible+ to your computer hard drive, RIGHT CLICK and choose Extract to Folder
  3. You will then have a folder beside the ZIP file that you have just downloaded. Within that folder, double click the file named PalmBible_eng.prc. You will then be asked if you want to install this program during the next HotSync, choose YES.
  4. From the Bibles Page (http://palmbibleplus.sourceforge.net/bibles.htm); download a bible that you desire to have for your Bible+. You must have at least one bible installed for Bible+ to work.
  5. After you have downloaded that bible to your hard drive, RIGHT CLICK and choose Extract to Folder.
  6. You will then have a second folder. Within this folder will be the bible that you just downloaded. Double click on it and choose to install it during the next HotSync.
  7. HotSync your Palm OS PDA
  8. You will notice on your Palm OS PDA that you have an icon for Bible+. You can now enjoy Bible+ on your Palm OS PDA. For more detailed explanation of the different functions of Bible+, please read the rest of this user manual. For any questions or concerns, please direct those to the Bible+ Forum (http://palmbibleplus.sourceforge.net/forums.htm).


Downloading and Installing Palm Bible+

To download Palm Bible+, please visit the Files page (http://palmbibleplus.sourceforge.net/files.htm) and download the latest version*. Palm Bible+ is contained within a .zip file format. To unzip, use a program such as WinZip. That program will extract the files and place them onto a folder on your computer's hard drive. Identify where you unzipped the program and open the Palm Bible+ folder and open the folder.

PalmBible+ is distributed in three different versions:

Full This is the full suite of Palm Bible+. It includes versions for other languages, fonts, plugins, and snapshots for use with Palm Bible+. It also includes tools for creating fonts and snapshots.
Minimal This is the minimum of programs that would be used to run Palm Bible+ on your Palm OS device. It contains only the English version, fonts, and a few of the skins.
Sources + Binaries

This is the complete distribution of Palm Bible+. It is meant for those who will be developing for Palm Bible+. It contains all that is included within the Full version, plus the source files and binaries which are used to create and modify modules for Palm Bible+.

Please note that Palm Bible+ is licensed under the GPL, pursuant being a fork of BibleReader (http://www.asaisoft.com/), which was under GPL. Any modifications to the program should include references to Palm Bible+. For more information about the GPL and its rules of use, please visit http://www.gnu.org/copyleft/gpl.html.

*From time to time there will be beta (or testing) versions of Palm Bible+ available from the Bible+ Forum (http://palmbibleplus.sourceforge.net/forums.htm). Features within these Beta versions are NOT documented within this manual. Please see the corresponding forum announcement thread for updated features. Use these beta versions at your own risk. For the best stability, use the latest non-beta versions of Palm Bible+.


Getting Started

Within Palm Bible+, there are four versions of the program designed to meet the needs of nearly all Palm OS users. Below, you will find the names of each of the versions of Palm Bible+ and their purposes.

Palm OS Version Palm Bible+ Name Description
For Palm OS 5 and above Palmbible_eng.prc This is the regular version of the Palm Bible+ program and includes fonts at regular size..
Palmbible_eng_big.prc This is the same as the above, but it also includes the large Greek and Hebrew fonts for viewing those manuscripts.
For all versions of the Palm OS Palmbible_eng_lite.prc This version is not optimized for Palm OS5 and works best with Palm OS 4 devices.
Palmbible_eng_xlite.prc This version is an even further slimmed down lite version that works on Palm OS 3.5 devices, and may work on some Palm OS 3.3 devices.

To install, double click on the version of Palm Bible+ that best suits your device. If you are not sure as to which one would work for you, install Palmbible_eng.prc. HotSync your device to install Palm Bible+.

NOTE: If you are upgrading your version of Bible+, DO NOT install the new version over the old one. Doing so may compromise the stability of your Palm OS device, or cause features within Bible+ not to work properly. Use a file manager program such as Filez (nosleep.net) to delete the two files PalmBible_eng.prc (or similar name) and PBLPConfig from your device. Doing so will ensure that Bible+, as well as your Palm OS PDA, will work correctly.

NOTE #2: If you are upgrading from a previous version of Bible+ and want to keep your bookmarks and snapshots:


Bibles

For Palm Bible+ to be used, you must have at least one bible installed. Bibles can be downloaded from the Bibles page (http://palmBibleplus.sourceforge.net/Bibles.htm). Once you have downloaded the Bible(s) that you would like to use, follow the same steps as above for installing PalmBible+ during the HotSync.

Palm Bible+ can support up to 48 Bibles/commentaries. For inquiries about specific Bible versions please visit our Forums. If you would like to create your own Bible for use within Palm Bible+, please visit the Create Your Own Bible page (http://palmBibleplus.sourceforge.net/createBible.htm) at the Palm Bible+ website.

If you are using the palmOne Tungsten T5 or the Sony Clie UX40 and UX50 models, you will need to place the Cross References file within the Internal Flash Memory, and NOT on your Secure Digital or Memory Stick Memory Cards.

Please note that Bibles purchased for other Bible readers (Olive Tree, Landarin, etc.) will not work under Bible+. To obtain permission to use most modern versions (Amplified, New Living, New International, New King James, etc.), please contact the publisher of the respective versions.


Optional Programs Supported by Palm Bible+

Palm Bible+ has come about because of the work of many different programmers. Some have added to the functionality of Palm Bible+ by the addition of some features. These features, included with all distributions of Palm Bible+, are listed below.

Feature Description
Snapshots Snapshots allow you to save a search, or a page of scriptures for later reference. There is one sample snapshot included within the Palm Bible+ download.

Skins
Skins allow you to change the appearance of the menu. You can add a cross icon, high resolution graphics, or customize icons. There are two skins that are included with the Palm Bible+ download: hiresskin.prc and crossskin.prc.

Fonts

Palm Bible+ supports the use of fonts to change the appearance of text within the program. To install a font, double click on the font on your computer, HotSync it to your Palm OS device, and then go to the Menu > Options > Skins and Plugins and select the font that you wish to use. Please note that you can only have one Hebrew and one Greek font active at any one time.

Also choose font by writing two letters: the first represents location
(either "t" for top or "b" for bottom) and the second represents a font
("h" for Hebrew, "g" for Greek, and "s" for standard). For example, "ts" sets the top-viewer to use the standard font.

Cross References

As with print Bible, cross references allow you to view several scripture references for a particular verse. The cross references file can be downloaded from http://prdownloads.sourceforge.net/palmBibleplus/tsk.pdb?download. It can be installed within the RAM or on a storage card within the PALM/Launcher directory.

To access Cross References from Bible+, double click on the verse number that appears on the left side of the screen (not the one in the title). Make sure that you have the TSK file installed to either the Launcher folder on your SD card, or within the internal memory.

If you are using the Palm Tungsten T5 or the Sony Clie UX40 and UX50 models, you will need to place the Cross References file within the Internal Flash Memory, and NOT on your Secure Digital or Memory Stick Memory Cards.

Plucker Plugin Interface (PPI)

The Plucker Plugin Interface (PPI) was created by Alexander Pruss (http://www.prussfamily.us/PPI.html) as a means to use Road Lingua (http://www.absoluteword.com/) or BDicty (http://www.beiks.com) resources in concert with Palm Bible+.

To use PPI, you must first download it from http://www.prussfamily.us/PPI.html; then HotSync it to install it to your handheld. Open PPI from your Palm OS device; choose the program to look up the word in (if BDicty, choose custom and then write BDicty in the Name line); and check clipboard (for BDicty users, make sure to write 212 in the Command CustomBase+ line); click save and exit PPI. Enter Palm Bible+ and select Menu > Options > Preferences; from the top right drop down menu, select Interface, check both boxes; hit OK.

To activate PPI, double click on the word that you want to know the meaning of within Bible+. It will then copy the word to the clipboard, and then to your dictionary program and show you the definition. NOTE: if you have multiple dictionaries, you may have to specify which dictionary that you are using after the dictionary has come up.

Text to Speech (OS5 devices only)

Requires 6 mb of RAM plus 2 mb of dynamic heap, an OS 5 device with Palm standard sound support, and the free Talking Moose program (http://www.geocities.com/nagamatu/Moose/). You can use the controls menu to assign speech to something sensible, and you can adjust the volume control via the Interface pane of the Preferences.

Speedy Search

Lightspeed overclocking support for searching. If you have the Lightspeed overclock utility installed (http://www.clievideo.com/default.asp?item=3&intProductID=3), Bible+ will automatically switch into HIGH speed mode when searching, and come back to the speed you set for Bible+ for all other operations. This lets you set a low CPU speed for Bible+ in Lightspeed to save battery power, but while searching, when high CPU speed is really needed, Bible+ will automatically switch to high speed.


Using Palm Bible+

Now that you have installed Palm Bible+ (and possibly some of its options); here is an explanation of the features of Palm Bible+ and how to use them.


The User Interface

When you first open Palm Bible+, you have a splash screen that tells you the version of Palm Bible+ that you are running, plus a scripture of encouragement. You are then greeted with the scripture and menu icons at the top of the screen.

(from left to right)

The Current Book, Chapter, and Verse  
The Swap Split Windows Button Used to swap the contents of the windows while in the Dual View Mode
The Select Bible Button Used to select which Bible is to be used (up to 48 Bibles/commentaries can be in this menu)
The Go To Book Button Used to go to a specific book
The Find Button Used to search for words or phrases within the currently active Bible
The View Bookmarks Button Used to show all bookmarks the user has saved
The Navigate Snapshots Button Used to show all the snapshots the user has saved
The Toggle Split Button Used to switch between two versions of Bibles/commentaries within Bible+


Navigation

Bible+ was designed with the general and advanced Bible reader in mind. Therefore, navigation throughout Bible+ follows a simple mindset of allowing the user to do many things with either icon taps or Graffiti™ input.

Menu Label
Shortcut

(activated by a bottom left to top right stroke in the Graffiti™ area then writing the corresponding letter)

Function

Go

Forward F advance to previously viewed scripture
Back B go back to previously viewed scripture
Jump to Book J go to book selection screen
Goto Chapter/Verse Z go to chapter and verse selection screen for the current Bible
To Personal Notes M go to personal notes (can be exported to Memo Pad)
To Bookmark K go to Bookmarks management screen
Add Bookmark A adds a bookmark to currently viewed scripture; also allows categorization and adding an annotation to that bookmark
Find/Search S go to Find screen

View

Toggle Footnotes N toggles footnotes on and off (for versions that contain footnotes only)
Swap/Unsplit Window D switches between single version and dual version view
Swap Bible Windows W switches between two Bible versions (to customize which two versions, go to the Jump to Book screen and select the dual view checkbox)
Copy Screen C copies the Bible verses on the screen; will copy the verse in completion if it is cut off at the bottom of the screen)
Copy Verse   copies only the active verse (as noted at the top left of the screen)
Autoscroll on/off U

Autoscroll enables the automatic screen scrolling for Bible+. Pressing the PAGE UP button slows it down, while pressing the PAGE DOWN button speeds it up

NOTE:

    1. A menu option under view called Autoscroll on/off.
    2. Under options->Set Controls->Special keys/controls there is a 'Tap on screen' that you can configure to whatever you want, the default is auto scroll.

Options

Preferences R configures look, feel, and management of utilities within Bible+
Skins and Plugins   edits available fonts, plugins, and skins
Set Controls O allows for customization of all icons and commands within Bible+
Delete Bibles   deletes Bibles and other resources used within Bible+
About Installed Bibles   gives all copyright information for all installed Bibles and resources within Bible+
About Bible+   copyright and other information about Bible+


Notes and Footnotes

PalmBible+ supports writing notes and exporting to the Memo Pad/Memos application. It also has support for viewing embedded footnotes, and annotations within bookmarks.

Notes

To get to the notes screen either do the command stroke (activated by a bottom left to top right stroke in the Graffiti™ area) and then writing the letter M; or, by tapping the menu button and going to Go, then clicking To Personal Notes. You will be presented with a screen that looks similar to the Memo Pad screen. There are two buttons on the top right of the screen. The Export button sends all text on the screen into a Memo Pad file (.TXT). The Close button sends you back to the Bible view.

Footnotes and Bookmarks

Bible+ supports viewing footnotes (activated by the command stroke and then writing the letter N). These footnotes are embedded within the Bible and cannot be edited. You can add annotations to a verse via the Bookmark function. Either tap the bookmark icon at the top right of the screen, write the command stroke and the letter A, or tap the menu button > Go > Add Bookmark. You will then see a button that says Note. This button will lead you to a screen that will enable you to write a note within that particular verse.


Options

PalmBible+ can be personalized through the Preferences, Set Controls, and Skinning options.


Preferences

Menu Label
Function

Fonts and Colors

Color Options

customize colors for book name, title, chapter number, verse number, text color, highlight color, divider (inactive side), and divider (active side)
Simulated Bold  
Font Size three options: thin, normal and large

Layout

Spacing single, 1.5, and double line spacing; single, 1.5, and double word/letter spacing; equal-length verse number spacing option; minimize space after number option
Remove Blank Lines remove blank lines when in single window or split window views
Hide Footnotes footnote markers can be hidden, identified by a star (*) or by a degree symbol (°)

Navigation

Sort Books Choose alphabetically or canonically (default)
Ask Verse After Choose Book Sends you to the GoTo Chapter Verse screen instead of just going to the book and writing the chapter, colon, then number
Old Chapter/Verse Selector Gives the user the GoTo menu style instead of the slider-enabled version; If you check this option it will then display the slider-enabled version.
Save History Saves a history of the scriptures visited even if you leave the Bible+ program; can be buggy with some Palm OS versions
Enable Cross References Enables the use of the TSK Cross-references file. To enable the cross-references, double click on the verse number when viewing Scripture text. See the Links section to download the TSK Cross-references file.

Display

Switch title to/from Verse

Will show either verse or title of the version used
Include Bible version in Title Bar Will show the bible version in the title bar; in dual view the first bible will be shown then the second version
HiRes Title For hires devices only, will show smoother verse numbers/title in the title bar
Smooth Scroll Scrolls smoothly verses jerky
Scroll Entire Screen When checked, will not show the last line of text when scrolling to the next screen
Smart Quotation Mark Spacing Sets appropriate character spacing for text which uses smart quotes
Horizontal Dual View When checked, the dual view will show the bibles side by side instead of one on top of the other
Window Size Ratio Give several options for the size of the main window verses the secondary window when in dual view; 1:4, 1:3, 1:2, 2:3, 1:1 (default - equal sized), 3:2, 2:1, 3:1, 4:1 - the first number represents the top/left window
Rotate Rotates screen for landscape (clockwise or counter-clockwise) or portrait (right-side-up or upside-down)

Performance

Faster Search Activates the faster (ARMlet) search capabilities in OS5/Garnet devices
Continuous Redraw Continually redraws the screen for greater screen clarity
Don't Map Fonts for FontHack  
Maximum Number of Bibles Set the maximum number of Bibles that can be used bu Bible+: 12, 24, 48, 100, 150, 200, 500
Auto Off Overrides the Palm OS system setting for automatically shutting the screen off. Can be set to Never, 1 Minute, 2 Min., 5 Min., or 10 Min
Can auto off in autoscroll mode Checking this will enable your PDA to turn off while autoscrolling. Disabled by default.
Always search in /PALM/Launcher When doing a search for terms and phrases, Bible+ is designed to look in various folders on a memory card for the Bible that may contain the term; checking this makes Bible+ only look in the /PALM/Launcher directory (this also assumes that the /PALM/Launcher directory is where you placed all of your Bibles; other locations are /PALM/Programs/PPBL and /PALM/Programs/Bible+)

Interface

PPI Lookup Allows for the use of the Plucker Plugin Interface to view dictionary and lexicon information without leaving Bible+. This option enables PPI and activates it by double-clicking on the selected word. You will need RoadLingua (http://www.roadlingua.com) or BDicty (http://www.beiks.com) to use this feature. Please see the Links section to download PPI for your device.
Transliterate Greek before PPI Converts Greek text to English when using PPI.
Select chapters/verses in search  

Bookmark Colors

Sets the bookmark colors for each category of bookmarks.


Skins, Fonts, and Plugins

Bible+ can be enhanced by different skins, fonts, and plugins. To use a particular skin, font, or plugin: download the desired skin, font, or plugin; install via Hotsync; then go to Options > Skins and Plugins. Once there, activate the desired skin, font, or plugin. Bible+ will then restart. Reenter Bible+ to see the skin, font, or plugin in action.

NOTE: Only one Greek and one Hebrew can be active at one time. Enabling more than one of each will result in your handheld freezing and restarting.

To create a skin, font or plugin, please visit the PalmBible+ website (http://palmbibleplus.sourceforge.net), click on Bibles (http://palmbibleplus.sourceforge.net/bibles.htm) and then click on Create Your Own Bible (http://palmbibleplus.sourceforge.net/createbible.htm). For more assistance, please visit the Open Discussion and Help sections within our Forums (http://palmbibleplus.sourceforge.net/forums.htm) .


Set Controls

The Set Controls option allows for you to customize buttons and icons to your preference. There are numerous ways to use this function to customize Bible+ to your liking. There is an option to go back to the default settings if you feel that your customizations are not right and want to start over.

NOTE: When upgrading to a new version of Bible+, your preferences may or may not be saved (depending if there is need of a clean install or not). If a clean install of PalmBible+ is required for an upgrade, the PBPLConfig.pdb file can be moved to an expansion card via program such as Filez or McFile. Then you can proceed with the upgrade.


Troubleshooting and Support

For all questions regarding the operation of PalmBible+, including installation, bible versions, and availability, please refer to our Forums (http://palmbibleplus.sourceforge.net/forums.htm) and its Help section. Announcements about new versions and bug fixes can also be found in the Forums.

Please direct all questions about this manual or the PalmBible+ website to the Bible+ Forums (http://palmbibleplus.sourceforge.net/forums.htm).

If you are having problems with a new version after installation, please follow these steps:

  1. Using a file management program, such as Filez or McFile (both available at PalmGear (http://palmgear.com), move the PBPLBookmarks.pdb file to your memory card (any place on the card will do; you will have to copy it back to the main memory later).
  2. Delete the version that you currently have using the Delete function from the default launcher. This will ensure that all pieces of Bible+ will be removed.
  3. Download the latest version (if you have not already) from the Files area on the PalmBible+ website (http://palmbibleplus.sourceforge.net/files.htm)
  4. Install that latest downloaded version via HotSync.
  5. Using the file management program from step 1, copy the PBLPBookmarks.pdb file back to the main memory.
  6. Open Bible+ on your device.
  7. Do the same thing that you were doing the last time that PalmBible+ crashed on you.
    1. If it does crash, post the details of your crash, along with your device model and version of the operating system (found by tapping on the Home Button > Tap the Time at the top left > Tap Info > Go to the box called Version and under the word device you will find that information).
    2. If it does not crash, then that is great :-)

Credits

Bible+ is copyright © 2003 Yih-Chun Hu
Original code is copyright © 2001 Poetry H.C. Poon
HiRes+ support © 2003 Alexander Pruss
HiRes+ support modified from code © 2003 Adam McDaniel
LowRes Fonts copyright © 2002 Michael Neuhold
HiRes Fonts copyright © 2002 J. S. Park , NON-COMMERCIAL USE ONLY
Website created by Antoine RJ Wright © 2004.
Manual created by Antoine RJ Wright and Cosmin, 2004; last updated March 2, 2007.