Skip to content

ryanfb/iiif-dl

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.

iiif-dl

Docker Cloud Build Status

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.

See also: dzi-dl, dezoomify, dezoomify-rs

Requirements

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:

Digital Bodleian IIIF manifest download

Alternately, if you have PhantomJS 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.

Docker Usage

There's also an automated build for this repository on Docker Hub at 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

About

Command-line tile downloader/assembler for IIIF endpoints/manifests

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published