Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A high resolution image manager for pan and zooming into images

Project Description


Django Loupe provides an easy way to display zoomable, large images. The images may be hosted locally by uploading the original large image, or externally. Externally hosted images are referenced by their URL.

Zoomable images are displayed by making a tiled image pyramid. There are several methods and formats for making this pyramids. Django Loupe creates locally-hosted tiles in the Deep Zoom format developed by Microsoft using the open source VIPS library.

The OpenSeadragon JavaScript library displays the locally- or externally-hosted images.


  1. Install Django Loupe using pip:

    pip install django-loupe
  2. Add "loupe", to your Django project’s INSTALLED_APPS.

  3. Install VIPS on your platform. There are packages for Windows, and most Linux distributions include a package. There is a homebrew recipe for Mac OS X.

Upload an image

  1. Add a new loupe image
  2. Enter in a title and description
  3. Click on the upload file button and select a high-res file
  4. Save.

Enter an externally hosted image

  1. Add a new loupe image
  2. Enter a title and description
  3. Enter in the URL for the tiles. This is not the URL for the page where you view the image. You will have to look at the page source to discover the tileset URL. Different formats have standard description files and Django Loupe will determine the correct URL from these.
    • Deep Zoom:
    • International Image Interoperability Framework:
    • Zoomify:
  4. Select the type of External tileset type from the selection.
  5. Save.

Serving an image

  1. In the template include the JavaScript:

    {% load loupe_tags %}{% openseadragon_js %}
  2. {{ object.render }} will include the HTML fragment for the large image.

    • If it is an external tile set, it looks for <modulename>/<classname>_<tileset_type>.html where <tileset_type> is the short name of the tileset type choice.
    • Finally, it looks in <modulename>/<classname>_default.html

Using remote storage

  1. Use django-queued-storage
  2. Set 'IMAGE_STORAGE' to appropriate storage type.
  3. Specify setting 'QUEUED_STORAGE_TASK' to either 'loupe.task.TileAndTransfer' or 'loupe.task.TileTransferAndDelete'.

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(728.6 kB) Copy SHA256 Hash SHA256
Source Apr 23, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting