A file management application for django that makes handling of files and images a breeze.

Filer picker widget:

Documentation: http://django-filer.readthedocs.org/en/latest/index.html

Wiki: https://github.com/stefanfoulis/django-filer/wiki

• Django >= 1.5
• django-mptt >=0.6
• easy_thumbnails >= 1.0
• django-polymorphic >= 0.7
• Pillow >=2.3.0 (with JPEG and ZLIB support, PIL 1.1.7 is supported but not recommended)

django.contrib.staticfiles is required.

Please note, there are some compatibility constraints that we can not enforce through the setup.py. Here are the most important of them:

Django | django-polymorphic | django-mptt
------ | ------------------ | -----------
1.6    | >=0.5.4,           | >=0.6,<0.8
1.7    | >=0.5.6            | >=0.6,<0.8
1.8    | >=0.7              | >=0.7

To get started using django-filer simply install it with pip:

$ pip install django-filer

Add "filer", "mptt" and "easy_thumbnails" to your project's INSTALLED_APPS setting and run syncdb (and migrate if you're using South).

See the docs for advanced configuration:

• subject location docs
• permission docs (experimental)
• secure file downloads docs (experimental)

Django 1.7 is supported together with the new migrations. For Django<1.7 South is still supported, you need at least South>=1.0 for South to find them though.

The easiest way to run the testsuite is to checkout the code, make sure you have PIL installed, and run:

python setup.py test

For serious testing tox is recommended. See documentation for details.