Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Django form widget for cropping uploaded images based on a predefined size

Project description

DjangoKeyhole is a Django addon that adds an image crop widget to the standard ImageField. The actual cropping is done by the wonderful jquery cropping library cropit. Now the implementation destroys the original image but future versions might support non-destructive cropping.

  • quick and easy instalation
  • no external dependencyes
  • magic.


$ pip install DjangoKeyhole

Add keyhole to you’re INSTALLED_APPS in

Last but not least

$ python collectstatic

How to use

from django import forms

#import the widget
from keyhole.widgets import CroppedImageWidget

class MyAdminForm(forms.ModelForm):
    # width and height are in px
    foo_image = forms.ImageField(widget=CroppedImageWidget(width=160, height=160))


  • Write Tests
  • Fix typos in text
  • Add Code Comments
  • Test in pyhon 2.7





Free Software, Hell Yeah!

Project details

Download files

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

Files for DjangoKeyhole, version 0.81.dev0
Filename, size File type Python version Upload date Hashes
Filename, size DjangoKeyhole-0.81.dev0.tar.gz (11.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page