https://github.com/ryanfb/iiif-dl

Command-line tile downloader/assembler for IIIF endpoints/manifests
https://github.com/ryanfb/iiif-dl

Last synced: about 2 months 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 (5 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/)

 

## Usage

    bundle 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_0001

You 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