Setting up and Running the DjVu Standalone Encoder
This convenience utility is a Java Application that wraps the command line tools convert (ImageMagick), c44, and cjb2 (djvulibre).
Setting up the DjVu Standalone Encoder
Download & Install
- Download ImageMagick's compiled binaries for your platform from and follow the instructions given to install to your local machine
Remember where it was installed because it will need to be specified in the configuration file.
Recommend Installation Location
- ImageMagick File: Q16-windows-dll 6.3.3-4
- Recommend Location: C:/Program Files/ImageMagick-6.3.3-4-Q16/
- The configuration file is set to look in this default place for ImagMagick.
- Download DjVuLibre's zip file of the latest compiled binaries and unzip the archive to your local machine
- Download DjVuLibre's source files and follow their instructions for compilation and installation.
Remember where it was extracted (or installed) because it will need to be specified in the configuration file.
Recommended Extraction Location
- Extracted directory: DjVuLibre-x.x.x-win32
- Recommended Default Location : C:/Program Files/DjVuLibre/,
- Recommended Path for the bitonal encoder C:/Program Files/DjVuLibre/DjVuLibre-3.5.17-win32/cjb2.exe.
- The configuration file is set to look in this default place for the encoder.
Testing the DjVu Standalone Encoder
All files necessary to run the gui encoder can be found in the Client directory. Included in this directory is djvuencoder.jar which can be run from the commandline or from double clicking it.
- Running the Jar
- Double click djvuencoder.jar
- The jar requires that encoder.conf (The configuration file) is in the same directory
- A different djvuencoder.conf can be specified in the jar file
- The jar file will run similar to the example Running the Encoder
- Double click djvuencoder.jar
The configuration file djvuencoder.conf, located in the Client directory, has four configurable properties.
Paths should use forward slashes, not the Windows-style backslash.
- This value should point to where you have the convert executable.
- This valueshould point to where you have the djvulibre encoder executables.
- This value should point to where you have the djvulibre encoder executables.
- This value specifies a default directory to save encoded files. If this property is not set, the default location is the directory of the tiff to be encoded. The user is not given a choice of where to save files currently. This property can be set to the incoming directory Samba share on the Variations server to avoid having to copy the derivative files as a separate step.
Installing the DjVu Standalone Encoder
See Building the Client Installer - 5.0.7 for instructions on building digitizer client installers which create a Desktop shortcut and start menu item for the DjVu Encoder.
Running the Encoder
(As mentioned before the the encoder can be run with the djvuencoder.jar file)
Adding Files to the Encode List
There are Four ways to add files to the Encode List:
- Type the full file (or directory) path in the Filename text field and click Add File.
- Click Add File and navigate to the file (or directory) and click Open.
- Drag and Drop the file(s) (or directory) onto the Encode List.
- Right-click on the Encode List and click Add Files.... Then navigate to the file (or directory) and click Open.
Adding a directory to the Encode List will add all files in that directory or beneath that directory except Thumbs.db. If you attempt to add a file that already exists in the list with the same specified output file, it will be skipped without warning.
Click the Encode button to start encoding the files in the Encode List. If a file already exists at the specified output location, a warning dialog will ask if you want to overwrite the preexisting file. Files that have already been successfully encoded and are still in the Encode List will be skipped unless their status has been reset by selecting the file, right-clicking the mouse, and clicking Reset File Status.
To stop the current and all subsequent files from being encoded by the current encoding process, click the Stop button.
Removing Files from the Encode List
To remove all files from the Encode List either click Clear All or right-click in the Encode List and click Clear All Files.
To remove one or multiple files, select the file(s), right-click the mouse to bring up the popup menu, and click Remove File.
Reset a File's Status
To reset the status of one or multiple files, select the file(s), right-click the mouse to bring up the popup menu, and click Reset File Status. The tooltip text for these files should read Unprocessed after doing this.
Setting a File's Color Status (Disabled)
This is currently disabled because the score viewer in Variations cannot handle color pages at the moment.
By default pages are set to encode using DjVuLibre's bitonal encoder. To set a page to be encoded in color, select the file, right-click, and select Set Color. To return a file to its bitonal default, reset the file's status by clicking Reset File Status from the popup menu you get by selecting the file and right-clicking.
After you have completed the encoder configuration process, you can being building the installer at Building the Client Installer.