# Frequently asked questions

### General questions

- What is JAlbum?
- What makes it different to others?
- Do I need Java to view albums?
- How do I check if I have the right version of the Java VM already installed?

### Getting started

- Getting an java.lang.NoClassDefFoundError error
- Updating without downloading too much again
- Errors when running the installer

### Using

- The final album is ok but I would like to adjust/add/remove [your modification here]
- What is the preferred way to add images to my existing JAlbum album?
- How do I easily maintain multiple albums?
- JAlbum doesn't show in my language. How do I change this?
- What file formats are supported?
- I cannot see thumbnails on published albums. Local viewing works fine.
- How do I make JAlbum add a link back to my site?
- I'm getting an "java.net.UnknownHostException" error when trying to publish an album
- How can I password protect my albums?
- How can I add watermarks to my photos?
- Can I have another title on the album than the folder name?
- How do I get rid of copyright notices that appear below images?
- What's the difference between "Rebuild all" and "Make album"?
- I have increased the thumbnail size but now the quality looks poor. Why?
- The generated date and time is in US format and I live in (enter country here)
- Vertical (portrait) images appear smaller than the horizontal ones.
- How can I have all thumbnails in the same height?
- Some generated albums do not look perfect on <add old browser here>
- Can JAlbum display the 35 mm equivalent focal length instead?
- Foreign characters gets messed up on my Mac with JAlbum
- I get an FTP error code when uploading
- I want JAlbum to open [enter browser here] instead of Firefox when I click "View album"

If tbis FAQ didn't help you, please ask your question at the JAlbum forum, but search through the forum first using the forum search tool.

### General questions

What is JAlbum?
JAlbum is a free tool that produces web based photo albums with index pages and slide shows from image folders

What makes it different to others?
A couple of main things:

- Ease of use. Just drag and drop an image folder and press "Make album".
- Flexibility. While many competitors offer some degree of customisation through user interface controls or simple templates, JAlbum allows you to generate virtually any imaginable album look as it allows the album designer to use any HTML mixed with JAlbum variables and interpreted java to define the album look.
- Works anywhere. With JAlbum you generate static HTML web albums so there is no need for extra software to view albums, not on the server side either (just a plain web server). You can put an album on a CD-ROM too if you wish.
- Runs anywhere. JAlbum is made in the Java programming language so it runs not only on Windows machines, but also on Macintosh OS X and Unix systems like Linux (That's the "J" in "JAlbum"). Being a Java program it needs a VM (Virtual Machine) that adopts its code for each machine. I recommend Java 1.5 (or "Java5") from www.java.com

Do I need Java to view albums?
No, only to generate them. JAlbum usually generates plain html web albums so any modern browser will do for viewing albums.

How do I check if I have the right version of the Java VM already installed?
Open a command window and issue `java -version` The output should at least read 1.4

### Getting started

I downloaded the version without the Java runtime (because I already have a Java VM installed on my machine.) When I run the program I get the following error:

    java.lang.NoClassDefFoundError: javax/swing/UIManager
    at se/datadosen/jalbum/JAlbum.main
    at java/lang/reflect/Method.invoke
    at com/zerog/lax/LAX.launch
    at com/zerog/lax/LAX.main

JAlbum requires at least v1.4 of the installed Java VM. This message shows if you run JAlbum on top of a too old Java VM. When downloading, select the install option that includes a "Java VM" or download a Java VM from Sun

I have a previously installed JAlbum that included a Java VM. Can I use that VM when I update JAlbum?
Yes. When you are asked to select a Java VM. Manually point the installer to [JAlbum install dir]/jre/bin/javaw.exe

I get errors when running the installer
Some people have had difficulties getting the installers to run. If that applies to you, you can download JAlbum without an installer Assuming you at least have Java 1.4 installed, start JAlbum by double clicking the JAlbum.jar file or issue `java -jar JAlbum.jar` at a command prompt. And here is an answer from ZeroG, the makers of the Installer I use (InstallAnywhere):

There are a few things that might cause this type of error. The first thing you'll need to check it that you have enough disk space for the install. Next, make sure that you do not have any anti virus software or pcanywhere running as this is known to cause problems with InstallAnywhere installers. The last thing would be to try turning your hardware acceleration display setting to off.

There are known issue with certain versions of Java running against certain video cards.

Also, if you are transferring this file from one machine to another, make sure that the file size is valid and you are transferring the file in binary mode. Also, this might be a Java only problem. Try running any of the Swing demos that come with the Java runtime in 1.4.X and see if it just hangs in all of these Windows 2000 machines. Use dxdiag to find directX version. Other searches on the web seem to indicate that DirectX needs to be updated to at least 8.1 to correct the problem. Most machines that have problems with this have DirectX 7.0 installed.

### Using

The final album is ok but I would like to adjust/add/remove [your modification here]
A lot of things can be set in the JAlbum user interface tabs and on the skin specific tab, but if you don't find a user interface control for what you'd like to adjust, add or change in the final album (font sizes, alignment etc), edit the skin template files instead, there is even a tutorial for this if you find it hard. The skin template files are basically html files stuffed with some JAlbum specific tags and variables. They form the base for all generated album pages. Use a plain text editor like Notepad to edit or an html editor like Frontpage. If you are adjusting a size, font or colour, edit the style files of the skin instead (see the styles directory of the skin you are using).

What is the preferred way to add images to my existing JAlbum album?
Make sure you always keep a copy of your original images in a folder on your hard disk. Generate the album from that folder and publish the album, but always keep that original folder. Now, if you wish to add more images to your album, add them to that original folder, fire up JAlbum, select the previously saved project (it helps at least) and press "Make album" again. JAlbum will now go through all images in that image folder, but actually only rescale the newly added ones, so the process of updating your album isn't very time consuming. JAlbum finally spits out the newly added, and now scaled images to the album directory, and usually a bunch of updated html files too. Now to update the remote album in a simple way, use the JAlbum publish tab and it's "Smart upload" feature, which is smart enough to only upload new and changed files.

How do I easily maintain multiple albums?
This is similar to the recommended way of adding images to an existing album (see above). Keep all your images in separate directories under one "master" directory on your hard disk. One directory for each album (The "My Images" directory in Windows is a good such "master" directory by the way). As you want to publish new albums, first add the new image directory to the "master" directory, then start JAlbum and select the "master" directory as the JAlbum "image directory". Finally make the album. To speed things up you can instruct JAlbum to ignore already processed directories by setting that switch on the Advanced tab. Now use the JAlbum publish tab and it's "Smart upload" feature to upload new and changed files. The result will be a "master index" page with one thumbnail or folder for each album. If you don't want certain image directories published as albums, just exclude them in the Edit section of JAlbum.

JAlbum doesn't show in my language. How do I change this?
JAlbum picks the language you have set as system default (see the Control Panel on Windows for instance), but if you don't want to change language there, go to the Advanced->Preferences section of JAlbum and change language there. Remember to use the File menu and its "Save as default" option to make your changes stick. If your language doesn't show in the language list, you may want to translate JAlbum to your language. To do that, open the "texts" subdirectory of the JAlbum install directory and read the instructions in the "texts.properties" file.

What file formats are supported?
JAlbum supports JPEG, GIF and PNG image files. More formats, like TIFF, BMP and JPEG2000 can be added through the Java Advanced Imaging Image I/O Tools plugin from Sun. Other file types are supported as linked icons (edit the filetypes.xml file to support more file types).

I cannot see thumbnails on published albums. Local viewing works fine.
This is caused by Norton Antivirus or Norton AdBlocker. That software has a bug that makes the browser ignore images with certain sizes. Change the thumbnail size and/or call Norton for a fix.

How do I make JAlbum add a link back to my site?
Usually one puts a JAlbum album in a subdirectory of a web site. JAlbum will automatically add a "parent/up" link on the thumbnail/index page(s), but only if it senses index web pages in the parent directory of the output directory during page generation. You can force JAlbum to generate a custom link by defining the variable `parentIndexPage` to `../index.html` or whatever that points users back to your site in the "Advanced" tab of JAlbum. Remember to press <ENTER> after editing user defined variables otherwise the change will not be noticed.

I'm getting an "java.net.UnknownHostException" error when trying to publish an album
This error shows when JAlbum is unable to access the Internet. Make sure you have a working Internet connection and that the "javaw.exe" process isn't blocked from accessing the Internet in your software firewall (Windows XP comes with a software firewall built in. Users of Norton Security are also likely to have accidently blocked "javaw.exe" from accessing the Internet.)

How can I password protect my albums?
JAlbum usually produces static html pages. To password protect such pages you need to configure the web server to protect a certain directory for instance. If you host your album on an Apache web server you can put a .htaccess file in the directory to protect.

How can I add watermarks to my photos?
Watermarks can be added to the generated images by using JAlbum filters. Some skins (BluPlusPlus and ShowOff for instance) also have special fields for entering watermarks in their user interfaces, but you get the best flexibility out of manipulating JAlbum filters right away

Can I have another title on the album than the folder name?
Yes. Go to the "Edit" tab of JAlbum and right click BETWEEN the image icons. A popup menu will show. Select "Properties". Edit the title field in the popup window that shows. Finally regenerate the album by pressing "Make album".

How do I get rid of copyright notices that appear below images?
Some image packages (not JAlbum) stores copyright notices ("LEAD Technologies" etc) in the comment area of JPEG images. JAlbum extracts and displays these comments believing they are user comments, but you can suppress this by going to the advanced tab of the user interface and simply deselecting the "JPEG" comment source.

What's the difference between "Rebuild all" and "Make album"?
First a rule of thumb: Use "Rebuild all" only after changing image sizes to an existing album. Use "Make album" for everything else. Rescaling images is the most time consuming part of album generation, therefore JAlbum tries to avoid image rescaling for already generated images (thumbnails and closeups) if you press "Make album". "Make album" can be used for initial album generation, when adding new images, when experimenting with different skins and image sizes, but to get good quality on the final album when image sizes has changed, "Rebuild all" is neccessary.

I have increased the thumbnail size but now the quality looks poor. Why?
Press "Rebuld all" after changing image sizes. JAlbum will then rescale all images to their new size. "Make album" never physically rescales already generated images in order to gain speed on subsequent album generations using the same image size when images are being added or different skins are being tried out.

The generated date and time is in US format and I live in (enter country here)
Download the international version of Suns Java runtime in order to have JAlbum make the right guess right away or set a date pattern manually in the advanced tab.

Vertical (portrait) images appear smaller than the horizontal ones. How do I get the same size: 640x480 and 480x640 respectively?
Just set the "Max image size" to 640x640 and you'll have that effect. The "Max image size" specifies a "bounding box" and never changes the width/height ratio of an image.

How can I have all thumbnails in the same height? Now portrait thumbnails are higher
Set the thumbnail size to something extreme like 140x80 instead of 120x120 and you will have this effect.

Some generated albums do not look perfect on <add old browser here>
Adjust the skin templates that made the failing album so they work for this browser too and mail me the corrected skin for inclusion. Adjustments should be "clean" and tested for current browsers.

Can JAlbum display the 35 mm equivalent focal length instead?
Yes, refer to the scripting examples for instructions on how to do this.

Foreign characters gets messed up on my Mac with JAlbum
This shouldn't happen if you at least run OS X 10.2. The update is free for registered OS X users.

I get an error code returned in the status row when trying to upload an album through FTP. What's wrong
Check out the meaning of the code at some site that lists FTP error codes. A common cause is "Invalid file name" where the remote server is more picky about some special characters in the file name than your own system. Renaming some files is then the recommended solution.

I want JAlbum to open [enter browser here] instead of Firefox when I click "View album". I am using Linux
Linux users can specify other browsers to be launched than Firefox by running JAlbum like this:

    java -Dbrowser.cmd="[enter browser here]" -Dbrowser.arg0="@url" -jar JAlbum.jar

Other users should have their default browser automatically opened.

If tbis FAQ didn't help you, please ask your question at the JAlbum forum, but search through the forum first using the forum search tool.