Django-DownloadView provides generic views to make Django serve files.

It can serve files from models, storages, local filesystem, arbitrary URL... and even generated files.

For increased performances, it can delegate the actual streaming to a reverse proxy, via mechanisms such as Nginx’s X-Accel.


In some, serve files managed in a model:

from django.conf.urls import url, url_patterns
from django_downloadview import ObjectDownloadView
from import Document  # A model with a FileField

# ObjectDownloadView inherits from django.views.generic.BaseDetailView.
download = ObjectDownloadView.as_view(model=Document, file_field='file')

url_patterns = ('',
    url('^download/(?P<slug>[A-Za-z0-9_-]+)/$', download, name='download'),

More examples in the “demo” documentation!


Several views are provided to cover frequent use cases:

  • ObjectDownloadView when you have a model with a file field.
  • StorageDownloadView when you manage files in a storage.
  • PathDownloadView when you have an absolute filename on local filesystem.
  • HTTPDownloadView when you have an URL (the resource is proxied).
  • VirtualDownloadView when you the file is generated on the fly.

See “views” documentation for details.

See also “optimizations” documentation to get increased performances.

Table Of Contents

Next topic

Demo project

This Page