{"id":13687201,"url":"https://github.com/lovasoa/dezoomify","last_synced_at":"2025-03-24T04:31:21.952Z","repository":{"id":12826522,"uuid":"15501798","full_name":"lovasoa/dezoomify","owner":"lovasoa","description":"Dezoomify is a web application to download zoomable images from museum websites, image galleries, and map viewers. Many different zoomable image technologies are supported.","archived":false,"fork":false,"pushed_at":"2023-11-15T16:59:28.000Z","size":4502,"stargazers_count":702,"open_issues_count":274,"forks_count":74,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-03-19T02:00:04.702Z","etag":null,"topics":["dezoomify","downloader","google-art","hack","iiif","image","museum","openseadragon","zoomable-images","zoomify"],"latest_commit_sha":null,"homepage":"https://dezoomify.ophir.dev","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lovasoa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":["lovasoa"]}},"created_at":"2013-12-29T01:33:11.000Z","updated_at":"2025-03-13T11:57:41.000Z","dependencies_parsed_at":"2023-02-15T08:01:32.931Z","dependency_job_id":"5db0514d-c36e-437c-9246-3ac9ac7be25d","html_url":"https://github.com/lovasoa/dezoomify","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lovasoa%2Fdezoomify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lovasoa%2Fdezoomify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lovasoa%2Fdezoomify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lovasoa%2Fdezoomify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lovasoa","download_url":"https://codeload.github.com/lovasoa/dezoomify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245211101,"owners_count":20578348,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dezoomify","downloader","google-art","hack","iiif","image","museum","openseadragon","zoomable-images","zoomify"],"created_at":"2024-08-02T15:00:50.223Z","updated_at":"2025-03-24T04:31:21.578Z","avatar_url":"https://github.com/lovasoa.png","language":"JavaScript","funding_links":["https://github.com/sponsors/lovasoa"],"categories":["JavaScript"],"sub_categories":[],"readme":"# Dezoomify\n\n[![Dezoomify cover image](./cover.png)](https://ophir.alwaysdata.net/dezoomify/dezoomify.html)\n\n## Download zoomable images\n\n_Dezoomify_ extracts full high-resolution images from online zoomable image interfaces.\nIt works with several zoomable image tools, from several different websites (see the list below).\nIt 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...*).\n\nIn order to find the URL of the zoomable that dezoomify requires, you can install the [**dezoomify browser extension**](https://github.com/lovasoa/dezoomify-extension/#dezoomify-extension). Alternatively, you can also try to [find the zoomable image URL yourself](https://github.com/lovasoa/dezoomify/wiki/Dezoomify-FAQ).\n\n## Try it\nIf 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**](https://ophir.alwaysdata.net/dezoomify/dezoomify.html)\n\n## Troubleshooting\n#### FAQ\nIf you have problems while downloading an image, then read the **[FAQ](https://github.com/lovasoa/dezoomify/wiki/Dezoomify-FAQ)**.\n#### Reporting issues\nYour bug reports and feature requests are welcome!\nPlease go the the [Github issue page of the project](https://github.com/lovasoa/dezoomify/issues),\nand explain your problem.\nPlease be clear, and give the URL of the page containing the image dezoomify\nfailed to process.\n\n## Supported zoomable image formats\nThe following formats are supported by dezoomify:\n\n* [Zoomify](http://www.zoomify.com/) : Most common zoomable image format. *dezoomify* used to support only this, hence the name.\n* [Deep Zoom](http://en.wikipedia.org/wiki/Deep_Zoom) : Zoomable image format created by Microsoft. Dezoomify has a special support for the following websites that use *Deep Zoom*:\n  * The [British Library](http://www.bl.uk/)\n  * [National Gallery](http://www.nationalgallery.org.uk/) : The national gallery uses its own zoomable image format.\n  * The [World Digital Library (WDL)](http://www.wdl.org/fr/)\n  * [Polona](http://polona.pl/), the Polish Digital National Library\n  * [BALaT](http://balat.kikirpa.be/), Belgian Art Links and Tools\n* [Arts \u0026 Culture](https://artsandculture.google.com/) (formerly Google Art Project): a cooperation between google and several international museums. [More info about the controversy around this dezoomer.](https://github.com/lovasoa/dezoomify/issues/435).\n* [IIIF](https://iiif.io): The International Image Interoperability Framework, used on many websites, including:\n  * [Gallica](https://gallica.bnf.fr/), the numeric library of the French national library\n  * [Bavarikon](https://www.bavarikon.de/)\n  * [Harvard's library](https://library.harvard.edu/)\n* [Zoomify single-file format](https://github.com/lovasoa/pff-extract/wiki/Zoomify-PFF-file-format-documentation) : Less common format used by zoomify, where all tiles are in a single *.pff* file, and are queried through a java servlet.\n* [XLimage](http://www.centrica.it/products/xlimage-2/), a zoomable image format developed by an Italian company. It is used on the following websites:\n  * The [Royal Library of Belgium](http://kbr.be/)\n* **TopViewer**, also named **Memorix Maior picture viewer** used on the following websites:\n  * [daguerreobase](http://daguerreobase.org/en/), a collection of daguerreotypes.\n  * [Several dutch websites](https://picturae.com/nl/website/websites-portfolio) developed by the company picturae.\n* [krpano Panorama Viewer](http://krpano.com), mainly used in panoramic images and interactive virtual tours.\n* [The Tretiakov gallery](http://www.tretyakovgallery.ru/en/), official website of the Третьяковская галерея (in Moscow).\n* [FSI Viewer](https://www.neptunelabs.com/products/fsi-viewer/), zoomable image server by NeptuneLabs GmbH.\n* [Visual Library Server](https://www.semantics.de/visual_library/), by semantics\n* [Micr.io](https://micr.io/)'s non-IIIF format, used on [vangoghmuseum.nl](https://www.vangoghmuseum.nl/en/explore-the-collection)\n* [Hungaricana](https://hungaricana.hu/en/) a format found only on the **Hungarian Cultural Heritage Portal**, that hosts half a million images.\n\nThe most prominant supported websites include :\n- Arts \u0026 Culture (artsandculture.google.com)\n- Gallica (gallica.bnf.fr)\n- The British Library (bl.uk)\n- National Gallery of Art (nga.gov)\n- Hungaricana (hungaricana.hu)\n- National Library of Australia (nla.gov.au)\n- National Library of Israel (nli.org.il)\n- National Galleries Of Scotland (nationalgalleries.org)\n- National Library of Scotland (nls.uk)\n- Harvard Library (library.harvard.edu)\n- heidICON, Heidelberg University (heidicon.ub.uni-heidelberg.de)\n- Geographicus (geographicus.com)\n- Archivio di Stato di Trieste (archiviodistatotrieste.it)\n\n\nDezoomify also has a\n[generic dezoomer](https://github.com/lovasoa/dezoomify/wiki/Generic-dezoomer-tutorial).\nIf the zoomable image format is simple enough, you just have to enter a pattern of tile\nURL, and dezoomify will be able to work with it.\n\n## Screenshots\n![dezoomify downloading an image](https://user-images.githubusercontent.com/552629/95110615-9723ba80-073e-11eb-8845-2ccf6e557480.gif)\n\n## Video tutorial\n[![Video tutorial for dezzomify](http://pix.toile-libre.org/upload/original/1460095793.png)](https://www.youtube.com/watch?v=RtyckiAE5Eo)\n\n# Programming Languages\nThe aim of the script is to do as much as possible in _Javascript_ (with the HTML5 `\u003ccanvas\u003e` 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](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy).\nWe implemented this code both in Javascript ([node-app/proxy.js](node-app/proxy.js)) and PHP ([proxy.php](proxy.php)), so you just need to have either one\non your server to run dezoomify.\n\n## Wikimedia\nThis script on wikimedia : [Zoomify in the help about zoomable Images on wikimedia](https://secure.wikimedia.org/wikipedia/commons/wiki/Help:Zoomable_images)\n\n## Local development\n\nYou can run the script locally, using php:\n\n```bash\n# Install the dependencies\nsudo apt install php-cli\n\n# Run the script\nphp -S localhost:3000\n```\n\nThen open http://localhost:3000/ in your browser.\n\n## GPL\n\u003e Copyright © 2011-2017 Lovasoa\n\u003e\n\u003e  This file is part of Dezoomify.\n\u003e\n\u003e  Dezoomify is free software; you can redistribute it and/or modify\n\u003e  it under the terms of the GNU General Public License as published by\n\u003e  the Free Software Foundation; either version 2 of the License, or\n\u003e  (at your option) any later version.\n\u003e\n\u003e  Dezoomify is distributed in the hope that it will be useful,\n\u003e  but WITHOUT ANY WARRANTY; without even the implied warranty of\n\u003e  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n\u003e  GNU General Public License for more details.\n\u003e\n\u003e  You should have received a copy of the GNU General Public License\n\u003e  along with Dezoomify; if not, write to the Free Software\n\u003e  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301\n\u003e  USA*/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flovasoa%2Fdezoomify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flovasoa%2Fdezoomify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flovasoa%2Fdezoomify/lists"}