Skip to content
Powerful image management for the Django web framework.
Pull request Compare This branch is 41 commits behind praekelt:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Powerful image management for the Django web framework.


Offical releases are available from:

Source Distribution

Download the .zip distribution file and unpack it. From within the extracted directory run the following command:

   python install

Tracking the Development Version

The current development version of Photologue can be checked out via Subversion from the project site using the following command:

    svn checkout photologue-trunk

Then either copy the photologue-trunk/photologue directory or create a symlink to the photologue-trunk/photologue directory somewhere on your python path, such as your Django project or site-packages directory.

You can verify Photologue is available to your project by running the following commands from within your project directory: shell

    >>> import photologue
    >>> photologue.VERSION
    (2, 0, 'rc1')

Configure Your Django Settings

Add 'photologue' to your INSTALLED_APPS setting:

         # ...other installed applications,

*** Confirm that your MEDIA_ROOT and MEDIA_URL settings are correct. ***

Register Photologue with the Django Admin

Add the following to your projects file:

    from django.contrib import admin


Sync Your Database

Run the Django 'syncdb' command to create the appropriate tables. After the database in initialized, run the following command to initialize Photologue:

    python plinit

Instant Photo Gallery

To use the included photo gallery templates and views you need to first add photologue to your projects file.

    urlpatterns += patterns('',
        (r'^photologue/', include('photologue.urls')),
Once your urls are configured you need to copy the directory photologue/templates/photologue to your projects "templates" directory:


If you'd rather, you can also add the absolute path to the photologue/templates directory to your TEMPLATE_DIRS setting.

    TEMPLATE_DIRS = ('/path/to/photologue/templates',)

Additional Documentation and Support

Offical docs:

If you have any questions or need help with any aspect of Photologue please feel free to join the discussion group:
Something went wrong with that request. Please try again.