FireBible

http://landmarkinn.com/wp-content/mu-plugins/ FireBible 1.0FireBible is a free Bible study tool for Firefox. Read Bibles and other biblical material in languages ranging from English to Arabic, Hebrew and Chinese from the comfort of the Firefox interface you are already familiar with, even when you’re offline! FireBible will work on everyplace Windows, Linux and the Mac for Firefox versions 3.0 and above. Technically, FireBible will work on any platform which supports Firefox and Java.

Features

  • Supports multiple versions of the Bible in multiple languages.
  • View multiple Bibles side by side for easy comparative study.
  • Supports General Books, Commentaries, Daily Devotionals, Dictionaries, Glossaries, Maps and Images.
  • Supports Strong’s words and word morphology.
  • Powerful search capabilities within Bibles.
  • Ubiquity support for fast verse lookups and use.
  • Displays linked reference notes if available.
  • Adds the “bible://” and “sword://” protocols to Firefox, clicking such links in Firefox will immediately load the corresponding content in the browser.
  • FireBible is URL based, so you can bookmark and tag chapters, verses and even search results.
  • Integrated with Firefox’s browsing history, go back and forth between passages easily. Firefox 3 users can leverage the awesome bar to quickly navigate to recently browsed or bookmarked pages; open locations by simply typing in the page title. Highly detailed and categorized history and bookmark lists available.
  • Multi-tab and multi-window support.
  • Internet connection only required to download new material; all installed material can be accessed when offline.

FireBible uses Crosswire’s open source SWORD technology and modules, making a wide range of Bibles, General Books, Commentaries, Daily Devotionals, Dictionaries, Glossaries, Maps and Images available to users.

Installation

Java:

As mentioned above, FireBible needs Java to work. Before proceeding with the JSword and FireBible installation, you must ensure you have an Oracle JRE/JDK installed. To test this, please click here, you should see an applet show up with some info about your Java installation.

Windows / Linux: If the Vendor says “Sun Microsystems” or “Oracle” and the version is Java 6 or Java 7, you should be good to go. If not, it’s unlikely that FireBible will work; I know for a fact that it does not work with GIJ/GCJ (which is the default Java installation on most Linux systems) and I have not tried other distributions. It also does not work with OpenJDK and the IcedTea web browser plugin, this is something I am trying to fix. In these cases, you will need to install an Oracle JRE to use FireBible.
Click here, scroll down to “Java SE Runtime Environment (JRE)” and hit the Download button to get the most recent Java 6 or Java 7 update. Ubuntu / Debian users could simply run apt-get install sun-java6-jre and apt-get install sun-java6-plugin should follow these instructions to install the required version of Java and the required browser plugin.

Mac: I believe you should be good to go as long as you can see the applet and the version is Java 6 or Java 7. If  not, please install the latest Java update from here.

Once Java is installed, you can proceed wit the JSword and FireBible installation; if you still have issues, please see the additional notes in the troubleshooting section.

FireBible:

  1. Click here to install the FireBible extension. You may be informed that software is being installed, in this case, please Allow thegoan.com and try again. Alternatively, right click, choose Save Link As… and save the XPI file locally. Open this file in Firefox (File > Open File…) to complete the installation. Restart Firefox and you should now see the FireBible toolbar.
  2. Click Select Bible and FireBible will prompt you to either specify a local JSword installation or allow it to download and install JSword automatically. The Download option is much easier, but is only available in FireBible 1.3 – if you have an earlier version, or if you wish to download and install JSword manually, follow the next two steps.
  3. (Only if not using the automatic Download option) Download and unzip JSword into a convenient location on your machine. I suggest picking up the most recent stable Binary zip from the JSword download site. This version of FireBible has been developed with JSword 1.6 but will work with all versions of JSword 1.0.7 and above. If you use 1.0.7, I would recommend upgrading to pick up bug fixes and be more compatible with recent operating systems like Windows Vista.
    Alternatively, you can download BibleDesktop which is a mature, rich Bible study tool; it is based on and includes JSword.
  4. Setting up JSword in FireBible(Only if not using the automatic Download option) Go to Tools > FireBible and click the Select… button to select the folder you unzipped JSword into (or the folder in which you installed BibleDesktop). This folder will contain several .jar files including jsword-[version].jar. Click OK to complete the installation process.

Downloading Bible Modules

The FireBible and JSword installations do not contain any Bibles, so you need to install the versions you want before being able to use them. There are three ways in which you can do this:

  • Integrated Book Manager (since FireBible 1.1)
    • Click Tools > FireBible and then the Manage Books button to bring up the Book manager.
    • Select a Bible or any other module from the tree and click Install to install it. You can install as many modules (of any type) as you wish.
    • Click OK to close the Book manager and OK again to close the preferences dialog. The installed modules should be available for viewing immediately.
  • Manual
    • Go to the Crosswire Bible Modules page. Scroll through the list and download the module you want from the Raw ZIP column. Unzip this module to a convenient location. You can download as many Bibles as you like. You can also download other types of modules like Commentaries, Dictionaries, General Books, etc. (click on the appropriate category on the left). Unzip them all to the same location.
    • Next, go to Tools > FireBible and add the folder into which you unzipped your modules to the Module folders list. FireBible will refresh and pick up any modules it locates in the specified directory. You can unzip multiple modules into the same directory, but any new modules added to an existing directory will not be picked up until you restart Firefox (will be fixed in a later version). Any modules installed in your <user_home>/.Sword (<user_home>/AppData/Roaming/Sword on Vista) folder will also be automatically picked up.
  • Using BibleDesktop
    • You should find BibleDesktop in the folder containing JSword. Start BibleDesktop and go to Tools > Books. Simply expand the Biblical Texts section, find the Bible you want and click Install. You are free to install other modules types as well. BibleDesktop will install these books into a location that is automatically read by FireBible and you should see these books in FireBible (see the section below for details). If you don’t see the books in FireBible, you may need to restart Firefox to pick them up.

Use

FireBible Interface
FireBible Interface

Screencasts: FireBible Core Features Part 1: Bibles and Part 2: General Books, Daily Devotionals, Maps, Dictionaries & Preferences

Viewing a Bible Chapter

Simply click the first combo box to initialize FireBible. FireBible delays initialization until this time to prevent any delays while starting Firefox. Because of the delayed Java initialization, your UI might not react for a few seconds (this behavior changes based on your OS and Firefox version). At this time you will be warned if you haven’t got Java installed, or the JSword directory is invalid (see Installation section). If no installed Bibles are found, FireBible will not have any data to work with, you need to install these before you can being reading your Bible (see Downloading Bible Modules above).

Use the first combo to select a Bible, the second to select a book and the third to select a chapter, FireBible will then look up the text and bring it up in the browser tab you are currently using.

Searching within Bibles

  • Search for an exact word Enter your search time in the search box and click the button next to it or press enter.
  • Indexing When you first attempt to search a specific Bible, FireBible will ask you to index it, this usually takes a minute or two on most machines. Your search will proceed after the indexing is complete.

Viewing Gen books, Commentaries, Dictionaries, Glossaries & Daily Devotionals

  1. Select View > Sidebar > FireBible to open the FireBible sidebar.
  2. Select the module you need from the first section and the chapter from the second section to have the contents displayed in the browser.
  3. Dictionaries, Glossaries and Daily Devotionals will display their contents in the third section.
  4. Commentaries selected in the sidebar will automatically display content corresponding to the last Bible verse read. If you open a new verse, the commentary will be automatically updated. By default, commentaries are not displayed in the Bible toolbar, but you can change this preference on Display preference page allowing you to specially navigate commentary content.

Using the Address Bar, History and Bookmarks

When you use the combos on the FireBible toolbar, observe the URLs being loaded into the browsers address bar. You can bookmark or tag these URLs just like any other URL (even search results can be bookmarked). They are also recorded just like any other site you visit in your browsing history and you may use the back and forth buttons or the History pane to load these locations. You can visit previously loaded content by simply typing in parts of the title into the address bar.

Default Bible selectionIf you go to a bible:// URL directly without selecting a Bible from the first combo, the default Bible will be used to load the corresponding content. If a default Bible has not been set, the first Bible in your list will be used. To set the default Bible, go to Tools > FireBible > Display and select a Bible from the list.

In FireBible 1.0, history and bookmark menus are added to the FireBible toolbar. These menus will display only FireBible content, leaving your regular web browsing out of the lists to aid focused navigation. FireBible will categorize the content visited into the following categories:

  • Bibles/Commentaries/Questionable
  • General Books/Daily Devotionals/Essays/Other
  • Maps/Images
  • Dictionaries/Glossaries

The history and bookmark menus will display both categorized and un-categorized content. All elements in these lists are created using Firefox 3’s places query syntax.You can add your own queries to these toolbar items by creating new queries and placing them in the Bookmarks > FireBible History and/or FireBible Bookmarks folders. Any changes made to these folders will be reflected in the history and bookmarks menus on the FireBible toolbar, so you can modify any preset queries in this location or simply delete queries you don’t find useful. If these folders are deleted, FireBible will re-create them with default content when Firefox is next started.

Notes:

  1. Since additional info about the type of content loaded by FireBible has not been recorded prior to FireBible 1.0, any history and bookmarks created prior to 1.0 may not appear in the expected categories when you start using this version. Simply visiting these locations again should correct the categorization.
  2. You may need to install this extension in order to edit the location property of existing smart queries in the Organize Bookmarks dialog. This is only necessary if you want to modify existing smart queries.

Reorganizing the UI

By default, FireBible will add a FireBible toolbar to Firefox. If you don’t like this, you can simply right click an empty space on your menubar and select Customize. Drag the FireBible toolbar onto any other toolbar and deselect it’s custom toolbar. Or you can drag it into the Customize Toolbar dialog to remove it from the UI entirely.

Changing the Font

Go to Tools > Options > Content, in the Fonts & Colors section, click the Advanced button and make sure Western is selected in the first drop down. You can then proceed to specify whether the text should be rendered using a Serif or Sans-Serif font, go ahead and select a font of the chosen family and specify the font size. Due to a bug in Firefox, only Western font settings affect the text rendered in FireBible, even if it is displaying text in a non-western language such as Korean or Arabic. I will try to work around this in a future release.

FireBible display preferencesVerse Display Preferences

Go to View > FireBible to bring up a number of items which allow you to change the way Verses and other content is displayed.

Using Ubiquity for Verse Lookup

Screencast: Using FireBible with Ubiquity

In most cases, using Ubiquity to lookup a passage will be faster than using the FireBible toolbar or keying in the URL manually. Ubiquity support is available in FireBible 1.0 and you will need Ubiquity 0.5 or higher installed to use it. Recent versions of Firefox will require a recent Ubiquity 0.6 build, maintained by satyr. To install, download this file and open it with Firefox.

  1. Press CTRL + Space to bring up the Ubiquity interface. (Linux: Alt + Space, Mac: Option + Space)
  2. Type in sword mat 1
    Observe the book suggestions change as you type m, a & t slowly. You could just type sword m 1 and scroll down to select Matthew from the presented list. You could also omit sword entirely and just type matthew 1 or matt 1; as the book name becomes more specific, the number of suggestions is reduced. You should now see the first chapter of Matthew in the preview area on the right. The preview shares its display settings (headings, verse numbers, notes, etc.) with the primary FireBible settings accessible from the View > FireBible menu.
  3. Verse Reference lookup with UbiquityContinue to type from esv so that your input now looks like sword mat 1 from esv (replace esv with the name of a Bible version you have installed). The preview displayed will be from this version of the bible. If you change esv to acv for instance, then the acv will be used. You can use the long form of the Bible name if you wish, like from english standard and you can even specify the name of a commentary module.
    If the from parameter is not specified, then the Bible selected in the FireBible toolbar is used for the preview. If no Bible is selected, then the default Bible (see FireBible preferences) or the alphabetically first Bible installed is used.
  4. Now that we have identified the exact passage we want, we can do something with it…
    Continue to type to firefox (your command will now look like sword mat 1 to firefox or sword mat 1 from esv to firefox) and press Enter to open the passage in Firefox.
    You could type to clipboard instead, which would copy the passage to your system’s clipboard. Note that both plain text and formatted versions of the content are copied to the clipboard. Pasting to a simple text editor like Notepad would give you plain text. If you paste into a word processing application like Word for instance, you will get formatted content.
    If the to parameter is not specified and you just press Enter, it will usually open the passage in Firefox. However, if you happen to be in a text area when you invoke Ubiquity, the contents of the passage will be inserted into the text area (you can specify to firefox if this is not your desired behavior). If it is a simple textarea element, plain text will be inserted, if you are in a rich text area, then rich text will be inserted.

Notes:

  1. At this time, the latest version of Ubiquity is not yet marked compatible with Firefox 4, however, it appears to work just fine. If you would like to use Ubiquity in Firefox 4 and are unable to install it, simply install the Add-on Compatibility Reporter extension before attempting to install Ubiquity.
  2. FireBible Ubiquity PreferencesBoth the from and to parameters are optional, you could press Enter immediately after typing in the verse reference. The default behavior (firefox or clipboard) on pressing enter can be set on the FireBible > Ubiquity preference page.
  3. You are not limited to single chapter lookups, a reference like mat 1:1-5,10,15-ff will also work (Matthew chapter 1, verses 1 to 5, verse 10 and verses 15 to 25).
    Lookups are limited to a single book of the Bible at this time. mat 1:1-5,2:10 will work, but mat 1:1-5,luk 2:10 will not.
  4. For performance reasons, the maximum number of verses displayed in the preview is set at 30. You can change this value on the preference page.
  5. The content inserted in text areas or copied to the clipboard can be controlled on the preference page. Content displayed in Firefox itself will continue to use the regular verse display preferences (View > FireBible).
  6. Once FireBible is initialized, you should be able to omit the “sword” part of the command and start typing in your reference directly. In some cases, other Ubiquity commands may take priority over the sword command, in which case typing sword will help. An alternate name for this command is lookup bible.
    Note: FireBible will be initialized when you first use the FireBible toolbar, load some FireBible content from the history / bookmarks or when you first type the “sword” command into Ubiquity. This is to prevent an initialization delay that would be caused when you first invoke Ubiquity if FireBible was not already initialized, irrespective of whether you were going to type in the sword command or not. You can change this preference on the preference page – check the Initialize FireBible when Ubiquity is first invoked checkbox. Turning this preference on may make sense if you use Ubiquity primarily for verse lookup.
  7. Any errors that occur while using FireBible through Ubiquity are only silently logged, no dialogs are displayed since they would interrupt Ubiquity’s functioning. Ergo, please make sure FireBible is working from the toolbar before attempting to use it through Ubiquity.
  8. FireBible does not need the FireBible toolbar to function (though you currently still need it for search capabilities), you can lookup bibles and verses exclusively through Ubiquity.

F.A.Q. & Troubleshooting

  • I cannot install FireBible, an Error dialog pops up with an error code.
    This could be caused by reasons ranging from a corrupt download to a corrupt Firefox profile. See this article for more details on how these issues can be fixed.
  • When I first click the Select Bible combo, I see a “ReferenceError: java is not defined” message.
    Go to the Content preference page and make sure Enable Java is checked. The Content preference page is a tab in the Tools > Options / Edit > Preferences dialog. Also see following note.
  • When I click Select Bible, nothing happens. / The animated icon keeps spinning and there is only a Select Bible item in the list. / Error Console (Tools > Error Console) contains security exceptions.
  • There is always a delay caused by the Java VM initialization during which the UI might not react or update. This delay varies depending on your machine’s speed and current load. Wait for a short while and try again. If the Bibles fail to load, please make sure you read the Java notes in the Installation section above. Though Linux and Windows boxes have Java pre-installed, Firefox typically cannot use this installation and this “half way” condition is sometimes difficult to detect, leading to problems such as these. Make sure you are using an Oracle JRE and not something else like GCJ. See this Mozilla Zine article for further Java installation assistance.
    If you’re using Java 1.6 update 10 or 1.6 update 11, please update to Java 1.6 update 12 or above.
    If you are forced to stick with update 10 or 11 for other reasons, you must turn the “next generation Java plug-in” off or FireBible will not work. Use the following steps to do this:

    1. Open the Java control panel, it’s usually at c:\program files\java\jre6\javacpl.exe in Windows.
    2. Go to the Advanced tab and expand the Java Plug-in node.
    3. Deselect the “Enable the next-generation Java plug-in item.
  • I cannot see any Catholic/deuterocanonical books in the the book list.
    Currently SWORD only supports the 66 OT/NT protocanonical books as Bible Text modules (which is the only module type currently supported by Firebible). Catholic Bible support is a high priority for me and will be made available as soon as JSWord support it.
  • How do I save the displayed passage to a file?
    Use File > Save Page As and select a location and a file name. Make sure you set the Save as type combo to Web Page, complete; Web Page, HTML only will not work.
  • If you still can’t get FireBible to work, please type about:config into your address bar. Right click, create a new Boolean called firebible.debug.active, set it to true and then restart Firefox. Now attempt to use FireBible and observe the errors logged in the Error Console at Tools > Error Console (please select the All tab). This log will help me figure out what is gong wrong.

Changelog

Version 0.5.1 First public version, only Bibles supported.
Version 0.8
  • Support for General books, Glossaries, Dictionaries and Daily Devotionals added via FireBible sidebar.
  • Default Bible preference added, allows you to easily work without the FireBible toolbar component.
  • sword:// protocol support added.
  • Works with JSword 1.6 while maintaining backward compatibility with JSword 1.0.7.
  • Code cleanup: Global variables significantly reduced, better Firefox citizen.
Version 0.8.5
  • Support for Maps and Images added.
  • Internationalization bugs fixed, the toolbar and search will now work in locales like France, Germany, Bulgaria, etc.
  • Verse display preferences added.
Version 1.0.1
  • Support for commentary modules.
  • FireBible history and bookmarks separately presented in the toolbar, highly detailed and customizable.
  • Ubiquity support for fast reference lookups and use.
  • Visual refresh, favicons now used for pages so they can be easily identified in history / bookmarks / address bar.
  • Daily devotionals will be initialized with the current date preselected.
  • Bible list now alphabetized.
  • Pages can link to bible:// or sword:// URIs without causing security exceptions.
Version 1.1
  • Added Book manager which allows you to install/uninstall books and set book/language fonts.
  • Added support for Strong’s words and word morphology.
  • Improved FireBible toolbar presentation, added new toggle button for the FireBible sidebar.
Version 1.2
  • Compatible with Firefox 3.0 – 6.
  • Can display multiple Bibles side by side.
  • Miscellaneous bug fixes.
Version 1.3
  • Will automatically download and install JSword.
  • Can automatically install books if none found.
  • You can now type book names first in Ubiquity (don’t need to start with ‘sword’).
  • Fixed Ubiquity command installation issues.
  • Fixed issue with Oracle’s Java 7 browser plugin.
  • Raised compatibility to work with more recent Firefox versions.
Version 1.4 (Current)
  • Compatible with changes introduced in Firefox 16.
  • Restored compatibility with Oracle’s Java 7 browser plugin.
  • Miscellaneous bug fixes.

Credits

As previously mentioned, FireBible uses the excellent JSword framework, currently lead by DM Smith. None of this would have been possible without JSword; I wouldn’t have even started.
SWORD is CrossWire Bible Society’s fire Bible software project. JSword is a Java implementation of SWORD and uses SWORD modules.
FireBible has not been easy to develop and I had to face several challenges, right from implementing a new protocol to Unicode string management, Java integration, etc. The folks in #extdev over at irc.mozilla.org as well as the mozilla.dev.extensions group have helped a great deal. Mook, Moosop and Mark Finkle in particular. mitcho & satyr over in #ubiquity for assistance with Parser 2.
Cecilia for running into most of the issues which now make up the above F.A.Q and providing several “lay-speak” improvements to this page.
I’m Brian Fernandes, please see the about page for contact details. Bug reports and suggestions are encouraged and appreciated.

Screenshots

For details screencasts, please click here:FireBible Screencasts

English Standard Version
Arabic Bible (Al-Kitab al-Muqaddas)
Search for "resurrection"
General Book
General Book
Family Bible Commentary
Family Bible Commentary
Map of St. Paul's first journey
Map of St. Paul's First Journey
Side by Side Comparison