Raamattu-viewer

Raamattu-viewer is an open-source Bible reader application for J2ME (Java Micro Edition) enabled phones based on GNU GPLv2 -licenced GoBible 2.4 symscroll -branch from Crosswire Bible Society.

Features added

• Finnish UI-translation
• Multi-translation support with arbitrary location for translations (via modified NetBeans FileBrowser from PDA package)
• .zip -file readonly support (via modified JazzLib 0.07 and Albite RandomReadingFile)
• Bible data files zipped and moved to memory card
• Updated theme selection form and added theme suitable for night-reading
• Updated book/chapter/verse -forms more suitable for touch usage (similar to AndBible)
• real fake italic text instead of different color+underlining
• added exception handling and recovery from various error situations
• keyboard shortcut to enter/exit fullscreen
• new icon(s)

ToolChain

• NetBeans IDE 7.1.1
• Nokia SDK 1.0 for Java
• Notepad++ 6.1.4
• Git 1.7.8
• Sword utils

Used libraries, API:s etc

JazzLib

Pure Java implementation of java.util.zip classes ported to Java ME by me. This is done by using the AlbiteRandomReadingFile API. Reading .zip files relies on this.

AlbiteRandomReadingFile

Implementation without writing capabilities of RandomAccessFile in Java Mobile (J2ME) using FileConnection.

NetBeans JavaME Component library

I have used org.netbeans.microedition.lcdui.FileBrowser class lifted from Netbeans JavaME Component library sources and extended it a little bit. With brand new icons!

Installation

From sources

1. Clone, compile, install
2. Continue from pre-compiled instructions step 2

Pre-compiled binaries

1. Download viewer binaries from my public Google Docs folder.
2. Extract reader JAD/JAR-files from Raamattu_viewer.zip and install to phone (via BlueTooth or data cable)
3. Download translations from same place
4. Create folder Raamattu/ to your phone memory card root and copy translation .zip files there as-is
5. Read Bible

All translations provided are Public Domain or licenced to allow free distribution.

Known issues and future development plans

Installation ease-up

• Separate Bluetooth-app to send .jar/.jad files on Nokia phones (Nokia has disabled this feature)
• Translation downloads from app
• Download from app stores?

Usage ease-up and improvements

• Navigation clarification
• possibility to show/hide footnotes, comments and cross-references
• possibility to compare translations (show a single verse from many translations)
• cross-references to direct links
• adding Biblical maps
• bugfixes

Known bugs

• changing translation with larger canon to one with fewer books
  • changing for example OT+NT translation to translation with only OT and current book is outside books contained in new translation causes ArrayOutOfBoundsException
• exiting "select translation" screen without selecting translation causes exception (first time usage issue)

Others

• New name for app