Dezoomify FAQ

How to use dezoomify ?

Make sure you are using a recent web browser. Any recent version of Firefox or Chrome should work. Copy and paste the url of the webpage that contains your zoomable image to the text field on dezoomify, then press enter, and that should be all. Zoomify will automatically detect what kind of zoomable image it is, and how to download it. Once the image is fully loaded, right-click on it, and choose Save as. It may take some time, but your browser should eventually open a file dialog, asking you where you want to save the image, and save it (as a PNG file).

If it doesn't work, see the other questions below.

'Select automatically' doesn't work. How to know which radio box to check ?

The radio boxes allow you to choose the dezoomer used for your image. Sometimes, the name of the dezoomer will appear along with the image viewer. Sometimes, it doesn't. If so, you can try to right-click the zoomable image from your browser, then choose Inspect this element, and try to find clues about the dezoomer used in the code that appears. Alternatively,you can view the source code of the page using Ctrl-U on most browsers.

If you found the right dezoomer to use, but dezoomify still doesn't work, see the next point.

The page uses an image viewer supported by dezoomify, but dezoomify still doesn't work. What to do ?

Sometimes, dezoomify fails to find the required information file. You can try to find it yourself.

• In the browser window that contains your zoomable image, open your browser's network inspector (Tools > Web development > Network in firefox).
• Select XHR at the bottom of the inspector.
• Refresh the page (press F5). If not done already, display the zoomable image inside the page.
• You will see all the resources loaded by the page appear in the network inspector. Search for the image information file. it's usually a small (< 5 Kb) .json, .xml, or .dzi file. For zoomify, this file is called ImageProperties.xml.
• Copy the URL of this small file.
• Paste the the URL to this information file to dezoomify. It should then be able to load your image.

The page uses an image viewer that is not supported by dezoomify. Is there still a chance ?

Yes, there is!

Dezoomify has a generic dezoomer, that tries to be clever and guess how many tiles there are, and stitch them together.

If your image is composed of multiple tiles, find the url of the tiles. For instance, you can use the Network inspector of your browser (Ctrl-Shift-Q on Firefox). Once you found an image url, try to spot inside it the coordinates of the tile inside the global image. Replace the horizontal coordinate by {{X}} and the vertical coordinate by {{Y}}.

Paste the resulting url in dezoomify. The generic dezoomer should be able to dezoom it.

The image downloads, I can see it, but I cannot save it to my computer. How do I download it?

Unfortunately, you may very well be touched by this firefox bug. Fortunately, there is still a way to save your image. See the wiki page about big images.

I have too much money and want to give you some.

I don't accept donations, but if you want to pay for hosting the main dezoomify server, get in touch through github issues.

My problem isn't listed above.

First, try to desactivate all your browser plugins. Some poorly coded plugins may prevent dezoomify from working. If it still doesn't work, you may have discovered a bug in dezoomify. So you should open an issue here. Please include all the information that may help me solve your issue :

• the URL of the web page containing your image
• if you get a red error message, copy & paste it.
• the name and version of your web browser
• if your problem is hard to describe, you can include one or several screenshots.

And if you know javascript, your contributions are welcome 👍