for Java,
Created By


Release Notes


LizardTech Inc.
Internet Archive

Project Page |  Home |  Forums |  Tracker |  Bugs |  News |  Files |  Cvs

JavaDjVu - Release 0.8.08

This package contains the source code and documentation for JavaDjVu. JavaDjVu consists of a reference library and GUI code that may be used to view and navigate DjVu documents from JVM 1.1 compliant virtual machines.


  1. JDK 1.5.0 or later.
  2. GNU bash, version 2.05b or later. (for command line builds)
  3. NetBeans 4.1 or later. (for GUI builds)


  1. One of J2SE Runtime Environment 1.1.4, J2ME 2.0, or newer releases. JIT highly recommended.
  2. At least 64MB of memory.
  3. A java enabled browser such as Internet Explorer, Mozilla Firefox 1.0, or Netfront 3.1.


If you are not lucky enough to be using the Sun JVM, you can try a Java 1.1 compatible virtual machines. Visit:

for a list of virtual machines to try.


Primarily, the viewer is intended to be used as an applet. The instructions in Deployment.html will guide you deploying the applet on your website. There is limited support for running the viewer as a standalone application. To do so, you must have Java 1.3 or later installed and in your search path. Assuming both javadjvu.jar and foo.djvu are in the current directory, the following command line would be used to view foo.djvu:

java -jar javadjvu.jar foo.djvu

Actually any valid URL may be used. For example, when debugging the following commandline is invoked:

java -jar javadjvu.jar

Note that the web browser built into Java does not support current standards. Consiquently, few websites can actually be browsed successfully with the viewer.


If you have NetBeans, you may load javadjvu as a NetBeans project and build, debug, and test from there. Otherwise you may install and configure GNU bash with your JDK path and execute the following command line:


The resulting files will be populated into the build directory. You may test your build with the command:

cd example
java -jar ../build/javadjvu.jar

This should open a standalone application browsing the document in the examples directory. You are now ready to copy the DjVuApplet.class and javadjvu.jar file to your website.


Basic instructions for deploying a document are listed in the Deployment.html file.


JavaDjVu contains the optional components:

applet, menu, toolbar, text, anno, outline, and frame

Each of these components adds to the functionality of the build, at the cost of a larger file size and a longer download time.

The default is to build all optional components but you may do a custom build with just the features you wish to use by listing only the features you want on the command line. For example, if you wanted to build an applet with only menu navigation, and no support for hidden text or annotations you would use the command:

./ applet menu

If you are using NetBeans to build the applet, then comment out the properties in the file for the optional components you do not want to include. For example to disable the menu option you would change the line:*/menu/*.java



The optional components are further described below:

applet: (adds approximately 137 bytes to the build)

Used to build the DjVuApplet.class. This is required for using the <APPLET> tag from HTML documents.

menu: (adds approximately 5036 bytes to the build)

Used to add a pop-up menu to the applet. When the user clicks on the right mouse button, or any mouse button with a CTRL key the pop-up menu will appear. This will allow users to navigate multi-page documents, zoom, and access the AboutURL and HelpURL. This option does not work for most J2ME devices.

keys: (adds approximately 1528 bytes to the build)

Used to add keyboard shortcuts to the applet. The user will be able to navigate the document using the keyboard. This option does not work for most J2ME devices.

toolbar: (adds approximately 34012 bytes to the build)

Used to enable a toolbar at the top of each page. This toolbar may be used for navigating multi-page documents, zoom, and perform text search functions if "text" has also been selected.

text: (adds approximately 9988 bytes to the build)

Used to enable underlying support for the hidden text layer. This enables decoding of TXTa and TXTz chunks in the document. If combined with the toolbar option, users will be able to search and view hidden text.

anno: (adds approximately 23358 bytes to the build)

Used to enable hyperlink annotations. This will enable decoding of ANTa and ANTz chunks. Users will be able to click on hyperlinks and follow links inside the DjVu document.

outline: (adds approximately 8709 bytes to the build)

Used to enable outline navigation. This option enables the decoding of the "NAVM" chunks, and using the ouline to navigate multi-page DjVu documents.


Version 0.8.07 to 0.8.08
Version 0.8.06 to 0.8.07 (DOA)
Version 0.8.05 to 0.8.06
Version 0.8.04 to 0.8.05
Version 0.8.03 to 0.8.04
Version 0.8.02 to 0.8.03