/dezoomify

Dezoomify is a web application to download zoomable images from museum websites, image galleries, and map viewers. Many different zoomable image technologies are supported.

Primary LanguageJavaScriptGNU General Public License v2.0GPL-2.0

Dezoomify

Dezoomify cover image

Download zoomable images

Dezoomify extracts full high-resolution images from online zoomable image interfaces. It works with several zoomable image tools, from several different websites (see the list below). It takes as input the URL of a a zoomable image and gives as output an image that you can download (by right-clicking on it, and choosing Save Image as...).

In order to find the URL of the zoomable that dezoomify requires, you can install the dezoomify browser extension. Alternatively, you can also try to find the zoomable image URL yourself.

Try it

If you are not interested in the source code and just want to assemble tiles of (dezoomify) a zoomify-powered image, go there : unzoomify an image

Troubleshooting

FAQ

If you have problems while downloading an image, then read the FAQ.

Reporting issues

Your bug reports and feature requests are welcome! Please go the the Github issue page of the project, and explain your problem. Please be clear, and give the URL of the page containing the image dezoomify failed to process.

Supported zoomable image formats

The following formats are supported by dezoomify:

The most prominant supported websites include :

  • Arts & Culture (artsandculture.google.com)
  • Gallica (gallica.bnf.fr)
  • The British Library (bl.uk)
  • National Gallery of Art (nga.gov)
  • Hungaricana (hungaricana.hu)
  • National Library of Australia (nla.gov.au)
  • National Library of Israel (nli.org.il)
  • National Galleries Of Scotland (nationalgalleries.org)
  • National Library of Scotland (nls.uk)
  • Harvard Library (library.harvard.edu)
  • heidICON, Heidelberg University (heidicon.ub.uni-heidelberg.de)
  • Geographicus (geographicus.com)
  • Archivio di Stato di Trieste (archiviodistatotrieste.it)

Dezoomify also has a generic dezoomer. If the zoomable image format is simple enough, you just have to enter a pattern of tile URL, and dezoomify will be able to work with it.

Screenshots

dezoomify downloading an image

Video tutorial

Video tutorial for dezzomify

Programming Languages

The aim of the script is to do as much as possible in Javascript (with the HTML5 <canvas> tag), and only the network-related stuffs on the server side. The only little piece of server-side code that remains in the code is just a proxy, used to circumvent the same-origin policy. We implemented this code both in Javascript (node-app/proxy.js) and PHP (proxy.php), so you just need to have either one on your server to run dezoomify.

Wikimedia

This script on wikimedia : Zoomify in the help about zoomable Images on wikimedia

Local development

You can run the script locally, using php:

# Install the dependencies
sudo apt install php-cli

# Run the script
php -S localhost:3000

Then open http://localhost:3000/ in your browser.

GPL

Copyright © 2011-2017 Lovasoa

This file is part of Dezoomify.

Dezoomify is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Dezoomify is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Dezoomify; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA*/