Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ryanfb/iiif-dl
Command-line tile downloader/assembler for IIIF endpoints/manifests
https://github.com/ryanfb/iiif-dl
Last synced: 27 days ago
JSON representation
Command-line tile downloader/assembler for IIIF endpoints/manifests
- Host: GitHub
- URL: https://github.com/ryanfb/iiif-dl
- Owner: ryanfb
- License: mit
- Created: 2015-07-16T15:36:50.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-07-14T00:54:38.000Z (over 3 years ago)
- Last Synced: 2024-08-04T04:07:06.560Z (4 months ago)
- Language: Ruby
- Size: 33.2 KB
- Stars: 31
- Watchers: 7
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-iiif - iiif-dl - Command-line tile downloader/assembler for IIIF endpoints/manifests. Download full-resolution image sequences from any IIIF server. (Image Tools / Image viewers (Image API only))
- awesome-datahoarding - iiif-dl - line tile downloader/assembler for IIIF endpoints/manifests (Download utilities / Application-specific)
- awesome-datahoarder - iiif-dl - line tile downloader/assembler for IIIF endpoints/manifests (Download utilities / Application-specific)
README
# iiif-dl
[![Docker Cloud Build Status](https://img.shields.io/docker/cloud/build/ryanfb/iiif-dl)](https://hub.docker.com/r/ryanfb/iiif-dl/)
Command-line tile downloader/assembler for IIIF endpoints/manifests.
Download full-resolution image sequences from any IIIF server.
Currently not compatible with IIIF 3.0. See [this issue](https://github.com/ryanfb/iiif-dl/issues/12).
See also: [dzi-dl](https://github.com/ryanfb/dzi-dl/), [dezoomify](https://github.com/lovasoa/dezoomify), [dezoomify-rs](https://github.com/lovasoa/dezoomify-rs)
## Requirements
* Ruby
* [Bundler](http://bundler.io/)
* [ImageMagick](http://www.imagemagick.org/)
## Usagebundle install
bundle exec ./iiif-dl.rb --help
Usage: iiif-dl.rb [options] [iiif-manifest.json]
-f, --force-tiling Don't attempt full-size downloads without tiling
-i, --identifier IDENTIFIER Download single IIIF identifier IDENTIFIER instead of image sequence from manifest JSON
-h, --help Display this screen
bundle exec ./iiif-dl.rb iiif-manifest.json
bundle exec ./iiif-dl.rb -i http://example.com/iiif/IIIF_SHELFMARK_0001You can download an IIIF manifest from e.g. the [Digital Bodleian](http://digital.bodleian.ox.ac.uk/):
![Digital Bodleian IIIF manifest download](http://i.imgur.com/WQLemyw.png)
Alternately, if you have [PhantomJS](http://phantomjs.org/) installed, you can use `jsonreqs.js` to list all URLs ending in `.json` requested by a given webpage URL:
phantomjs jsonreqs.js 'http://example.com/viewer.asp?manuscript=shelfmark'
In single-identifier mode, you pass the URL of an IIIF identifier, i.e. what `/info.json` would be appended to in order to make [an Image Information Request](https://iiif.io/api/image/2.1/#image-information-request).
## Docker Usage
There's also [an automated build for this repository on Docker Hub at `ryanfb/iiif-dl`](http://hub.docker.com/r/ryanfb/iiif-dl). It defines an `ENTRYPOINT` which will start `iiif-dl.rb` and pass any other arguments or environment variables to it, as well as defining a `/data` volume which you can map to your host to store manifests and images. For example, if you were in a directory with a IIIF manifest named `manifest.json`, you could download it with:
docker run -t -v $(pwd):/data ryanfb/iiif-dl manifest.json